自托管

• 托管（默认） — 客户端开箱即用地使用 https://api.happy-next.com
• 自托管 — 使用 Docker Compose 运行你自己的 happy-server、happy-voice 和支持服务

​

环境要求

• Docker + Docker Compose
• LiveKit 部署（未包含在 docker-compose.yml 中）— 用于语音功能
  • 你需要 LIVEKIT_URL、LIVEKIT_WS_URL、LIVEKIT_API_KEY、LIVEKIT_API_SECRET
• 语音提供商的 API 密钥（如果使用语音功能）
  • OPENAI_API_KEY、CARTESIA_API_KEY

​

快速开始

1. 克隆仓库：

git clone https://github.com/hitosea/happy-next.git
cd happy-next

2. 创建环境配置文件：

cp .env.example .env

3. 编辑 .env 并填写必需的值。至少需要：
   • HANDY_MASTER_SECRET — 生成一个 64 个字符以上的随机字符串
   • POSTGRES_* — 数据库凭据
   • S3_* — 或使用 MinIO 默认配置
   • LIVEKIT_* + 语音 API 密钥 — 如果使用语音功能
4. 启动服务栈：

docker-compose up -d

5. 应用数据库迁移（仅首次运行需要）：

docker-compose exec happy-server yarn --cwd packages/happy-server prisma migrate deploy

6. 创建 MinIO 存储桶并设置为公开访问（仅首次运行需要）：

docker-compose exec minio mc alias set local http://localhost:9000 minioadmin minioadmin
docker-compose exec minio mc mb local/happy-server
docker-compose exec minio mc anonymous set download local/happy-server

7. 在 http://localhost:3030 打开 Web 应用。

​

服务

​

连接 CLI

HAPPY_SERVER_URL=http://localhost:3031 HAPPY_WEBAPP_URL=http://localhost:3030 happy

​

连接移动应用

• 开发构建： 启动 Expo 时设置 EXPO_PUBLIC_HAPPY_SERVER_URL，或使用应用内的服务器设置界面
• 生产构建： 使用应用内的服务器设置界面设置自定义服务器 URL

​

S3 / MinIO 说明

• 本地： MinIO 在 http://localhost:3050 暴露，因此 S3_PUBLIC_URL=http://localhost:3050 可以使用
• 远程： 使用真实的 S3 兼容端点，并配置与你的 TLS/主机设置匹配的公共 URL

​

远程访问

• 将 Web 应用、API 和语音网关放在带 TLS 的域名后面
• 将 EXPO_PUBLIC_HAPPY_SERVER_URL 和 EXPO_PUBLIC_VOICE_BASE_URL 设置为这些公共来源
• 将 APP_URL 设置为你的 Web 来源

​

故障排除

# 检查容器状态
docker-compose ps

# 查看日志
docker-compose logs -f happy-server
docker-compose logs -f happy-voice