1Panel 面板安装

适合已有 1Panel 的服务器: 数据库、缓存、反代、SSL 都在 1Panel 里点选完成, Imagic 容器加入 1panel-network 与 Postgres / Redis 走内网连接, 不必把它们暴露到公网。

前置条件

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

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

OpenResty

应用商店搜 OpenResty 安装, 默认即可。1Panel 的网站反代功能依赖它。

OpenResty 安装

PostgreSQL

应用商店搜 PostgreSQL 安装。

Postgres 安装

安装好后到数据库 → PostgreSQL → 数据库列表创建 imagic:

创建数据库

记下数据库名、账号、密码, 后面 compose 里要用。

Redis

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

Redis 安装

记下 Redis 密码:

Redis 配置

2. 创建 Imagic 容器编排

Imagic 容器加入 1panel-network, 与 Postgres / Redis 走内网, 不必给数据库 / Redis 开放公网。端口绑定到 127.0.0.1 让外部访问只能经过 OpenResty 反代。

容器 → 编排 → 创建编排:

创建编排

名称: imagic (或你喜欢的)

内容:

services:
  imagic:
    # 建议直接锁版本号, 不用 latest, 升级才显式
    image: woodchen/imagic:0.6.2
    container_name: imagic
    restart: unless-stopped
    ports:
      # 绑 127.0.0.1 让端口只在本机可访问, 外部访问只能经 OpenResty 反代
      - "127.0.0.1:1445:8080"
    environment:
      LICENSE_KEY: "你的授权码"
      # 如果 Redis 没设密码, 改成 redis://redis:6379/0
      REDIS_URL: "redis://default:Redis密码@redis:6379/0"
      DB_DRIVER: "postgres"
      # 改成你的 Postgres 凭证; 走 1panel 内网, sslmode=disable
      DB_DSN: "postgresql://数据库用户名:数据库密码@postgresql:5432/数据库名?sslmode=disable"
    volumes:
      # 仅挂 imagic 自己的目录, 与日后可能加进同 compose 的 redis / postgres 卷子目录隔离
      - ./data/imagic:/app/data
    networks:
      - 1panel-network

networks:
  1panel-network:
    external: true