Yuxi 部署教程：六步跑通你的私有 RAG 知识图谱问答平台

Yuxi 部署教程六步跑通你的私有 RAG 知识图谱问答平台【免费下载链接】Yuxi可私有部署的多租户知识智能体平台统一 RAG、知识图谱、多智能体、MCP/Skills、沙盒与权限管理。Self-hosted knowledge agent platform for RAG, knowledge graphs and multi-agent workflows.项目地址: https://gitcode.com/GitHub_Trending/yu/YuxiYuxi语析是一个可私有部署的多租户知识智能体平台把 RAG 检索、知识图谱、多智能体编排与沙盒工具放在同一个工作台里。你上传文档即可构建知识库智能体基于图谱上下文回答问答并附带可追溯的来源引用。它解决的核心问题是把散落在文档里的知识变成团队可用、可治理的问答资产。本文带你用 Docker Compose 在本地完整跑起来。技术栈速览类别技术作用语言Python / JavaScript后端服务与前端界面前端框架Vue 3 Vite Pinia对话与知识库管理界面后端框架FastAPI LangGraph ARQAPI 服务、智能体编排、异步任务 Worker图数据库Neo4j存储与检索实体关系图谱向量数据库Milvus存储 RAG 文档切片与向量模型接入硅基流动 / OpenAI 兼容接口提供大模型与 Embedding 能力文档解析MinerU / PaddleX / RapidOCR解析 PDF、图片等格式文档容器化Docker Compose一键编排全部服务动手前环境自检清单Docker验证docker --versionDocker Compose v2 插件验证docker compose versionGit验证git --version至少一个兼容 OpenAI 接口的大模型 API Key.env必填SILICONFLOW_API_KEY硅基流动默认支持资源充足完整模式会启动 Milvus、Neo4j 等 9 个以上容器建议内存 16GB 以上验证free -h可选使用 OCR 解析图片文档时准备外部 OCR 服务或 GPU从零部署完整流程拉取代码这一步把仓库克隆到本地--depth 1只取最新提交下载更快。git clone --depth 1 https://gitcode.com/GitHub_Trending/yu/Yuxi cd Yuxi做完后目录里应能看到docker-compose.yml、scripts/、backend/、web/等顶层内容。写入密钥配置初始化脚本会引导你把 API Key 和三个安全密钥写入.env并顺带预拉取全部 Docker 镜像。# Linux / macOS ./scripts/init.sh # Windows PowerShell .\scripts\init.ps1偏好手动配置的话也可以复制模板自己填完整配置项见 .env.templatecp .env.template .envSILICONFLOW_API_KEYsk-xxxx # 必填大模型 API Key WEB_SEARCH_PROVIDERdoubao # 可选: doubao | tavily TAVILY_API_KEY # 可选Tavily 搜索 JWT_SECRET_KEY用 openssl rand -hex 32 生成的值 API_KEY_DERIVATION_SECRET另生成一个不能与上一项相同 YUXI_INSTANCE_IDinstance-001 SANDBOX_PROVISIONER_TOKEN另生成一个至少 32 字符⚠️ 三个安全密钥必须互不相同、不少于 32 个字符且一旦写入不要丢失。做完后项目根目录应出现权限为 600 的.env文件终端打印镜像拉取进度。Docker 一键构建启动这条命令构建所有服务镜像并在前台启动方便你直接观察启动日志。docker compose up --build首次启动包含镜像构建约需 2~5 分钟做完后终端应依次滚动出各容器日志api 与 web 服务逐个进入运行状态。后台运行确认日志无报错后按CtrlC结束前台进程再切到后台模式启动。docker compose up -d如果上一步已经用-d启动过可直接跳过做完后运行docker compose ps应看到全部服务处于 running 状态。本地 5173 端口访问浏览器打开平台入口首次访问需设置超级管理员账号与密码请妥善保存。curl -I http://localhost:5173/✅ 返回 HTTP 200 即表示前端已就绪接着在http://localhost:5173/登录应能看到对话与知识库管理界面。停止服务用完之后停止并移除全部容器数据保存在docker/volumes/下重启不会丢失。docker compose down做完后docker ps里不应再看到 yuxi 相关容器。跑通之后怎么判断部署成功三个可验证的标志逐一确认即可打开http://localhost:5173/如果登录页正常渲染并能进入平台说明前端与 API 已连通如果页面空白或报 502则检查docker logs web-dev -f。运行docker compose ps如果所有容器均为 Uphealthy说明 Milvus、Neo4j 等依赖已就绪如果有服务处于 Restarting 状态则查看该容器的日志定位原因。访问http://localhost:5050/docs如果打开 OpenAPI 文档页说明后端 API 可达如果连接不上则用docker logs api-dev -f排查启动报错。更多配置与生产部署细节见 docs/advanced/deployment.md。高频卡点速查.env 密钥缺失容器反复重启现象容器不停退出日志提示Set API_KEY_DERIVATION_SECRET in .env。原因.env中安全密钥缺失、不足 32 字符或相互复用。解决bash scripts/init.sh docker compose up -d镜像拉取慢或构建失败现象卡在 pull 阶段或网络超时。原因本地网络无法直连镜像源。解决配置代理后重试或逐个手动拉取export HTTPS_PROXYhttp://127.0.0.1:7890 bash scripts/pull_image.sh python:3.13-slim5173 端口被占用现象浏览器打开 5173 出现的是别的站点。原因本机已有其他服务占用该端口。解决修改docker-compose.yml中 web 服务的5173:5173为空闲端口然后重建docker compose up -d --force-recreate web首次访问无法设置超级管理员现象首访的设置页面提交失败或超时。原因api 容器尚未完成启动。解决docker logs api-dev -f看到服务就绪日志后刷新页面重试若持续报错参考 docs/intro/quick-start.md 的故障排除章节。部署完成后就可以上传第一批文档构建知识库让智能体开始带引用来源的图谱问答。【免费下载链接】Yuxi可私有部署的多租户知识智能体平台统一 RAG、知识图谱、多智能体、MCP/Skills、沙盒与权限管理。Self-hosted knowledge agent platform for RAG, knowledge graphs and multi-agent workflows.项目地址: https://gitcode.com/GitHub_Trending/yu/Yuxi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考