新增面向 AI Agent 的 Docker 全量安装指引

[acloudpeng]

变更说明

新增 INSTALL_DOCKER_FULL.zh-CN.md，作为 AI agent 执行 DEEIX Chat Docker 全量安装时的操作指引。

该文档不是普通用户手册，主要用于约束 AI agent 的安装顺序、网络分支、安装动作和执行边界，避免在中国大陆服务器上直接卡在 GitHub、GHCR、Docker Hub 或依赖镜像拉取环节。

AI Agent 会按文档执行的事项

• 安装前先判断服务器区域：中国大陆或非中国大陆
• 检查 Docker Engine 和 Docker Compose 是否可用
• 根据服务器区域选择源码和镜像拉取路径
• 中国大陆服务器默认使用 gh-proxy.org 拉取源码
• 中国大陆服务器默认使用 ghcr.1ms.run 拉取应用镜像
• 中国大陆服务器默认使用华为云 SWR 拉取 pgvector/pgvector:pg16 和 redis:7
• 海外服务器保留官方 GitHub、GHCR 和 Docker Hub 路径
• 准备 config.yaml，但不会覆盖用户已有配置
• 优先使用预构建镜像启动，避免误触发本地构建
• 启动 app、postgres、redis 全量 Docker 环境
• 安装完成后读取容器日志，输出首次初始化管理员账户和密码
• 询问用户最终访问方式：IP 访问或域名访问
• 如果用户选择 IP 访问，可创建本地 compose override 暴露 8080
• 如果用户选择域名访问，会给出反向代理建议，并提示需要配置公开 URL、CORS 和 trusted proxy
• 执行基础验证，包括容器状态、配置挂载、HTTP 访问和日志检查
• 遇到失败时停止，并输出失败命令、核心错误和最小下一步

执行边界

AI agent 不会默认执行以下高风险操作：

• 不会覆盖已有 config.yaml
• 不会删除 Docker volume
• 不会把临时 compose override、密钥或 demo 配置提交到 Git
• 不会默认修改 /etc/docker/daemon.json
• 不会默认重启 Docker daemon
• 不会默认安装系统软件
• 不会继续配置真实模型 API Key 或生产上线流程
• 不会把首次管理员密码写入文档、commit message、PR 评论或公开 issue

国内镜像版本对比

文档创建时间：2026年5月30日
镜像版本检查时间：2026年5月30日

镜像	国内安装使用	华为云同步信息	官方当前信息	差异说明
pgvector/pgvector:pg16	swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/pgvector/pgvector:pg16	同步时间为 2024-07-09	Docker Hub 当前已有较新的 0.8.2-pg16-* 标签	华为云同步源可用于安装，但可能不是官方最新 digest
redis:7	swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/redis:7	同步时间为 2025-04-29，页面内版本信息为 Redis 7.4.2	Docker Hub 当前 redis:7 已更新到 Redis 7.4.9	华为云同步源可用于安装，但落后官方 redis:7 当前版本

测试环境

• 服务器地区：江苏电信
• 系统版本：Ubuntu 24.04
• 网络情况：海外连通性较差
• 执行方式：使用 AI agent 按该文档执行安装
• Agent 模型：Deepseek-V4 Flash

测试结果

已验证在上述国内服务器环境中，AI agent 按该文档的国内安装路径可以完成 DEEIX Chat Docker 全量安装，并可在安装完成后读取并输出首次初始化管理员账户和密码。

说明

该文档优先保证 AI agent 在中国大陆服务器上能够稳定完成安装。国内镜像源不等同于官方最新版本；若用户要求严格跟随官方最新镜像，建议在可访问 Docker Hub/GHCR 的环境中先拉取官方镜像，再通过 docker save / docker load 迁移到目标机器。

[acloudpeng]

补充安装截图