新增面向 AI Agent 的 Docker 全量安装指引#78
Closed
acloudpeng wants to merge 1 commit into
Closed
Conversation
Contributor
Author
补充安装截图
|
Noxiven
requested changes
Jun 3, 2026
| @@ -0,0 +1,778 @@ | |||
| # DEEIX Chat Docker 全量安装 | |||
|
|
|||
| 本文件供 coding agent 使用。不要一开始就 clone 或执行 compose。必须先做执行前环境预检，确认服务器区域、GitHub 连通性、Docker 可用性和镜像拉取能力；否则第一步就可能卡在 GitHub clone、`ghcr.io` 或 `docker.io` 镜像拉取。预检通过后，如果 DEEIX Chat 仓库尚未 clone 或当前目录不是仓库根目录，非中国大陆服务器 clone `https://github.com/DEEIX-AI/DEEIX-Chat.git`，中国大陆服务器直接 clone `https://gh-proxy.org/https://github.com/DEEIX-AI/DEEIX-Chat.git`，然后从仓库根目录继续执行。 | |||
Collaborator
There was a problem hiding this comment.
Docker 部署与 Github Clone 应该无关？建议更正下描述信息
|
|
||
| 默认路径：Docker 全量安装。 | ||
|
|
||
| 全量安装会启动三个容器： |
Collaborator
There was a problem hiding this comment.
全量安装应该还涉及 tika ？
使用 docker-compose.full.yaml 直接启动的就是可用的版本
| @@ -0,0 +1,778 @@ | |||
| # DEEIX Chat Docker 全量安装 | |||
| - 如果某一步失败，停止并说明阻塞原因，给出最小下一步操作。 | ||
| - 如果 Docker 不可用或 daemon 不可达，停止并提示用户先安装/启动 Docker。 | ||
| - 必须检查 Docker Engine 版本和 Compose 命令形式。优先使用 Compose v2：`docker compose`；如果只有旧版 `docker-compose`，需要先确认它是否支持本项目 compose 文件语法。 | ||
| - 必须先判断服务器是否在中国大陆。中国大陆服务器默认使用 GitHub clone 加速、华为云依赖镜像源和 GHCR 加速，否则 clone 仓库、拉取 `ghcr.io/deeix-ai/deeix-chat:latest`、`docker.io`、`pgvector/pgvector` 等资源可能失败或非常慢。 |
Collaborator
There was a problem hiding this comment.
请勿直接声明非 GHCR 外的其他镜像源，如有必要可以引导用户提供而非在文档中直接给出
| - 必须检查 Docker Engine 版本和 Compose 命令形式。优先使用 Compose v2：`docker compose`；如果只有旧版 `docker-compose`，需要先确认它是否支持本项目 compose 文件语法。 | ||
| - 必须先判断服务器是否在中国大陆。中国大陆服务器默认使用 GitHub clone 加速、华为云依赖镜像源和 GHCR 加速，否则 clone 仓库、拉取 `ghcr.io/deeix-ai/deeix-chat:latest`、`docker.io`、`pgvector/pgvector` 等资源可能失败或非常慢。 | ||
| - 修改 `/etc/docker/daemon.json`、重启 Docker daemon、修改全局 Git 配置、安装系统软件都需要用户明确批准。 | ||
| - 第一次 Docker 启动或构建可能很慢。必须区分是在拉镜像、安装前端依赖、下载 Go modules、执行容器内 apt-get，还是 Next.js 构建本身耗时。宿主机可以是 Ubuntu、Debian、CentOS、Rocky、AlmaLinux、Fedora、openSUSE、Arch 等 Linux 发行版，不要假设宿主机一定是 Debian。 |
Collaborator
There was a problem hiding this comment.
再次明确，该文档是 Docker 安装文档还是 Docker 构建文档？
安装文档不涉及 go modules 下载，前端依赖等等内容
| - 当前目录是 DEEIX Chat 仓库根目录。 | ||
| - 存在 `Dockerfile`、`docker-compose.full.yml`、`config.docker.example.yaml`。 | ||
| - `config.yaml` 存在，且没有被误创建成目录。 | ||
| - 已明确服务器网络区域：中国大陆或非中国大陆。 |
| - 已明确服务器网络区域：中国大陆或非中国大陆。 | ||
| - Docker daemon 可用。 | ||
| - 已确认 Docker Engine 版本、Compose v2 或旧版 `docker-compose` 是否可用，并选择了后续实际命令。 | ||
| - 如果是中国大陆服务器，已使用 `https://gh-proxy.org/https://github.com/DEEIX-AI/DEEIX-Chat.git` 作为 GitHub clone 加速地址，或已明确用户提供的其它可用方案。 |
Collaborator
There was a problem hiding this comment.
禁止直接提及具体的代理地址，DEEIX-AI 不对此类地址负责
|
|
||
| 1. 执行前环境预检。 | ||
|
|
||
| 在 clone、pull、build、compose 之前先做预检。不要把 `git clone` 当作第一步，因为中国大陆服务器可能会卡在 GitHub；也不要直接 `docker compose up`，因为可能会卡在 `ghcr.io`、`docker.io` 或 `pgvector/pgvector` 镜像拉取。 |
Noxiven
marked this pull request as draft
June 5, 2026 03:40
Collaborator
|
鉴于一直无人认领，决定暂时关闭，欢迎后续更新后重开PR |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
变更说明
新增
INSTALL_DOCKER_FULL.zh-CN.md，作为 AI agent 执行 DEEIX Chat Docker 全量安装时的操作指引。该文档不是普通用户手册，主要用于约束 AI agent 的安装顺序、网络分支、安装动作和执行边界，避免在中国大陆服务器上直接卡在 GitHub、GHCR、Docker Hub 或依赖镜像拉取环节。
AI Agent 会按文档执行的事项
gh-proxy.org拉取源码ghcr.1ms.run拉取应用镜像pgvector/pgvector:pg16和redis:7config.yaml，但不会覆盖用户已有配置app、postgres、redis全量 Docker 环境8080执行边界
AI agent 不会默认执行以下高风险操作：
config.yaml/etc/docker/daemon.json国内镜像版本对比
文档创建时间：2026年5月30日
镜像版本检查时间：2026年5月30日
pgvector/pgvector:pg16swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/pgvector/pgvector:pg162024-07-090.8.2-pg16-*标签redis:7swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/redis:72025-04-29，页面内版本信息为 Redis7.4.2redis:7已更新到 Redis7.4.9redis:7当前版本测试环境
测试结果
已验证在上述国内服务器环境中，AI agent 按该文档的国内安装路径可以完成 DEEIX Chat Docker 全量安装，并可在安装完成后读取并输出首次初始化管理员账户和密码。
说明
该文档优先保证 AI agent 在中国大陆服务器上能够稳定完成安装。国内镜像源不等同于官方最新版本；若用户要求严格跟随官方最新镜像，建议在可访问 Docker Hub/GHCR 的环境中先拉取官方镜像，再通过
docker save/docker load迁移到目标机器。