ZF sun
7d07eee2be
- digital-human: FastAPI 中转服务，连接客户端与 Dify LLM 平台 - Redis: 容器内缓存，支持请求体哈希缓存（300s TTL） - 支持通过 DH_PORT 自定义宿主机映射端口 - Redis 默认不暴露端口，通过 docker-compose.redis-expose.yml 按需开启 - 显式声明 digital-human-net 网络，容器间通过内部 DNS 互通 - 修复 redis.ConnectionError 导入路径（使用 redis.exceptions） - Dockerfile pip 安装回退机制，避免镜像源不可用时构建失败 - 新增 .gitignore 防止 .env 密钥泄露
92 lines
2.9 KiB
Markdown
92 lines
2.9 KiB
Markdown
# 数字人对接中转服务
|
||
|
||
基于 Docker Compose 部署的数字人对接中转服务，连接客户端与 Dify LLM 平台。
|
||
|
||
## 架构
|
||
|
||
```
|
||
Client --> digital-human (8000) --> Dify LLM Platform
|
||
|
|
||
+--> Redis (6379)
|
||
```
|
||
|
||
## 快速部署
|
||
|
||
### 1. 配置环境变量
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
# 编辑 .env，填入 DIFY_URL 和 DIFY_API_KEY
|
||
```
|
||
|
||
### 2. 启动服务
|
||
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
### 3. 验证服务
|
||
|
||
```bash
|
||
# 健康检查
|
||
curl http://localhost:8000/health
|
||
|
||
# 转发测试（chat/completions）
|
||
curl -X POST http://localhost:8000/v1/chat/completions \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"model": "your-model",
|
||
"messages": [{"role": "user", "content": "你好"}]
|
||
}'
|
||
```
|
||
|
||
## 端口说明
|
||
|
||
| 端口 | 服务 | 说明 |
|
||
|:---|:---|:---|
|
||
| `${DH_PORT:-8000}` | digital-human | 中转服务，对外暴露（可通过 `DH_PORT` 自定义） |
|
||
| — | Redis | **默认不暴露**，仅在 Docker Compose 内部网络互通 |
|
||
|
||
## 环境变量
|
||
|
||
| 变量 | 必填 | 默认值 | 说明 |
|
||
|:---|:---|:---|:---|
|
||
| `DIFY_URL` | 是 | - | Dify 服务地址，如 `https://xxx.com/v1` |
|
||
| `DIFY_API_KEY` | 是 | - | Dify API 密钥 |
|
||
| `DH_PORT` | 否 | `8000` | 宿主机映射端口（如设为 `9000` 则访问 `http://IP:9000`） |
|
||
| `REDIS_HOST` | 否 | `redis` | Redis 主机（Docker Compose 内部 DNS，始终有效） |
|
||
| `REDIS_PORT` | 否 | `6379` | Redis 端口 |
|
||
| `REDIS_EXPOSE_PORT` | 否 | 不暴露 | 需要暴露时在 `.env` 中设置（如 `6379`），配合 `docker-compose.redis-expose.yml` 使用 |
|
||
|
||
## Redis 端口暴露（可选）
|
||
|
||
默认情况下 Redis **不占用宿主机任何端口**，digital-human 通过 Docker Compose 内部 DNS 直连。如需从宿主机直连 Redis（如本地调试），执行以下命令：
|
||
|
||
```bash
|
||
# 启动时合并 Redis 暴露配置
|
||
docker compose -f docker-compose.yml -f docker-compose.redis-expose.yml up -d
|
||
|
||
# 宿主机即可访问
|
||
redis-cli -h localhost -p 6379
|
||
```
|
||
|
||
## 生产部署注意事项
|
||
|
||
1. **防火墙**：确保服务器 TCP 8000 端口对外部开放
|
||
2. **HTTPS**：生产环境建议在 `digital-human` 前加一层 Nginx/Caddy 反向代理， termination TLS
|
||
3. **环境变量**：不要将密钥提交到代码仓库，`.env` 已加入 `.gitignore`
|
||
4. **Redis**：生产环境可移除内建 Redis，连接外部 Redis 集群
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
.
|
||
├── docker-compose.yml # 主容器编排（Redis 默认内部模式）
|
||
├── docker-compose.redis-expose.yml # Redis 端口暴露扩展（按需合并）
|
||
├── Dockerfile # 应用镜像构建
|
||
├── digital-human.py # FastAPI 中转服务源码
|
||
├── requirements.txt # Python 依赖
|
||
├── .env.example # 环境变量模板
|
||
└── README.md # 本文件
|
||
```
|