生产部署指南

本文档介绍如何在生产环境中部署 Yuxi-Know。

前置要求

• Docker Engine (v24.0+)
• Docker Compose (v2.20+)
• NVIDIA Container Toolkit（如需使用 GPU 服务）

注意事项

1. 生产环境和开发环境建议使用不同的机器，避免端口和资源冲突
2. 虽然名为「生产环境」，但这只是基本配置，真正上线需要根据实际情况调整
3. 前端有调试面板（长按侧边栏触发），生产环境建议关闭

部署步骤

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