# 拉取官方发行包（预构建应用）
docker pull ghcr.io/pixelfed/pixelfed:v0.15.2

v0.15.2: Pulling from pixelfed/pixelfed
Digest: sha256:f1237913ef0d392a5afef1dab8e3dd01234435ea90314a3a7221a2ea00932132
Status: Image is up to date for ghcr.io/pixelfed/pixelfed:v0.15.2
ghcr.io/pixelfed/pixelfed:v0.15.2

# 创建部署目录与存储目录
mkdir -p /opt/pixelfed && cd /opt/pixelfed
mkdir -p storage
# 将存储目录属主对齐发行包内运行用户 www-data（UID/GID=33）
chown -R 33:33 /opt/pixelfed/storage

ls -ld /opt/pixelfed/storage

drwxr-xr-x 2 33 33 4096 Oct 27 00:38 /opt/pixelfed/storage

APP_NAME="Pixelfed"
APP_ENV="production"
APP_KEY=
APP_DEBUG="false"
APP_LOCALE="en-US"

# Instance Configuration
OPEN_REGISTRATION="false"
ENFORCE_EMAIL_VERIFICATION="false"
PF_MAX_USERS="1000"
PF_MIN_REGISTRATION_AGE="16"
OAUTH_ENABLED="true"
OAUTH_PAT_ENABLED="false"
ENABLE_CONFIG_CACHE="true"
INSTANCE_DISCOVER_PUBLIC="true"
STORIES_ENABLED="true"

# Media Configuration
IMAGE_DRIVER=vips # vips, gd, imagick
PF_OPTIMIZE_IMAGES="true"
IMAGE_QUALITY="80"
MAX_PHOTO_SIZE="15000"
MAX_CAPTION_LENGTH="500"
MAX_ALBUM_LENGTH="4"

# Instance URL Configuration
APP_URL="http://192.168.146.128:8135"
APP_DOMAIN="192.168.146.128"
ADMIN_DOMAIN="192.168.146.128"
SESSION_DOMAIN=null
TRUST_PROXIES="*"
FORCE_HTTPS_URLS="false"
SESSION_SECURE_COOKIE="false"

# Database Configuration
DB_CONNECTION="mysql"
DB_HOST="db"
DB_PORT="3306"
DB_DATABASE="pixelfed"
DB_USERNAME="pixelfed"
DB_PASSWORD="q1w2e3r4"
DB_ROOT_PASSWORD="q1w2e3r4"

# Redis Configuration
REDIS_CLIENT="predis"
REDIS_SCHEME="tcp"
REDIS_HOST="redis"
REDIS_PASSWORD="null"
REDIS_PORT="6379"

# Laravel Configuration
SESSION_DRIVER="database"
CACHE_STORE="redis"
QUEUE_DRIVER="redis"
BROADCAST_DRIVER="log"
LOG_CHANNEL="stack"
HORIZON_PREFIX="horizon-"

# ActivityPub Configuration
ACTIVITY_PUB="false"
AP_REMOTE_FOLLOW="false"
AP_INBOX="false"
AP_OUTBOX="false"
AP_SHAREDINBOX="false"

# Experimental Configuration
EXP_EMC="true"

## Mail Configuration (Post-Installer)
MAIL_DRIVER=log
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="pixelfed@example.com"
MAIL_FROM_NAME="Pixelfed"
MAIL_AUTO_TLS=true

## S3 Configuration (Post-Installer)
PF_ENABLE_CLOUD=false
FILESYSTEM_CLOUD=s3

docker run --rm ghcr.io/pixelfed/pixelfed:v0.15.2 php artisan key:generate --show

base64:bm8hWRcRAgQ9LFRyvDgraqvX1J23z2mSht7dKIp3n70=

name: pixelfed-0.15.2-stack

services:
## MariaDB and Redis
  db:
    image: mariadb:11.8
    restart: unless-stopped
    env_file:
      - .env
    environment:
      MYSQL_DATABASE: ${DB_DATABASE}
      MYSQL_USER: ${DB_USERNAME}
      MYSQL_PASSWORD: ${DB_PASSWORD}
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
    volumes:
      - ./mariadb-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mariadb-admin", "ping", "-h", "127.0.0.1", "-u", "root", "-p$$MYSQL_ROOT_PASSWORD"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 30s
    networks:
      - pixelfed-network

  redis:
    image: redis:8-alpine
    restart: unless-stopped
    command: redis-server --appendonly yes
    volumes:
      - ./redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 3s
      retries: 3
      start_period: 10s
    networks:
      - pixelfed-network

## Pixelfed containers - App (Web/API), Horizon Queue, Scheduled task.
  pixelfed:
    image: ghcr.io/pixelfed/pixelfed:v0.15.2
    restart: unless-stopped
    ports:
      - "8135:8080"
    env_file:
      - .env
    environment:
      HEALTHCHECK_PATH: "/up"
      LOG_OUTPUT_LEVEL: "error"
      SSL_MODE: "off"
      PHP_POST_MAX_SIZE: "500M"
      PHP_UPLOAD_MAX_FILE_SIZE: "500M"
      PHP_OPCACHE_ENABLE: "1"
      PHP_OPCACHE_VALIDATE_TIMESTAMPS: "0"
      AUTORUN_ENABLED: "true"
      AUTORUN_LARAVEL_MIGRATION: "true"
      AUTORUN_LARAVEL_MIGRATION_ISOLATION: "true"
      AUTORUN_LARAVEL_STORAGE_LINK: "true"
      AUTORUN_LARAVEL_EVENT_CACHE: "true"
      AUTORUN_LARAVEL_ROUTE_CACHE: "true"
      AUTORUN_LARAVEL_VIEW_CACHE: "true"
      AUTORUN_LARAVEL_CONFIG_CACHE: "true"
    volumes:
      - ./storage:/var/www/html/storage
    depends_on:
      - db
      - redis
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:8080/api/v1/instance -o /dev/null"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 30s
    networks:
      - pixelfed-network

  horizon:
    image: ghcr.io/pixelfed/pixelfed:v0.15.2
    restart: unless-stopped
    command: ["php", "artisan", "horizon"]
    env_file:
      - .env
    environment:
      PHP_POST_MAX_SIZE: "500M"
      PHP_UPLOAD_MAX_FILE_SIZE: "500M"
      PHP_OPCACHE_ENABLE: "1"
      PHP_OPCACHE_VALIDATE_TIMESTAMPS: "0"
      AUTORUN_ENABLED: "false"
      AUTORUN_LARAVEL_MIGRATION: "false"
      AUTORUN_LARAVEL_MIGRATION_ISOLATION: "false"
      AUTORUN_LARAVEL_STORAGE_LINK: "true"
      AUTORUN_LARAVEL_EVENT_CACHE: "false"
      AUTORUN_LARAVEL_ROUTE_CACHE: "false"
      AUTORUN_LARAVEL_VIEW_CACHE: "false"
      AUTORUN_LARAVEL_CONFIG_CACHE: "true"
    volumes:
      - ./storage:/var/www/html/storage
    depends_on:
      - db
      - redis
    healthcheck:
      test: ["CMD", "healthcheck-horizon"]
      interval: 10s
      timeout: 5s
      retries: 3
    networks:
      - pixelfed-network

  scheduler:
    image: ghcr.io/pixelfed/pixelfed:v0.15.2
    restart: unless-stopped
    command: ["php", "artisan", "schedule:work"]
    stop_signal: SIGTERM
    env_file:
      - .env
    environment:
      PHP_POST_MAX_SIZE: "500M"
      PHP_UPLOAD_MAX_FILE_SIZE: "500M"
      PHP_OPCACHE_ENABLE: "1"
      PHP_OPCACHE_VALIDATE_TIMESTAMPS: "0"
      AUTORUN_ENABLED: "false"
      AUTORUN_LARAVEL_MIGRATION: "false"
      AUTORUN_LARAVEL_MIGRATION_ISOLATION: "false"
      AUTORUN_LARAVEL_STORAGE_LINK: "true"
      AUTORUN_LARAVEL_EVENT_CACHE: "false"
      AUTORUN_LARAVEL_ROUTE_CACHE: "false"
      AUTORUN_LARAVEL_VIEW_CACHE: "false"
      AUTORUN_LARAVEL_CONFIG_CACHE: "true"
    volumes:
      - ./storage:/var/www/html/storage
    depends_on:
      - db
      - redis
    healthcheck:
      test: ["CMD", "healthcheck-schedule"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 10s
    networks:
      - pixelfed-network

networks:
  pixelfed-network:
    driver: bridge
    ipam:
      config:
        - subnet: 10.89.65.0/24

cd /opt/pixelfed
docker compose up -d

[+] Running 6/6
 ✔ Network pixelfed-0152-stack_pixelfed-network  Created
 ✔ Container pixelfed-0.15.2-db      Started
 ✔ Container pixelfed-0.15.2-redis   Started
 ✔ Container pixelfed-0.15.2-app     Started
 ✔ Container pixelfed-0.15.2-horizon Started
 ✔ Container pixelfed-0.15.2-scheduler Started

docker compose logs pixelfed | grep -E 'storage|migration|migrat|optimize|cache|Server running' | head -20

pixelfed-0.15.2-app  | Starting container ...
pixelfed-0.15.2-app  | Pixelfed auto-run
pixelfed-0.15.2-app  |  * Running in /var/www/html
pixelfed-0.15.2-app  |  * Setting Laravel storage permissions ... done!
pixelfed-0.15.2-app  |  * Clearing Laravel caches ... done!
pixelfed-0.15.2-app  |  * Attempting to establish a database connection ...
pixelfed-0.15.2-app  |  * Running Laravel migrations ...
pixelfed-0.15.2-app  | INFO  Running migrations.
pixelfed-0.15.2-app  |  2014_10_12_000000_create_password_resets_tables ............ DONE
pixelfed-0.15.2-app  |  （……268 个迁移逐条输出，见 migrate:status 核对……）
pixelfed-0.15.2-app  |  * Caching Laravel config ... done!
pixelfed-0.15.2-app  |  * Caching Laravel routes ... done!
pixelfed-0.15.2-app  |  * Caching Laravel views ... done!
pixelfed-0.15.2-app  |  *** Pixelfed Auto-run completed successfully ***

docker compose ps

NAME                    STATUS
pixelfed-0.15.2-app     Up 9 minutes (healthy)
pixelfed-0.15.2-db      Up 9 minutes (healthy)
pixelfed-0.15.2-horizon Up 9 minutes (healthy)
pixelfed-0.15.2-redis   Up 9 minutes (healthy)
pixelfed-0.15.2-scheduler Up 9 minutes (healthy)

docker compose exec pixelfed php artisan migrate:status | grep -c 'Ran'

268

docker compose exec pixelfed php artisan user:create \
  --name="admin" --username="admin" \
  --email="admin@example.com" \
  --password="q1w2e3r4" \
  --is_admin=1 --confirm_email=1

Created user admin!

docker compose exec pixelfed php artisan user:admin admin

 Add admin privileges to this user? (yes/no) [no]:
 > yes

Successfully changed permissions!

# 1) 导入城市数据：发行包不含 cities.json，需先从源码仓库放入存储目录（见 11.8）
docker compose exec pixelfed php artisan import:cities

imported 128769 entries!

# 2) 创建实例 Actor
docker compose exec pixelfed php artisan instance:actor

Created instance actor!

# 1) 实例 API（用配置的 IP/域名访问，不要用 127.0.0.1，原因见 11.5）
curl -s http://192.168.146.128:8135/api/v1/instance -H 'Accept: application/json' | head -c 200

{"domain":"192.168.146.128","title":"Pixelfed","version":"3.5.3 (compatible; Pixelfed 0.15.2)","description":...

# 2) 登录页
curl -s -o /dev/null -w '%{http_code}\n' http://192.168.146.128:8135/login

200

# 数据库
docker run -d --name pixelfed-0.15.2-db \
  -e MYSQL_DATABASE=pixelfed -e MYSQL_USER=pixelfed -e MYSQL_PASSWORD=q1w2e3r4 \
  -e MYSQL_ROOT_PASSWORD=q1w2e3r4 \
  -v /opt/pixelfed/mariadb-data:/var/lib/mysql mariadb:11.8

# 应用（含端口映射与存储挂载）
docker run -d --name pixelfed-0.15.2-app \
  --env-file /opt/pixelfed/.env \
  -p 8135:8080 \
  -e AUTORUN_ENABLED=true -e AUTORUN_LARAVEL_MIGRATION=true \
  -v /opt/pixelfed/storage:/var/www/html/storage \
  ghcr.io/pixelfed/pixelfed:v0.15.2

# 队列工作器
docker run -d --name pixelfed-0.15.2-horizon \
  --env-file /opt/pixelfed/.env \
  -v /opt/pixelfed/storage:/var/www/html/storage \
  ghcr.io/pixelfed/pixelfed:v0.15.2 php artisan horizon

# 定时任务调度器
docker run -d --name pixelfed-0.15.2-scheduler \
  --env-file /opt/pixelfed/.env \
  -v /opt/pixelfed/storage:/var/www/html/storage \
  ghcr.io/pixelfed/pixelfed:v0.15.2 php artisan schedule:work

# 缓存
docker run -d --name pixelfed-0.15.2-redis \
  -v /opt/pixelfed/redis-data:/data redis:8-alpine redis-server --appendonly yes

# 状态总览
docker compose ps

# 应用日志（含 AUTORUN 初始化序列）
docker compose logs -f pixelfed

# 队列工作器日志（图片优化/联邦投递在此执行）
docker compose logs -f horizon

# 重启单个服务（.env 改动无效，见 11.6 注意事项）
docker compose restart pixelfed

# .env 修改后的正确生效方式：重建
docker compose up -d

# 进入应用执行 artisan（运维命令全集见命令详解篇）
docker compose exec pixelfed php artisan

# 版本升级：改 .env / compose 中的版本号后
docker compose pull && docker compose up -d

# 备份数据库
docker compose exec db sh -c 'mariadb-dump -uroot -p"$MYSQL_ROOT_PASSWORD" pixelfed' > pixelfed-$(date +%F).sql

file_put_contents(/var/www/html/storage/logs/laravel.log): Failed to open stream: Permission denied

chown -R 33:33 /opt/pixelfed/storage
docker compose up -d

Please provide a valid cache path.

ERROR 3763 (HY000) at line 1: Expression of generated column 'key_hash' contains a disallowed function: `md5`.

docker compose exec pixelfed php artisan tinker --execute='$r=\App\Models\ConfigCache::where("k","pixelfed.open_registration")->first(); if($r)$r->delete(); \Illuminate\Support\Facades\Cache::forget("config_cache:_v0-key:pixelfed.open_registration");'
docker compose exec pixelfed sh -c 'php artisan optimize:clear && php artisan optimize'

OCI runtime exec failed: exec: "healthcheck-frankenphp": executable file not found in $PATH: unknown
OCI runtime exec failed: exec: "mysqladmin": executable file not found in $PATH: unknown

Error: The file storage/app/cities.json is missing. Run `git checkout storage/app/cities.json` to download it.

curl -fsSL -o /opt/pixelfed/storage/app/cities.json \
  https://raw.githubusercontent.com/pixelfed/pixelfed/v0.15.2/storage/app/cities.json
chown 33:33 /opt/pixelfed/storage/app/cities.json
docker compose exec pixelfed php artisan import:cities