Skip to content

Docker 部署说明(Windows)

下载发布包

powershell
# 创建发布包目录
mkdir C:\tg2trade -Force
# 切换到发布包目录
cd C:\tg2trade
# 下载发布包
Invoke-WebRequest -Uri https://download.mw3ai.com/tg2trade-docker.tar.gz -OutFile tg2trade-docker.tar.gz
# 解压发布包
tar -xzf tg2trade-docker.tar.gz -C C:\tg2trade

环境要求

  • Windows 10 / 11(x86_64)或 Windows Server 2019+
  • Docker Desktop 24+
powershell
docker --version          # 需 ≥ 24.0
docker compose version    # 需 ≥ 2.0

TIP

如未安装 Docker Desktop,请参考 Docker 官方安装文档Docker 安装教程


文件清单

发布包包含以下三个文件:

文件说明
tg2trade.tar.gzDocker 镜像
docker-compose.yml容器运行配置
deploy.ps1一键部署脚本

首次部署

执行部署脚本

powershell
cd C:\tg2trade
.\deploy.ps1

WARNING

首次运行 PowerShell 脚本可能需要先执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 以允许脚本执行。

脚本执行流程:

步骤操作说明
1创建数据目录C:\var\lib\tg2trade\data\
2停止旧容器首次部署自动跳过
3导入新镜像docker load < tg2trade.tar.gz
4启动服务docker compose up -d

确认服务运行

powershell
docker ps --filter "name=tg2trade" --format "table {{.Names}}\t{{.Status}}"

预期输出:

NAMES      STATUS
tg2trade   Up 5 minutes

访问管理页面

打开浏览器访问:

http://localhost:3000

版本升级

升级只需替换镜像文件,数据不会丢失

替换新版本

powershell
cd C:\tg2trade
# 下载新版本发布包
Invoke-WebRequest -Uri https://download.mw3ai.com/tg2trade-docker.tar.gz -OutFile tg2trade-docker.tar.gz
# 解压发布包
tar -xzf tg2trade-docker.tar.gz -C C:\tg2trade

执行部署脚本

powershell
cd C:\tg2trade
.\deploy.ps1

升级流程:

步骤操作说明
1创建数据目录已存在则自动跳过
2停止旧容器docker compose down
3导入新镜像导入新版本
4启动服务以新镜像启动容器

TIP

数据库文件位于 C:\var\lib\tg2trade\data\,独立于容器生命周期,升级、重建容器均不影响数据。


日常运维

查看日志

powershell
# 实时跟踪日志(Ctrl+C 退出)
docker logs tg2trade -f

# 查看最近 100 行
docker logs tg2trade --tail 100

# 查看最近 10 分钟日志
docker logs tg2trade --since 10m

重启 / 停止 / 启动

powershell
docker compose -f C:\tg2trade\docker-compose.yml restart   # 重启
docker compose -f C:\tg2trade\docker-compose.yml down      # 停止
docker compose -f C:\tg2trade\docker-compose.yml up -d     # 启动

数据管理

powershell
# 查看数据文件
dir C:\var\lib\tg2trade\data\

# 备份数据库
copy C:\var\lib\tg2trade\data\data.db C:\var\lib\tg2trade\data\data.db.bak.%date:~0,4%%date:~5,2%%date:~8,2%

端口配置

默认端口 3000,可通过环境变量修改:

powershell
$env:PORT=8080; docker compose -f C:\tg2trade\docker-compose.yml up -d

常见问题

端口被占用

powershell
# 查找占用 3000 端口的进程
netstat -ano | findstr :3000

# 解决方案:修改端口(见上方"端口配置")

数据库损坏

WARNING

日常运维中请定期备份数据库,避免数据丢失。

powershell
# 1. 停止容器
docker compose -f C:\tg2trade\docker-compose.yml down

# 2. 用备份文件恢复
copy C:\var\lib\tg2trade\data\data.db.bak.20260301 C:\var\lib\tg2trade\data\data.db

# 3. 重启容器
docker compose -f C:\tg2trade\docker-compose.yml up -d

容器无法启动

powershell
# 查看详细日志排查错误
docker logs tg2trade

Docker Desktop 未运行

请确保 Docker Desktop 已启动(任务栏鲸鱼图标为运行状态),否则 docker 命令将报连接错误。

如何修改配置

配置文件位于 C:\tg2trade\docker-compose.yml,修改后需重启容器生效:

powershell
cd C:\tg2trade
docker compose down
# 编辑 docker-compose.yml...
docker compose up -d