90bfd20d8d
- 在所有文档和配置中将品牌从 "Yuxi-Know" 重命名为 "Yuxi" - 将 Python 导入路径从 `src.*` 更新为 `yuxi.*` 以保持后端包的一致性 - 将 Web 包名称从 `yuxi-know-web` 更新为 `yuxi-web` 此更改与后端代码迁移至 backend/ 目录保持一致。
1.5 KiB
1.5 KiB
生产部署指南
本文档介绍如何在生产环境中部署 Yuxi。
前置要求
- Docker Engine (v24.0+)
- Docker Compose (v2.20+)
- NVIDIA Container Toolkit（如需使用 GPU 服务）
::: warning 注意事项
- 生产环境和开发环境建议使用不同的机器，避免端口和资源冲突
- 虽然名为「生产环境」，但这只是基本配置，真正上线需要根据实际情况调整
- 前端有调试面板（长按侧边栏触发），生产环境建议关闭 :::
部署步骤
1. 准备配置文件
为避免与开发环境冲突，生产环境建议使用 .env.prod 文件：
cp .env.template .env.prod
编辑 .env.prod，设置强密码和必要的 API 密钥：
NEO4J_PASSWORD：修改默认密码MINIO_ACCESS_KEY/MINIO_SECRET_KEY：修改默认密钥SILICONFLOW_API_KEY等模型密钥
2. 启动服务
使用生产环境配置文件启动：
# 仅启动核心服务（CPU 模式）
docker compose -f docker-compose.prod.yml up -d --build
# 启动所有服务（包含 GPU OCR）
docker compose -f docker-compose.prod.yml --profile all up -d --build
3. 验证部署
- Web 访问：http://localhost（直接通过 80 端口）
- API 健康检查：
curl http://localhost/api/system/health
维护与更新
更新代码
# 拉取最新代码
git pull
# 重新构建并启动
docker compose -f docker-compose.prod.yml up -d --build
查看日志
# API 日志
docker logs -f api-prod
# Nginx 访问日志
docker logs -f web-prod