Skip to content

systemd 部署与反向代理 ​

适用场景 ​

项目脚本要直接操作宿主机(systemctl 重启服务、rsync 到站点目录、管理 宿主机进程)时,选 systemd 直部署。容器形态的边界见 06 Docker 部署。

安装流程 ​

先在本机构建 Linux 二进制(见 08 从源码构建),从仓库根目录上传:

bash
scp deploy-server/bin/deploy-server-linux-amd64 'root@<server>:/tmp/deploy-server'
scp deploy-server/deploy/deploy-server.service 'root@<server>:/tmp/deploy-server.service'

然后以 root 在服务器上执行(示例绑定回环地址,通过反代或 SSH 隧道访问):

bash
install -m 0755 /tmp/deploy-server /usr/local/bin/deploy-server
mkdir -p /srv/deploy/data /srv/deploy/workspaces
chmod 750 /srv/deploy/data /srv/deploy/workspaces
install -m 0644 /tmp/deploy-server.service /etc/systemd/system/deploy-server.service
sed -i 's/0.0.0.0:10055/127.0.0.1:10055/' /etc/systemd/system/deploy-server.service
systemctl daemon-reload
systemctl enable --now deploy-server
systemctl is-active deploy-server
curl -fsS http://127.0.0.1:10055/api/v1/healthz

查看状态与日志:

bash
systemctl status deploy-server --no-pager
journalctl -u deploy-server -n 100 --no-pager

unit 文件要点 ​

仓库提供的 deploy/deploy-server.service 有几个需要理解的设定:

  • User=root:平台以服务账号权限执行任意脚本,unit 默认 root 以便 部署宿主机应用。可改为专用账号,但要保证其对 dataDir/webRoot 可写、 且脚本所需操作在该账号权限内。
  • 默认监听 0.0.0.0:10055:方便局域网 CLI 直连。机器有公网入口时 务必如上 sed 成 127.0.0.1 并前置反代——本服务本质是远程命令执行, 公网裸奔等于把服务器交出去。
  • NoNewPrivileges=true:会阻止脚本内通过 sudo 提权。若项目脚本 依赖 sudo,需要去掉这一行(并接受相应的安全权衡)。unit 刻意不做 更多沙箱加固:跑任意脚本就是它的本职,硬化只防误伤、不提供真隔离。
  • 时区:服务使用宿主机系统时区,运行时间戳与 cron 类脚本按宿主机 时区解释;需要调整时改宿主机 timedatectl set-timezone。
  • 优雅停止:KillSignal=SIGTERM + TimeoutStopSec=90。进程收到 SIGTERM 后先停收新请求(20 秒),再等运行中的 Run 收尾(最多 60 秒); 仍未结束的进程在下次启动时被标记为「中断」,不会挂着假的「运行中」。
  • unit 里刻意不写 -server-url:对外地址是运行时设置,在 系统设置改即可,无需改 unit、无需重启。
  • Restart=on-failure + RestartSec=3,异常退出自动拉起。

反向代理:Nginx 完整配置 ​

实时日志走 WebSocket,Nginx 必须转发升级请求头并关闭缓冲, 否则日志不刷新。在 HTTPS server 块中加入:

nginx
server {
    listen 443 ssl;
    server_name deploy.example.com;

    ssl_certificate     /etc/letsencrypt/live/deploy.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/deploy.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:10055;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 3600s;
        proxy_buffering off;
    }
}

要点说明:

  • proxy_read_timeout 3600s:WebSocket 是长连接,默认 60 秒会被掐断;
  • proxy_buffering off:日志帧即时透传,不做缓冲聚合;
  • 反代配好后,把系统设置里的「服务端外部地址」改为 https://deploy.example.com,脚本注入的 DEPLOY_SERVER_URL 随之更新。

HTTPS 与证书 ​

  • 公网访问一律 HTTPS,避免直接暴露 10055 端口;
  • 证书可用 certbot 签发(可通过平台的工具链面板安装 certbot)。 HTTP-01 验证要求域名 DNS 已指向这台公网入口服务器,且验证端点可访问;
  • 仅内网使用时,回环绑定 + SSH 隧道也是可接受的访问方式:
bash
ssh -L 10055:127.0.0.1:10055 root@<server>
# 本机浏览器访问 http://127.0.0.1:10055

更多加固项(防火墙、令牌保管、密钥备份分离)见安全加固。 升级与重启流程见 07 升级、备份与恢复。