Skip to content

Docker 部署 ​

镜像构建 ​

Dockerfile 是多阶段构建:Node 22 构建前端 → Go 1.24 编译后端 (前端产物替换占位页后 embed)→ 最终镜像只留一个二进制。

构建上下文必须是仓库根目录——Dockerfile 要同时看到 deploy-server/ 与 deploy-server-ui/:

bash
# 在仓库根目录执行
docker build -t deploy-server:local -f deploy-server/Dockerfile .

# 指定写入二进制的版本号(默认 0.1.0)
docker build -t deploy-server:1.2.3 --build-arg VERSION=1.2.3 \
  -f deploy-server/Dockerfile .

# 也可以用 make(内部就是切到仓库根再 build)
cd deploy-server && make docker

运行 ​

bash
docker run -d --name deploy-server \
  -p 127.0.0.1:10055:10055 \
  -v /srv/deploy/data:/data \
  -v /srv/deploy/workspaces:/workspaces \
  --restart unless-stopped deploy-server:local

要点:

  • 镜像声明了 VOLUME ["/data", "/workspaces"],务必显式挂载到宿主机 目录,否则容器重建即丢数据库、密钥与日志;
  • 默认命令为 -listen 0.0.0.0:10055 -data-dir /data -web-root /workspaces, 监听容器内全部网卡;端口映射示例绑定宿主机回环 127.0.0.1, 对外仍应走反代 + HTTPS(配置见 05);
  • 配置也可用环境变量注入:-e DEPLOY_SERVER_URL=https://deploy.example.com 等,全部变量见 01;
  • 镜像内置 TZ=Asia/Shanghai,需要其他时区用 -e TZ=... 覆盖;
  • 健康检查与版本:
bash
curl -fsS http://127.0.0.1:10055/api/v1/healthz
docker exec deploy-server deploy-server version

镜像内置工具 ​

运行层基于 debian:bookworm-slim,预装:

text
git  bash  curl  ca-certificates  rsync  openssh-client  tzdata

这保证「开箱能跑基本部署」,但平台不代替你安装完整工具链: node、go、java、docker CLI 等按项目需要自行装进镜像(推荐派生镜像 FROM deploy-server:local 再补装),或用平台的工具链/中间件面板 安装到容器内。环境自检页会报告缺什么。

容器内执行的边界 ​

项目命令在容器内执行,这决定了它与 systemd 形态的本质差异:

  • 容器内的 systemctl 管不了宿主机服务;要重启宿主机上的 Nginx/应用, 要么改用 systemd 直部署,要么把部署目标本身容器化并通过挂载的 docker socket 操作(有安全风险,需自行评估);
  • 访问宿主机目录必须显式挂载,例如把站点目录挂进来: -v /var/www/site:/var/www/site,脚本里 rsync 到该路径;
  • 容器内安装的工具在容器重建后消失,持久化要么进镜像、要么挂卷;
  • SSH 凭据/公钥作用于容器内运行用户的 ~/.ssh,重建容器会丢, 需要挂载或改用数据库里的 ssh_key 凭据(见 04)。

与 systemd 形态的选择 ​

场景建议形态
部署宿主机应用、管理宿主机服务与目录systemd 直部署(05)
部署目标本身是容器、构建环境要求可复现Docker
快速试用、不想污染宿主机Docker(数据卷挂好即可)

两种形态的数据目录结构完全一致,迁移时把 data/ 与 workspaces/ 整体搬移即可,密钥文件一并带走,见 07 升级、备份与恢复。

升级镜像 ​

bash
docker build -t deploy-server:new -f deploy-server/Dockerfile .
docker stop deploy-server && docker rm deploy-server
docker run -d --name deploy-server \
  -p 127.0.0.1:10055:10055 \
  -v /srv/deploy/data:/data \
  -v /srv/deploy/workspaces:/workspaces \
  --restart unless-stopped deploy-server:new

升级前建议先备份数据卷,流程见 07。