宝塔面板安装

适合已有宝塔面板的服务器: 数据库、缓存、反向代理、SSL 都在宝塔里点选完成, Imagic 容器通过 host 网络模式直连宿主机的 Postgres 与 Redis, 不需要把它们暴露到公网, 也不用单独开防火墙端口。

前置条件

一台已装宝塔面板 (国内版 / aaPanel 均可) 的 Linux 服务器
一个解析到该服务器的域名 (后续配反代 + SSL)
License Key (Docker 版授权 JWT, 找供应商要)
至少一条 OpenAI 兼容图像渠道 (BaseURL + API Key, 部署完后在 admin 后台填)

1. 准备宝塔环境 (已装的可跳过)

Nginx

宝塔软件商店搜 Nginx 安装, 版本随意, 默认即可。

Nginx 安装

Nginx 版本选择

Docker

软件商店搜 Docker 安装, 默认即可。

Docker 安装

PostgreSQL (推荐)

软件商店搜 Postgres 插件并安装。

Postgres 插件

安装好插件后, 进插件页装数据库, 建议选 17.6, 比较稳定。

Postgres 版本

Postgres 安装中

Postgres 安装完成

然后创建一个数据库 imagic:

创建数据库

记下数据库名、账号、密码, 后面 compose 里要用 (示例: imagic / imagic / PpJ2wJEEPaz8)。

Redis

Imagic 强依赖 Redis (异步任务事件总线 / 跨进程取消信号 / session 密钥持久化), 必装。

Redis 插件

版本选 redis7 或 redis8 都行, 这里演示用最新版 redis8, 生产稳妥推荐 redis7.4。

Redis 版本

Redis 安装完成

本地目录

按习惯设置一个数据持久化目录, 这里用 /www/docker/imagic:

本地目录

2. 创建 Imagic 容器编排

由于宝塔的 Postgres 与 Redis 都跑在宿主机, 容器使用 host 网络模式直连 127.0.0.1, 不必给数据库 / Redis 放开公网权限, 也不用占额外端口。

宝塔 Docker → 容器编排 → 添加。

创建容器编排

名称: imagic (或你喜欢的)

内容:

services:
  imagic:
    # 建议直接锁版本号, 不用 latest, 升级才显式
    image: woodchen/imagic:0.6.2
    container_name: imagic
    restart: unless-stopped
    network_mode: host
    environment:
      LICENSE_KEY: "你的授权码"
      # 如果 Redis 设了密码, 改成 redis://default:密码@127.0.0.1:6379/0
      REDIS_URL: "redis://127.0.0.1:6379/0"
      DB_DRIVER: "postgres"
      DB_DSN: "postgresql://imagic:PpJ2wJEEPaz8@127.0.0.1:5432/imagic?sslmode=disable"
      # 任意未占用端口都行, 反代后不用对外开放
      LISTEN_ADDR: ":1445"
    volumes:
      - /www/docker/imagic:/app/data