生产部署环境与上线流程

状态：✅ 当前有效。2026-08-27 首次整理，来源于登录服务器实地核查（非猜测）。

服务器

• 地址：root@60.205.214.169（hostname hexyun）。本机已配好免密 SSH，直接 ssh root@60.205.214.169 即可，不需要额外问用户要密码/密钥。
• 对外域名 lemonboss.wudaima.com 由这台机器提供服务。
• 同一台机器上还跑着大量不相关的容器（wordpress、milvus、rasa、chroma 等），docker 相关命令务必认准容器名 lemonboss，不要用 docker restart 之类命令波及别的服务。

部署拓扑

• 代码目录（host 侧）：/opt/lemonboss，属主 hexyun:hexyun。是一个独立 git 仓库，origin 与本地仓库一致，指向 git@gitlab-wuwei.hexpm.com:yibo/lemonboss.git，跟踪分支 main。
• 运行方式：Docker 容器 lemonboss（镜像 lemonboss-base:latest），重启策略 unless-stopped。
  • /opt/lemonboss bind-mount 到容器内 /app
  • /opt/data bind-mount 到容器内 /data
  • entrypoint：docker-entrypoint.sh → node server/index.js
• 端口：容器内 3010 → 宿主机 127.0.0.1:3011（对外走反向代理到 lemonboss.wudaima.com，代理具体配置未查）。

更新上线流程

1. 本地正常提交，git push origin main。
2. 登录服务器：ssh root@60.205.214.169，cd /opt/lemonboss && git pull origin main。
   • 必须用 root 拉代码：目录属主虽是 hexyun，但只有 root 配了到 gitlab-wuwei.hexpm.com 的部署 SSH key；hexyun 没配任何 key，sudo -u hexyun git pull 会直接因 host key / 鉴权失败报错。
   • git pull 完成后，把本次改动涉及的文件 chown hexyun:hexyun 改回属主（git pull 用 root 跑，新拉下来的文件会变成 root:root），避免以后应用进程（跑在 hexyun 身份下）对这些文件失去写权限。整个目录不建议全量 chown -R（node_modules 体量大且没必要）。
3. docker restart lemonboss 让新代码生效——bind mount 是实时的，但 Node 进程不会自动热重载，必须重启容器内进程。
4. 验证：
   • curl http://127.0.0.1:3011/api/health 应返回 200
   • docker logs --tail 40 lemonboss 确认启动日志无异常（正常应看到 ✅ 服务启动: http://0.0.0.0:3010 等心跳/看门狗初始化行）

其他线索

• /opt/lemonboss/.env 里的 OPEN_API_KEYS 是 /api/open/* 外部调用的鉴权 key，本文档不记录明文值。
• /opt/lemonboss/.data/jobs-openapi.json 是 open-api invoke 端点（server/routes/open-api.js）的 job 记录，容器重启时会从这个文件恢复历史 job（日志里 [JobManager] Restored N jobs 就是这个）——这是 job 记录，不是会话历史，二者存储位置不同（会话历史见 system/agents/{agentId}/{companyId|_global}/conversations/）。