安装环境： windows 10 + Docker Desktop
环境要求
在开始部署之前，请先确认你的环境满足以下要求。
软件版本要求
- Docker：建议使用 20.10 及以上版本。
- Docker Compose ：建议使用 2.0 及以上版本（推荐使用 v2 命令格式
docker compose）。
操作系统建议
- Ubuntu：20.04 及以上版本。
- CentOS：7 及以上版本。
- Windows：Windows 10 及以上版本，配合 Docker Desktop 使用。
硬件最低配置
- CPU：2 核及以上。
- 内存：4 GB 及以上。
- 磁盘：建议预留 10 GB 以上可用空间。
检查 Docker 是否安装成功
安装完成后，打开终端执行以下命令验证 Docker 是否正常可用：
bash
docker --version再执行以下命令验证 Docker Compose 是否正常可用：
bash
docker compose version如果两条命令都能正常输出版本号，说明 Docker 环境已就绪，可以继续下一步部署。
安装方式一：Docker 一键部署（推荐）
git clone https://gitee.com/zhendongdong/guada_ai.git
cd guada_ai
docker compose up -d --build
打开浏览器访问 http://localhost:8787
开始跟你的 AI 助手对话！
效果预览
根据文件内容里面的关键字，可以快速定位相关的知识点
附：安装guada_ai之后，威客启动网址http://localhost:8787/打不开，资料：
根因（按暴露顺序）
- 只 clone 没 build ：
docker ps -a/docker images/docker compose ls -a全空，8787 无监听------你只跑了git clone，从没执行docker compose up -d --build这一步。 - Docker Hub 被墙 （开始 build 才暴露）：
registry-1.docker.io被 DNS 污染到162.125.32.13（Dropbox 段），拉node/nginx基础镜像全超时。你的~/.docker/daemon.json之前完全没配镜像加速器。 - 仓库自身 lockfile bug （加速器配好后才暴露）：
frontend/package.json有sass@1.100.0但package-lock.json没同步，npm ci直接拒绝执行------这是 guada_ai 上游作者的疏漏。
我做的修复
- 配镜像加速器 ：实测 6 个候选，挑 4 个通的写入
C:\Users\Administrator\.docker\daemon.json的registry-mirrors：docker.1ms.run（最快）、docker.m.daocloud.io、docker.xuanyuan.me、docker.imgdb.de。 - 彻底重启 Docker Desktop ：kill 所有 Docker 相关进程 +
Restart-Service com.docker.service+ 重启 Docker Desktop.exe + 轮询 daemon（中途踩坑：半杀会让 daemon 返 500，必须彻底重启）。 - 修前端 Dockerfile ：
D:\guada_ai\frontend\Dockerfile第 12 行RUN npm ci→RUN npm install --no-audit --no-fund，绕过 lockfile 不同步。
参考资料：