G2rain(谷雨)开源智能体平台项目文档,由 g2rain-bootstrap 的 docs/operations/installation.md 自动同步生成;正文保留来源仓库的技术表述与历史名称。
当前定位:Bootstrap 是基于已发布镜像的快速启动与部署方案入口;配对的 g2rain-deploy 主要用于开发阶段部署、源码构建与跨模块联调。中央目录截至 2026-11-10 记录 Bootstrap 已通过 Shell / Compose 静态配置检查;默认资源档只用于最低资源验证,真实全栈运行、业务冒烟及备份恢复仍需在目标环境完成验收。
文档范围:项目技术说明。项目是否发布、架构采用登记和具体环境验收分别维护;本页中的计划、偏差、测试数及未完成项仅适用于其明确记录的事项和版本,不应概括为整个平台尚未实现。当前组件版本见版本与依赖,业务发布范围见业务模块目录。未提供关闭证据的问题仍需按责任项目跟踪。
# 首次安装

# 前置检查

  • 在 Linux x86_64 主机或兼容 Bash 环境执行。
  • 安装 Docker Engine 24+、Docker Compose 2.20+ 与 OpenSSL。
  • 最低单请求 Demo:4 核 CPU、16 GB 内存和 40 GB 可用磁盘;容器资源上限合计约 11.7 GB。
  • 复制 .env.example 为 .env,替换访问地址;生产环境还必须轮换所有密码、Token,并同步 Nacos 内配置。
  • 确认当前 Docker Context、磁盘空间、开放端口和持久化目录。
  • 若 GHCR 包需要认证,使用仅含 read:packages 的令牌登录:
echo "$GITHUB_TOKEN" | docker login ghcr.io -u YOUR_GITHUB_USER --password-stdin

# 执行原则

首次准备由 ./init-once.sh 完成(也可由 ./start.sh 在缺少完成标记时自动调用):

  1. 复制并审查 .env(可用 ./init-once.sh --host <主机> --port <端口> 写入平台地址)。
  2. 将 PLATFORM_HOST / PLATFORM_PORT 写入 config/mysql/g2rain-basis.sql 中的占位符(须在空 MySQL 数据卷前完成)。
  3. 缺失证书时生成自签证书,并写入 .g2rain-bootstrap-init.done。
  4. 可先执行 ./pull.sh --background 在后台准备镜像。
  5. 执行 ./start.sh 拉取镜像并启动。

若 .env 尚不存在且未传入 --host/--port,init-once.sh 会从模板生成后退出,要求修改后再跑。

MySQL 初始化 SQL 仅在空数据卷首次创建时自动执行,已有数据卷不会自动重放;改平台地址后若需生效,须清空 data/mysql(或等价数据卷)后重装。Docling 会在首次 up --build 时本机构建派生镜像;无外网或需离线 tokenizer 时,应预先准备 DOCLING_HF_CACHE。

不要对不受信任的 Compose 片段、镜像覆盖或密钥目录运行该流程。

Last Updated: 2026-11-15T15:06:20.859Z