Amurex会议助手项目自托管部署指南

Amurex是一款基于AI的会议助手工具，能够自动记录会议内容并生成摘要。本文将详细介绍如何将Amurex后端服务进行自托管部署，包括Docker容器化部署、环境变量配置以及常见问题解决方案。

一、Docker部署流程

1. 获取项目代码 首先需要克隆项目仓库到本地服务器，这是部署的基础步骤。

2. 构建Docker镜像 使用以下命令构建Docker镜像：

docker build -t amurex-backend .

3. 运行容器 构建完成后，运行以下命令启动容器：

docker run -d --name amurex-backend \
  --restart unless-stopped \
  -p 8000:8000 \  # 默认端口为8000
  -v /path/to/your/.env:/app/.env \  # 挂载环境变量文件
  amurex-backend:latest

二、环境变量配置详解

Amurex后端服务需要配置以下关键环境变量：

1. OpenAI相关配置

• 需要提供有效的OpenAI API密钥
• 如果使用自托管OpenAI兼容服务(如open-webui)，可通过修改API端点URL指向本地服务

2. Redis配置

• REDIS_URL：Redis服务器地址
• REDIS_PORT：默认为6379
• REDIS_USERNAME/REDIS_PASSWORD：根据Redis服务器安全设置决定是否需要

3. 可选API服务

• Groq API：目前无法自托管，需要注册获取API密钥
• Perplexity API：同样需要外部服务支持

三、常见问题解决方案

1. 容器不断重启问题 通常是由于缺少.env文件或配置错误导致。确保：

• .env文件已正确挂载到容器内
• 所有必填配置项都已设置

2. Redis连接问题 若遇到TypeError: int() argument must be a string...错误，通常是因为：

• REDIS_PORT未设置
• Redis认证信息缺失

3. Chrome扩展连接配置 在Chrome扩展设置中，需要将后端API地址指向自托管服务的URL和端口。

四、部署建议

1. 对于完全自托管场景，建议：

• 使用自托管的OpenAI兼容服务
• 部署本地Redis实例
• 可考虑替代方案替代Groq和Perplexity服务

2. 性能优化：

• 根据会议规模调整Redis资源配置
• 监控API调用频率以避免超额

通过以上步骤，用户可以成功部署自托管的Amurex会议助手服务，实现会议记录的自动化处理。部署过程中如遇问题，可参考错误日志进行针对性排查。