docs: 恢复并更新 Deploy.md — 生产部署使用 .docker.env.example
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -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)**。所有后端服务不直接对外暴露。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user