Skip to content
On this page

Docker 部署

通过 Docker 可以快速完成 TDuck 的安装与运行,适用于 Linux、Windows、macOS 等环境。


部署前准备

请确保已经安装以下软件:

  • Docker 20+
  • MySQL 5.7 / 8.0

并提前创建数据库:

sql
CREATE DATABASE tduck-v4 DEFAULT CHARACTER SET utf8mb4;

快速启动

执行以下命令启动 TDuck:

bash
docker run -d \
  --name tduck-platform \
  --restart=always \
  -p 8999:8999 \
  -e SPRING_DATASOURCE_URL="jdbc:mysql://127.0.0.1:3310/tduck-v4?useSSL=false&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&tinyInt1isBit=false&nullCatalogMeansCurrent=true" \
  -e SPRING_DATASOURCE_USERNAME=root \
  -e SPRING_DATASOURCE_PASSWORD=tduck@tduck \
  -v /upload:/application/BOOT-INF/lib/upload \
  tduckcloud/tduck-platform

参数说明

参数说明
--name tduck-platform容器名称
--restart=always容器异常退出后自动重启
-p 8999:8999主机端口映射到容器端口
SPRING_DATASOURCE_URLMySQL 数据库连接地址
SPRING_DATASOURCE_USERNAME数据库用户名
SPRING_DATASOURCE_PASSWORD数据库密码
-v /upload:/application/BOOT-INF/lib/upload文件上传目录挂载

启动成功后访问

访问地址:

text
http://localhost:8999

默认管理员账号:

text
admin@tduckcloud.com

默认密码:

text
123456

Docker Compose 部署

适用于快速搭建完整运行环境(MySQL + TDuck)。

1. 安装 Docker Compose

确认已安装:

bash
docker compose version

2. 下载项目源码

bash
git clone https://gitee.com/TDuckApp/tduck-platform.git

3. 启动服务

进入 docker 目录:

bash
cd tduck-platform/docker

启动:

bash
docker-compose up -d

首次启动将自动完成:

  • MySQL 初始化
  • TDuck 服务启动
  • 数据库脚本导入

常见问题

Mac 无法连接宿主机 MySQL

Docker 容器内部无法通过:

text
127.0.0.1

访问宿主机数据库。

请修改数据库地址:

text
host.docker.internal

例如:

text
jdbc:mysql://host.docker.internal:3306/tduck-v4

Linux 无法连接宿主机 MySQL

请将数据库地址修改为宿主机实际 IP:

text
jdbc:mysql://192.168.1.100:3306/tduck-v4

同时确认:

  • MySQL 已开放远程访问
  • 防火墙已放行 3306 端口

查看运行日志

bash
docker logs -f tduck-platform

重启服务

bash
docker restart tduck-platform

停止服务

bash
docker stop tduck-platform

删除容器

bash
docker rm -f tduck-platform

更多部署方式

如果需要:

  • 宝塔一键安装
  • 前后端分离部署
  • 多环境部署
  • 自定义配置文件启动

请参考官方文档:

https://doc.tduckcloud.com

湖南省众达数蔚信息技术有限公司-湘ICP备19005498号-3