ConnectAI-E/feishu-openai项目Docker部署指南

项目概述

ConnectAI-E/feishu-openai是一个将OpenAI ChatGPT能力集成到飞书(Feishu)平台的开源项目。通过该项目，企业可以在飞书内部直接使用ChatGPT的强大对话能力，提升工作效率和沟通体验。

Docker Compose部署详解

基础配置

项目使用Docker Compose进行容器化部署，以下是核心配置解析：

version: '3.3'
services:
  feishu-chatgpt:
    container_name: feishu-chatgpt
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "9000:9000/tcp"

• 使用Docker Compose 3.3版本
• 服务名称为feishu-chatgpt
• 基于当前目录下的Dockerfile构建镜像
• 暴露9000端口用于HTTP通信

飞书应用配置

environment:
  - APP_ID=cli_axxx
  - APP_SECRET=xxx
  - APP_ENCRYPT_KEY=xxx
  - APP_VERIFICATION_TOKEN=xxx
  - BOT_NAME=chatGpt

这些环境变量需要与飞书开放平台中的应用配置完全一致：

• APP_ID和APP_SECRET是飞书应用的凭证
• APP_ENCRYPT_KEY和APP_VERIFICATION_TOKEN用于消息加密和验证
• BOT_NAME设置机器人在飞书中的显示名称

OpenAI相关配置

- OPENAI_KEY=sk-xxx,sk-xxx,sk-xxx
- API_URL=https://api.openai.com

• OPENAI_KEY支持多个API Key，系统会自动进行负载均衡
• API_URL默认指向OpenAI官方API地址，如有自建代理可修改

服务器配置

- HTTP_PORT=9000
- HTTPS_PORT=9001
- USE_HTTPS=false
- CERT_FILE=cert.pem
- KEY_FILE=key.pem

• 默认使用HTTP协议，端口9000
• 如需HTTPS，设置USE_HTTPS=true并提供证书文件路径
• HTTPS端口默认为9001

代理配置

- HTTP_PROXY

• 留空表示不使用代理
• 如需代理可设置为类似http://127.0.0.1:7890的格式

部署建议

1. 安全性：生产环境建议启用HTTPS，确保通信安全
2. 性能优化：多个OpenAI Key可实现请求负载均衡，提高并发能力
3. 配置管理：可将敏感信息通过Docker Secret管理，而非直接写在配置中
4. 监控：建议添加健康检查端点，便于容器编排系统监控服务状态

常见问题

Q: 为什么需要配置四个飞书相关的环境变量？ A: 这些是飞书开放平台对机器人应用的安全要求，分别用于身份验证、消息加密和事件验证。

Q: 多个OpenAI Key如何工作？ A: 系统会轮询使用不同的Key，当某个Key达到速率限制时自动切换到下一个。

Q: 是否必须使用HTTPS？ A: 飞书官方推荐使用HTTPS，但开发测试阶段可以使用HTTP。生产环境强烈建议启用HTTPS。

通过以上Docker Compose配置，您可以快速部署一个连接飞书和OpenAI的智能对话服务，为企业内部提供强大的AI助手能力。