港服部署 SOP
目标：把本地改动安全地送到服务器，并确认线上真的生效，而不是「应该好了」。
一、部署前
- 确认改的是哪个服务、哪个端口，别撞已有的 3001 / 8080 / 8093 / 8097。
- 本地先跑通再上传，禁止把半成品推上去。
- 涉及数据变更，先备份
data/site.json。
二、上传与启动
| 步骤 | 命令 | 说明 |
|---|---|---|
| 上传 | scp -r ./dist root@64.90.30.139:/root/app | 覆盖合并要用 /. 结尾 |
| 重启 | systemctl restart app | 服务名以实际为准 |
| 看日志 | journalctl -u app -n 50 | 报错第一时间看这里 |
三、验证四件套
systemctl is-active app必须是 activess -tln | grep 8097必须有监听curl 127.0.0.1:8097/api/health返回 ok- 公网
https://nav.huilinsh.cn/能打开
四、翻车处理
端口被占：先 ss -tlnp 查进程，不要盲目 kill。
502：先看服务活没活，再看 nginx 反代端口对不对。
中文乱码：文件存 UTF-8，脚本用 LF 换行，ssh 命令串里别带引号。
五、原则
部署不是「传上去就算完」，是「传上去并且证明它能用」。