Docker 部署

准备部署目录

mkdir -p ~/shopfaas && cd ~/shopfaas

创建 docker-compose.yml

services:
  postgres:
    image: pgvector/pgvector:pg18
    container_name: shopfaas-postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: shopfaas
      POSTGRES_USER: shopfaas
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-change-me-in-production}
    volumes:
      - postgres_data:/var/lib/postgresql
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U shopfaas"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:8-alpine
    container_name: shopfaas-redis
    restart: unless-stopped
    command: redis-server --requirepass ${REDIS_PASSWORD:-change-me-in-production}
    volumes:
      - redis_data:/data
    ports:
      - "6379:6379"
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

  rustfs:
    image: rustfs/rustfs:latest  # 实际版本为 1.0.0-beta.10
    container_name: shopfaas-rustfs
    restart: unless-stopped
    environment:
      RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY:-shopfaas}
      RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY:-change-me-in-production}
    volumes:
      - rustfs_data:/data
    ports:
      - "9000:9000"

  shopfaas:
    # 双 tag 策略：latest 指向最新稳定版，同时建议显式拉取 v${VERSION} 用于版本固定
    image: shopfaas/shopfaas-store:latest
    container_name: shopfaas-app
    restart: unless-stopped
    # 需以 root 运行：挂载 docker.sock 实现一键自动更新
    user: root
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
      rustfs:
        condition: service_started
    environment:
      DATABASE_URL: postgres://shopfaas:${POSTGRES_PASSWORD:-change-me-in-production}@postgres:5432/shopfaas
      REDIS_URL: redis://:${REDIS_PASSWORD:-change-me-in-production}@redis:6379
      S3_ENDPOINT: http://rustfs:9000
      S3_ACCESS_KEY_ID: ${RUSTFS_ACCESS_KEY:-shopfaas}
      S3_SECRET_ACCESS_KEY: ${RUSTFS_SECRET_KEY:-change-me-in-production}
      S3_BUCKET: shopfaas
      DEPLOY_MODE: private
      # 启用店内一键自动更新（通过 docker.sock 拉取并替换镜像）
      STORE_AUTO_UPDATE_ENABLED: "true"
      # 宿主机部署目录，用于挂载数据与配置（自动更新时仅替换镜像，不动此目录）
      HOST_DEPLOY_DIR: ${HOST_DEPLOY_DIR:-/opt/shopfaas}
      # 完整环境变量见 /docs/self-hosted/env-vars/
    ports:
      - "4322:4322"
    volumes:
      - shopfaas_storages:/app/storages
      # 挂载 docker.sock 实现一键更新：店内点击「检查更新」即可拉取新镜像并重启
      - /var/run/docker.sock:/var/run/docker.sock
      # 自动更新数据卷（存放拉取的镜像层、临时文件等）
      - shopfaas_update_data:/app/.update

volumes:
  postgres_data:
  redis_data:
  rustfs_data:
  shopfaas_storages:
  shopfaas_update_data:
    name: shopfaas-update-data

创建环境变量文件

cat > .env << 'EOF'
# 数据库密码（生产环境必须修改）
POSTGRES_PASSWORD=your-strong-password-here

# Redis 密码
REDIS_PASSWORD=your-strong-password-here

# 对象存储密钥
RUSTFS_ACCESS_KEY=shopfaas
RUSTFS_SECRET_KEY=your-strong-secret-here

# 宿主机部署目录（可选，默认 /opt/shopfaas）
HOST_DEPLOY_DIR=/opt/shopfaas
EOF

启动服务

# 拉取镜像并启动
docker compose up -d

# 查看启动状态
docker compose ps

# 查看应用日志
docker compose logs -f shopfaas

数据库自动初始化

数据库初始化已在镜像中完成，首次启动容器时自动执行（建表 + 写入 init-data），无需手动运行命令。

容器启动时会检测数据库是否已初始化，未初始化则自动按 docs/schemas/ 下的 SQL 文件创建表结构并写入种子数据（权限码、系统角色、默认配置），幂等可重复执行。

访问店铺

启动完成后，访问：

• 店铺前台：http://your-server-ip:4322
• 店铺后台：http://your-server-ip:4322/admin
• 默认店长账号：admin / admin123