KooCLI 自动化部署落地笔记：端口不通的三个坑

## 背景 这次在 KooCLI 自动化部署 上遇到 端口不通，记录下来给后面的人参考。 ## 问题现象 - 本地能跑，换到云上就失败，报错信息还很模糊。 - 配置改完重启，行为和改之前一模一样。 ## 排查过程 - 对比本地和云上的差异，重点看环境变量和权限。 - 先确认最小可复现路径：把变量一个个去掉，直到能跑通。 ## 根因 - 配置文件的位置和程序实际读取的位置不一致。 - 进程被前面的失败实例占用了端口，新进程静默退出。 ## 解决办法 - 把凭证统一到一个地方，改完立刻验证一次，不要同时改多个来源。 - 把配置路径写进启动脚本，避免依赖当前目录。 ## 经验 - 排查顺序比技巧重要：先确认请求能不能到达，再确认程序有没有正确响应。 - 任何"看起来已经生效"的改动，都要用命令实际验证一次。 ## 验证命令 ```bash ss -tlnp | grep -E ":(80|8080|22)" journalctl -u nginx -n 50 --no-pager ```