使用 Docker 部署

Hollo 在 GitHub Packages 上提供了官方的 Docker 镜像。您可以使用这些镜像在您的服务器或本地机器上部署 Hollo：

docker pull ghcr.io/fedify-dev/hollo:latest

要运行 Hollo，您需要设置一个 PostgreSQL 数据库和一个用于媒体存储的 S3 兼容对象存储。您可以使用 PostgreSQL 的官方 Docker 镜像，也可以使用 RustFS 作为 S3 兼容对象存储。或者，您也可以使用其他托管服务，如 AWS 的 RDS、ElastiCache 和 S3。

要将 Hollo 连接到这些服务，您需要通过 docker run 命令的 -e/--env 选项或 --env-file 选项设置环境变量。要查看 Hollo 支持的环境变量，请参阅 环境变量 章节。

Docker Compose

要连接这些服务，您可以使用 Docker Compose。以下是一个示例 compose.yaml 文件：

# If you are upgrading from the former MinIO-based Compose setup, migrate your
# media before starting this file.  See the Docker installation guide:
# https://docs.hollo.social/install/docker/#migrating-from-minio

services:
  hollo:
    image: ghcr.io/fedify-dev/hollo:canary
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: "postgres://user:password@postgres:5432/database"
      SECRET_KEY: "${SECRET_KEY}"
      LOG_LEVEL: "${LOG_LEVEL}"
      BEHIND_PROXY: "${BEHIND_PROXY}"
      DRIVE_DISK: s3
      STORAGE_URL_BASE: http://localhost:9000/hollo/
      S3_REGION: us-east-1
      S3_BUCKET: hollo
      S3_ENDPOINT_URL: http://rustfs:9000
      S3_FORCE_PATH_STYLE: "true"
      AWS_ACCESS_KEY_ID: rustfsadmin
      AWS_SECRET_ACCESS_KEY: rustfsadmin
      # MEDIA_PROXY: off                # or "proxy" / "cache" — see docs/install/env
      # REMOTE_MEDIA_THUMBNAILS: "on"   # set to "off" to skip local thumbnails
    depends_on:
      postgres:
        condition: service_started
      rustfs:
        condition: service_healthy
      create-bucket:
        condition: service_completed_successfully
    restart: unless-stopped

  postgres:
    image: postgres:17
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_DB: database
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

  rustfs:
    image: rustfs/rustfs:1.0.0-beta.8
    ports:
      - "9000:9000"
    environment:
      RUSTFS_ACCESS_KEY: rustfsadmin
      RUSTFS_SECRET_KEY: rustfsadmin
    volumes:
      - rustfs_data:/data
    command: ["/data"]
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost:9000/health"]
      interval: 2s
      timeout: 2s
      retries: 30
    restart: unless-stopped

  create-bucket:
    image: public.ecr.aws/aws-cli/aws-cli:2.35.21
    depends_on:
      rustfs:
        condition: service_healthy
    environment:
      AWS_ACCESS_KEY_ID: rustfsadmin
      AWS_SECRET_ACCESS_KEY: rustfsadmin
      AWS_DEFAULT_REGION: us-east-1
      AWS_ENDPOINT_URL: http://rustfs:9000
      BUCKET_POLICY: >-
        {"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":"*","Action":["s3:GetObject"],"Resource":["arn:aws:s3:::hollo/*"]}]}
    entrypoint: ["/bin/sh", "-c"]
    command:
      - |
        until aws s3api head-bucket --bucket hollo 2>/dev/null; do
          aws s3api create-bucket --bucket hollo && break
          sleep 1
        done
        aws s3api put-bucket-policy \
          --bucket hollo \
          --policy "$${BUCKET_POLICY}"

volumes:
  postgres_data:
  rustfs_data:

将此文件保存为 compose.yaml 到您的工作目录中，然后运行以下命令：

docker compose up -d

从 MinIO 迁移

Hollo 0.10.0 之前的 Compose 文件将媒体存储在 MinIO 卷中。RustFS 无法直接使用该卷，因此必须先通过 S3 API 复制对象，再启动新的 Compose 配置。

[!CAUTION] 请在现有安装所在的同一目录中，使用相同的 Compose 项目名称运行以下命令。不要运行 docker compose down -v，因为它会删除存有媒体文件的卷。

备份当前的 Compose 文件，停止旧服务并保留其卷。然后下载新的 Compose 文件和迁移覆盖文件：

cp compose.yaml compose.minio.yaml
docker compose down
curl -LO https://raw.githubusercontent.com/fedify-dev/hollo/main/compose.yaml
curl -LO https://raw.githubusercontent.com/fedify-dev/hollo/main/compose.migrate-minio.yaml

如果您修改过 compose.yaml，请先从 compose.minio.yaml 重新应用这些更改，再继续操作。请保留新的 RustFS 服务和存储设置。

如果之前设置了 COMPOSE_PROJECT_NAME 或使用了 docker compose -p，请在下面的每条命令中使用相同的值。将 hollo 存储桶复制到 RustFS，然后比较源和目标：

docker compose -f compose.yaml -f compose.migrate-minio.yaml \
  --profile migrate-minio run --rm migrate-minio
docker compose -f compose.yaml -f compose.migrate-minio.yaml \
  --profile migrate-minio run --rm verify-minio-migration

验证命令必须报告没有差异。停止临时迁移服务但不要删除其卷，然后正常启动 Hollo：

docker compose -f compose.yaml -f compose.migrate-minio.yaml \
  --profile migrate-minio down
docker compose up -d