Docker Compose 部署与 Nginx 反向代理
公测版本提示(Public Beta)
Yearning v4.0 当前处于 Public Beta 公测阶段,请优先在测试或预发环境试用体验;涉及重要数据时务必定期备份 PostgreSQL 数据卷与 keyring.json。
本指南面向希望在 3 分钟内拉起完整 Yearning v4 公测环境的团队,同时包含健康检查、Nginx HTTPS + SSE 反代配置、数据卷备份与无损升级的完整命令。
1. 环境准备
- Linux / macOS 服务器,已安装 Docker 24+ 与 Docker Compose v2(
docker compose version) - 推荐资源:2 vCPU / 4 GiB RAM(处理 32 MiB / 100,000 条大批量 SQL 时内存更充裕)
- 放通端口
8080(或通过反代暴露443)
2. 一键启动(含自定义密码与端口)
验证启动是否成功
等待 bootstrap 与 migrate 两个一次性任务执行完毕(通常 10–20 秒),检查服务状态与就绪探针:
访问 http://<你的服务器IP>:8080 登录:
- 账号:
admin - 密码:
.env中设置的YEARNING_ADMIN_PASSWORD(未配置.env时默认为Yearning@2026!)
刚登录不知道先点哪?
紧接着看 首次登录 15 分钟初始化教程,按顺序配好 AI Provider → 审核规则集 → 数据源 → 流程 → 权限组即可发出第一笔工单。
3. 容器分工与数据卷说明
docker-compose.yml 包含 4 个容器和 4 个持久化卷:
4. 生产 HTTPS 反向代理(Nginx 必配 SSE 参数)
Yearning v4 使用 GET /api/v4/events/stream(Server-Sent Events) 实时推送审批队列刷新、执行进度与查询授权撤销锁定。使用 Nginx 反代时必须关闭该路径的响应缓冲,否则前端会收不到实时推送或频繁断连。
完整 nginx.conf 站点配置(直接复制改域名与证书路径即可):
配置完 HTTPS 反代后,务必同步完成三件事:
.env中将YEARNING_SESSION_SECURE=true并设置YEARNING_TRUSTED_PROXIES=127.0.0.1/32(反代所在内网网段)。- 执行
docker compose up -d重建yearning容器。 - 登录后台进入 系统设置 → 常规设置(
/admin/settings/general),将 公开访问地址(public_base_url) 设为https://yearning.example.com(用于生成通知消息中的「查看工单」链接及 OIDC 回调地址)。
5. 备份与无损版本升级
绝对禁止升级时执行
docker compose down -v
删除 yearning_app_secrets 卷会永久销毁 AEAD 密钥环(keyring.json),导致 PostgreSQL 内已加密的全部数据源密码、AI Provider API Key、工单 SQL 与回滚证据永远无法解密。