知识库管理和工作学习系统--guada_ai

安装环境： 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 是否正常可用：

docker --version

再执行以下命令验证 Docker Compose 是否正常可用：

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/打不开，资料：

根因（按暴露顺序）

1. 只 clone 没 build ：docker ps -a/docker images/docker compose ls -a 全空，8787 无监听------你只跑了 git clone，从没执行 docker compose up -d --build 这一步。
2. Docker Hub 被墙 （开始 build 才暴露）：registry-1.docker.io 被 DNS 污染到 162.125.32.13（Dropbox 段），拉 node/nginx 基础镜像全超时。你的 ~/.docker/daemon.json 之前完全没配镜像加速器。
3. 仓库自身 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 不同步。

参考资料：

一款完全开源、功能强大的知识库管理和工作学习系统

https://gitee.com/zhendongdong/guada_ai