ai-moive-studio

环境要求

• 已安装 Docker
• 已安装 Docker Compose v2
• 本地可访问 80 端口（用于 http://localhost 访问）
• 可编辑 .env.production 的文本编辑器
• 已准备好数据库、Redis、JWT、MinIO 相关配置信息

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 ai-moive-studio 源码到本地，网络不通时可先配置代理。

   git clone https://github.com/869413421/ai-moive-studio.git

   复制

2. 2进入项目目录

   切换到刚克隆下来的项目根目录，后续命令都在此目录执行。

   cd ai-moive-studio

   复制

3. 3复制环境变量模板

   把 .env.production.example 复制为 .env.production，作为实际生效的配置文件。

   cp .env.production.example .env.production

   复制

4. 4填写配置文件

   编辑 .env.production，按注释填写数据库、Redis、JWT、MinIO 等配置，缺项会导致启动失败。

5. 5启动容器服务

   用 Docker Compose v2 加载生产配置文件并后台启动全部服务，首次会拉取镜像耗时较久。

   docker compose --env-file .env.production -f docker-compose.prod.yml up -d

   复制

6. 6访问并配置模型

   浏览器打开 http://localhost 进入工作台，先在「API 密钥管理」配置模型服务，再创建项目或画布。

关键配置

如何确认成功

执行启动命令后容器正常运行，浏览器访问 http://localhost 能看到 AICON 工作台界面。

常见问题

注意事项

• 本项目为自托管部署，需要自行准备数据库、Redis、MinIO 等依赖服务的配置。
• 模型调用产生的费用由所选模型服务商收取，与本项目无关。
• 已有部署在升级前务必阅读 docs/changelog.md，避免配置不兼容。
• 首次启动需拉取镜像，耗时较长，建议保持网络稳定。