docs: 恢复并更新 Deploy.md — 生产部署使用 .docker.env.example

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-30 08:52:40 +08:00
parent 77d12aefa6
commit 914957d667
+17 -27
View File
@@ -53,7 +53,7 @@ cp backend/.env.example backend/.env
./devtools.sh start --build
```
首次运行会编译全部后端 Go 服务(约 1-2 分钟),之后按依赖顺序启动全部 8 个服务,每步等待健康检查通过。
首次运行会编译全部后端 Go 服务(约 1-2 分钟),之后按依赖顺序启动全部服务,每步等待健康检查通过。
### 4. 打开控制台
@@ -83,52 +83,48 @@ docker compose -f docker-compose.dev.db.yml up -d
# 1) 记忆服务 (端口 8091)
cd backend/memory-service && go build -o main.exe ./cmd/main.go && ./main.exe
# 2) 插件管理器 (端口 8094)
cd backend/plugin-manager && go build -o main.exe ./cmd/main.go && ./main.exe
# 3) IoT 调试服务 (端口 8083)
# 2) IoT 调试服务 (端口 8083)
cd backend/iot-debug-service && go build -o main.exe ./cmd/main.go && ./main.exe
# 4) 语音服务 (端口 8093)
# 3) 语音服务 (端口 8093)
cd backend/voice-service && go build -o main.exe ./cmd/main.go && ./main.exe
# 5) AI-Core (端口 8081)
# 4) AI-Core (端口 8081)
cd backend/ai-core && go build -o main.exe ./cmd/main.go && ./main.exe
# 6) 多平台桥接 (端口 8095)
cd backend/platform-bridge && go build -o main.exe ./cmd/main.go && ./main.exe
# 7) Gateway (端口 8080)
# 5) Gateway (端口 8080)
cd backend/gateway && go build -o main.exe ./cmd/main.go && ./main.exe
# 8) 前端 (端口 5173)
# 6) 前端 (端口 5173)
cd frontend/web && npm install && npx vite --host 0.0.0.0
```
> **注意**: Linux/macOS 下去掉 `.exe` 后缀。GOWORK=off 是必需的(项目使用 Go workspace
> **注意**: Linux/macOS 下去掉 `.exe` 后缀。编译时必须设置 `GOWORK=off`
---
## 方式三:Docker Compose
### 开发环境(基础设施 + 6 个后端服务)
### 开发环境(基础设施 + 后端服务)
```bash
docker compose -f docker-compose.dev.yml up -d
```
启动服务:postgres, redis, qdrant, minio, nats, searxng, memory-service, voice-service, iot-debug-service, ai-core, gateway, devtools。前端需本地启动。
> plugin-manager 和 platform-bridge 目前不包含在 docker-compose 中,需本地启动。
启动服务:postgres, redis, qdrant, minio, searxng, memory-service, voice-service, iot-debug-service, ai-core, gateway, devtools。前端需本地启动。
### 生产环境
```bash
# 编辑 .env,配置生产密钥
docker compose up -d
# 1. 配置环境变量
cp .docker.env.example .docker.env
# 编辑 .docker.env,填入真实的 API Key 和密码
# 2. 启动所有服务
docker compose --env-file .docker.env up -d
```
额外包含 Caddy 反向代理(自动 TLS),前端静态文件由 Gateway 直接托管
包含 Caddy 反向代理(自动 TLS)。详细说明见 [docs/deploy/docker-compose.md](docs/deploy/docker-compose.md)
---
@@ -143,13 +139,11 @@ Cyrene/
│ ├── memory-service/ # 记忆服务 (CRUD、语义检索、衰减、自动提取)
│ ├── voice-service/ # 语音服务 (DashScope STT + Edge-TTS)
│ ├── iot-debug-service/ # IoT 调试服务 (8 个模拟智能家居设备)
│ ├── plugin-manager/ # 插件管理器 (管理 API,插件逻辑在 pkg/plugins)
│ ├── platform-bridge/ # 多平台桥接 (QQ / Telegram / Discord / Webhook)
│ └── pkg/ # 共享包 (logger, plugins — 15 个通用插件/工具)
├── devtools/ # DevTools 管理面板 (Express + WebSocket)
├── scripts/ # 辅助脚本 (migrate / tunnel / whisper-setup / pg-backup)
├── searxng/ # SearXNG 搜索引擎配置
├── backups/ # 数据库备份文件
├── backups/ # 数据库备份文件
├── test/ # E2E 测试
├── docs/ # 文档
├── docker-compose.dev.db.yml # 开发基础设施
@@ -171,8 +165,6 @@ Cyrene/
| 8091 | Memory Service | 否 |
| 8088 | SearXNG | 否 |
| 8093 | Voice Service | 否 |
| 8094 | Plugin Manager | 否 |
| 8095 | Platform Bridge | 否 |
| 9090 | DevTools | 是 |
| 5432 | PostgreSQL | 否 |
| 6379 | Redis | 否 |
@@ -180,8 +172,6 @@ Cyrene/
| 6334 | Qdrant gRPC | 否 |
| 9000 | MinIO S3 | 否 |
| 9001 | MinIO Console | 否 |
| 4222 | NATS | 否 |
| 8222 | NATS Monitoring | 否 |
> **客户端只需连接 Gateway (8080)**。所有后端服务不直接对外暴露。