安装部署
安装总览
部署模式选择与系统要求
Imagic 走 Docker 部署, 镜像由官方在 Dockerhub 上发布 (woodchen/imagic),
用户直接拉镜像即可, 不需要自己构建。一份 docker-compose.yml 同时支持开发与生产。本章按场景拆成几篇:
- Docker compose 一键启动 — 默认 SQLite + 内置 Redis, 单机零外部依赖
- 宝塔面板安装 — 宝塔的 Nginx + Docker + Postgres + Redis 全套点选式部署
- 1Panel 面板安装 — 1Panel 应用商店 + OpenResty 反代点选式部署
- 外接 PostgreSQL — 切到云数据库或自建 PG
- 外接 Redis — 接 ElastiCache / 阿里云 Redis / 自建 Redis
- 环境变量 — 全部启动期变量与默认值
- 反向代理与 HTTPS — Nginx / Caddy 配置示例
- 图片存储 — 本地存储与 S3 兼容 (AWS / OSS / COS / R2 / MinIO)
- 升级与备份 — 滚动升级、数据卷备份、回滚
系统要求
| 项 | 最低 | 推荐 |
|---|---|---|
| 操作系统 | Linux x86_64 / macOS / Windows + WSL2 | Linux x86_64 |
| CPU | 1 vCPU | 2 vCPU 以上 |
| 内存 | 1 GiB | 2 GiB 以上 |
| 磁盘 | 5 GiB (SQLite + 图片存储) | 按图片量评估, S3 模式可大幅降低本地占用 |
| Docker | 24+ (含 BuildKit) | Docker 27+ + Compose v2 |
运行期不需要 GPU, 所有生图能力来自上游 OpenAI 兼容渠道。
必需的外部依赖
Imagic 启动期 强制依赖 Redis (ping 不通直接 fatal), 用于:
- 异步生图任务事件总线 (Redis Stream + Pub/Sub)
- 跨进程取消信号 (Pub/Sub)
- session HMAC 密钥持久化 (重启不踢下线)
数据库为可选 SQLite 或 PostgreSQL。SQLite 文件落盘 ./data/imagic.db, 适合单实例;
多实例或希望接入云数据库统一备份策略时切 PostgreSQL。
至少需要一个 OpenAI 兼容渠道
部署完成 ≠ 可以生图。首次登录后必须到 /admin/channels 添加至少一条
OpenAI 兼容的图像生成渠道 (BaseURL + API Key), 模型默认 gpt-image-2。
具体配置见 功能介绍 → 渠道与计费。