Docker 部署

本指南帮助你使用 Docker Compose 快速部署完整的 AiToEarn 应用。

服务架构

                         ┌──────────┐
                         │  Nginx   │
                         │  :8080   │
                         └────┬─────┘
                              │
              ┌───────────────┼───────────────┐
              │               │               │
        ┌─────┴─────┐  ┌─────┴──────┐  ┌─────┴─────┐
        │  Web (FE)  │  │  Server    │  │  AI       │
        │  :3000     │  │  :3002     │  │  :3010    │
        └────────────┘  └──────┬─────┘  └─────┬─────┘
                               │              │
                  ┌────────────┼──────────────┤
                  │            │              │
             ┌────┴─────┐ ┌───┴────┐  ┌──────┴───┐
             │ MongoDB  │ │ Redis  │  │  RustFS  │
             │ :27017   │ │ :6379  │  │ :9000/01 │
             └──────────┘ └────────┘  └──────────┘

服务	说明	端口
Nginx	反向代理，统一入口	8080（对外）
aitoearn-web	Next.js 前端	3000（内部）
aitoearn-server	NestJS 主后端 API	3002（内部）
aitoearn-ai	NestJS AI 服务	3010（内部）
MongoDB	数据库	27017
Redis	缓存/队列	6379
RustFS	S3 兼容对象存储	9000（API）/ 9001（控制台）

前置要求

Docker：20.10+
Docker Compose：2.0+
系统内存：建议 4GB+
磁盘空间：建议 20GB+

验证安装：

docker --version
docker compose version

快速启动

只需 3 步，即可在本地跑起完整的 AiToEarn。

克隆并启动

git clone https://github.com/yikart/AiToEarn.git
cd AiToEarn
docker compose up -d

首次启动会拉取镜像，可能需要几分钟。运行 docker compose ps 确认所有服务为 healthy 或 running。

打开界面

启动成功后，打开浏览器访问 http://localhost:8080。首次启动会自动创建管理员账号并自动登录，无需手动注册。

配置 Relay 中继（强烈推荐）

AiToEarn 需要登录你的社交媒体账号（抖音、小红书、TikTok 等）才能发布内容。这些平台要求 OAuth 开发者凭据才能授权登录。

不配 Relay：你需要自己去十几个平台逐一申请开发者账号，获取 client_id/secret，非常麻烦。
配了 Relay：借用官方 aitoearn.ai 的凭据完成授权，一个 API Key 搞定所有平台。

配置方法：

在 aitoearn.ai（国际）或 aitoearn.cn（中国）注册登录，进入 设置 → API Key，创建一个 API Key。
在浏览器打开部署后的界面，进入 配置管理。
选择 Server → Relay 中转，配置发布平台授权使用的 Relay。
如需使用平台提供的 AI 模型，选择 AI → Relay 中转 并配置 AI Relay。
OpenAI、Gemini、Anthropic 等模型服务商也可以在 AI → 模型服务商 中填写平台提供的 API Key 和 API 地址。
保存后点击 保存并重启，让对应服务重新加载配置。

中国版 Key 搭配 https://aitoearn.cn/api，国际版 Key 搭配 https://aitoearn.ai/api；环境和 Key 不匹配会导致 401。

到这里，你已经可以正常使用 AiToEarn 了。

运维参考

自动登录

自动登录默认已启用。首次启动时，aitoearn-init 服务会生成管理员 token 并保存到共享卷中，aitoearn-web 服务自动读取该 token 完成登录。

镜像拉取策略

所有应用服务镜像使用 pull_policy: always，确保每次 docker compose up 都拉取最新镜像。

内部服务通信

以下配置用于服务间通信，使用 Docker 内部网络，通常无需修改：

配置项	所属服务	默认值
`serverClient.baseUrl`	aitoearn-ai	`http://aitoearn-server:3002`
`aiClient.baseUrl`	aitoearn-server	`http://aitoearn-ai:3010`

配置文件

配置文件以可写卷挂载到容器中，可通过配置管理界面修改，保存后需重启对应服务：

文件	挂载到	说明
`project/aitoearn-backend/apps/aitoearn-ai/config/config.yaml`	aitoearn-ai:/app/config.yaml	AI 服务配置
`project/aitoearn-backend/apps/aitoearn-server/config/config.yaml`	aitoearn-server:/app/config.yaml	后端配置

配置速查表

aitoearn-ai 和 aitoearn-server 不再通过 docker-compose.yml 的 environment 配置运行参数，统一读取挂载的 config.yaml，并通过配置管理界面修改。

Compose 中仍保留的环境变量

变量	所属服务	说明	默认值
`MONGO_INITDB_ROOT_PASSWORD`	mongodb	MongoDB root 密码	`password`
`RUSTFS_ACCESS_KEY` / `RUSTFS_SECRET_KEY`	rustfs	RustFS 访问凭证	`rustfsadmin`
`MONGO_URI` / `JWT_SECRET` / `DB_NAME` / `AUTO_LOGIN_TOKEN_PATH`	aitoearn-init	首次启动初始化管理员与自动登录 token	内置默认值
`NODE_ENV` / `NEXT_TELEMETRY_DISABLED`	aitoearn-web	Web 运行环境与 Next.js telemetry 设置	`production` / `1`

入门

内容发布

资源管理

AI 生成

AI 工具接入

部署

服务架构

前置要求

快速启动

运维参考

配置速查表

Compose 中仍保留的环境变量

​服务架构

​前置要求

​快速启动

​运维参考

​配置速查表

​Compose 中仍保留的环境变量

服务架构

前置要求

快速启动

运维参考

配置速查表

Compose 中仍保留的环境变量