Skip to content

Docker 部署说明

环境要求

  • Linux 服务器(x86_64)
  • Docker Engine 24+ + Docker Compose v2
bash
docker --version          # 需 ≥ 24.0
docker compose version    # 需 ≥ 2.0

TIP

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

下载发布包

bash
# 创建发布包目录
mkdir -p /opt/tg2trade
# 切换到发布包目录
cd /opt/tg2trade
# 下载发布包(wget / curl 二选一)
wget -O tg2trade-docker.tar.gz https://download.mw3ai.com/tg2trade-docker.tar.gz
# 或
# curl -O https://download.mw3ai.com/tg2trade-docker.tar.gz
# 解压发布包
tar -xzf tg2trade-docker.tar.gz -C /opt/tg2trade

文件清单

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

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

首次部署

执行部署脚本

bash
cd /opt/tg2trade
bash deploy.sh

确认服务运行

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

预期输出:

NAMES      STATUS
tg2trade   Up 5 minutes

访问管理页面

打开浏览器访问:

http://<服务器IP>:3000

WARNING

如果服务器有防火墙,请确保 3000 端口已放行。

版本升级

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

替换新版本

bash
cd /opt/tg2trade
# 下载新版本发布包(wget / curl 二选一)
wget -O tg2trade-docker.tar.gz https://download.mw3ai.com/tg2trade-docker.tar.gz
# 或
# curl -O https://download.mw3ai.com/tg2trade-docker.tar.gz
# 解压发布包
tar -xzf tg2trade-docker.tar.gz -C /opt/tg2trade

执行部署脚本

bash
cd /opt/tg2trade
bash deploy.sh

TIP

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


日常运维

查看日志

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

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

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

重启 / 停止 / 启动

bash
docker compose -f /opt/tg2trade/docker-compose.yml restart   # 重启
docker compose -f /opt/tg2trade/docker-compose.yml down      # 停止
docker compose -f /opt/tg2trade/docker-compose.yml up -d     # 启动

数据管理

bash
# 查看数据文件
ls -lh /var/lib/tg2trade/data/

# 备份数据库
cp /var/lib/tg2trade/data/data.db /var/lib/tg2trade/data/data.db.bak.$(date +%Y%m%d)

# 查看数据占用
du -sh /var/lib/tg2trade/data/

端口配置

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

bash
PORT=8080 docker compose -f /opt/tg2trade/docker-compose.yml up -d

常见问题

端口被占用

bash
# 查找占用 3000 端口的进程
lsof -i :3000

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

数据库损坏

WARNING

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

bash
# 1. 停止容器
docker compose -f /opt/tg2trade/docker-compose.yml down

# 2. 用备份文件恢复
cp /var/lib/tg2trade/data/data.db.bak.20260301 /var/lib/tg2trade/data/data.db

# 3. 重启容器
docker compose -f /opt/tg2trade/docker-compose.yml up -d

容器无法启动

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

如何修改配置

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

bash
cd /opt/tg2trade
docker compose down
# 编辑 docker-compose.yml...
docker compose up -d