shaywong/sub2api

Sub2API Docker镜像

Sub2API是一个AI API网关平台，用于分发和管理AI产品订阅的API配额，帮助用户高效管控API资源的使用权限与分配。

快速启动

bash
docker run -d \
  --name sub2api \
  -p 8080:8080 \
  -e DATABASE_URL="postgres://user:pass@host:5432/sub2api" \
  -e REDIS_URL="redis://host:6379" \
  docker.xuanyuan.run/weishaw/sub2api:latest

Docker Compose配置

yaml
version: '3.8'

services:
  sub2api:
    image: docker.xuanyuan.run/weishaw/sub2api:latest
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=postgres://postgres:postgres@db:5432/sub2api?sslmode=disable
      - REDIS_URL=redis://redis:6379
    depends_on:
      - db
      - redis

  db:
    image: docker.xuanyuan.run/postgres:15-alpine
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=sub2api
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: docker.xuanyuan.run/redis:7-alpine
    volumes:
      - redis_data:/data

volumes:
  postgres_data:
  redis_data:

启动与数据库恢复

Sub2API启动时会执行数据库迁移。PostgreSQL在主机或Docker守护进程重启后可能短暂处于恢复状态，应用会通过有界指数退避重试临时连接错误，待数据库就绪后继续启动；永久错误（如无效凭据、迁移校验和不匹配）会立即失败。Compose部署通过pg_isready和SQL查询检查数据库健康状态，但主机重启后仍需应用级重试。

环境变量

支持的架构

• linux/amd64
• linux/arm64

标签说明

• latest：最新稳定版本
• x.y.z：特定版本（如1.0.0）
• x.y：次要版本的最新补丁（如1.0）
• x：主要版本的最新次要版本（如1）

相关链接

• https://github.com/***/sub2api
• https://github.com/***/sub2api#readme