Appearance
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_URL | MySQL 数据库连接地址 |
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
更多部署方式
如果需要:
- 宝塔一键安装
- 前后端分离部署
- 多环境部署
- 自定义配置文件启动
请参考官方文档: