Настройка S3

По умолчанию загруженные файлы (вложения поддержки, изображения FAQ, файлы партнёров, PWA-ассеты) хранятся локально в ./uploads. Используйте S3-совместимое хранилище для масштабируемости и надёжности.

Настройка

Шаг 1: Добавьте настройки S3 в .env

bash

# S3 Storage
S3_ENABLED=true
S3_ENDPOINT=http://rustfs:9000
S3_ACCESS_KEY=your_access_key
S3_SECRET_KEY=your_secret_key
S3_PUBLIC_URL=https://s3.example.com
S3_REGION=us-east-1
S3_BUCKET=files

Шаг 2: Добавьте переменные S3 в сервис бота

Убедитесь, что в compose.yaml в секции environment сервиса бота прокинуты все S3-переменные:

yaml

environment:
  - S3_ENABLED=${S3_ENABLED}
  - S3_ENDPOINT=${S3_ENDPOINT}
  - S3_ACCESS_KEY=${S3_ACCESS_KEY}
  - S3_SECRET_KEY=${S3_SECRET_KEY}
  - S3_PUBLIC_URL=${S3_PUBLIC_URL}
  - S3_REGION=${S3_REGION}
  - S3_BUCKET=${S3_BUCKET}

Внимание

Без этих переменных контейнер бота не будет знать о настройках S3, даже если они указаны в .env. Docker Compose передаёт в контейнер только те переменные, которые явно перечислены в секции environment.

Шаг 3: Выберите провайдера S3

Используйте один из вариантов ниже.

RustFS (self-hosted)

Добавьте сервис в compose.yaml:

yaml

rustfs:
  image: ghcr.io/rustfs/rustfs:latest
  container_name: rwp_shop_rustfs
  restart: unless-stopped
  command: server /data --console-address ":9001"
  environment:
    - RUSTFS_ROOT_USER=your_access_key
    - RUSTFS_ROOT_PASSWORD=your_secret_key
  volumes:
    - rustfs_data:/data
  ports:
    - "127.0.0.1:9001:9001"
  networks:
    - remnawave-network

Добавьте volume:

yaml

volumes:
  rwp_shop_db_data:
  rustfs_data:

Опубликуйте публичный URL (нужен для presigned URLs):

Caddy

txt

s3.example.com {
    import security_headers
    reverse_proxy rustfs:9000
}

Nginx

nginx

server {
    listen 443 ssl http2;
    server_name s3.example.com;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        client_max_body_size 100M;
    }
}

Cloudflare R2

Создайте бакет и S3 API ключи в панели Cloudflare. R2 использует S3-совместимый endpoint формата https://<ACCOUNT_ID>.r2.cloudflarestorage.com.

Пример переменных окружения:

bash

# Cloudflare R2
S3_ENABLED=true
S3_ENDPOINT=https://<ACCOUNT_ID>.r2.cloudflarestorage.com
S3_ACCESS_KEY=<R2_ACCESS_KEY_ID>
S3_SECRET_KEY=<R2_SECRET_ACCESS_KEY>
S3_PUBLIC_URL=https://<YOUR_PUBLIC_BUCKET_URL>
S3_REGION=auto              # R2 использует "auto" как регион
S3_BUCKET=files             # рекомендуется для R2 free tier (лимит бакетов)

S3_PUBLIC_URL должен указывать на публичный URL бакета, включённый в R2 (custom domain или управляемый r2.dev).

Шаг 4: Перезапустите бота

bash

docker compose up -d

Примечание

Переменные окружения

Переменная	Описание
`S3_ENABLED`	Включить S3 хранилище (`true`/`false`)
`S3_ENDPOINT`	Endpoint S3 API
`S3_ACCESS_KEY`	Ключ доступа S3
`S3_SECRET_KEY`	Секретный ключ S3
`S3_PUBLIC_URL`	Публичный HTTPS URL для presigned URLs
`S3_REGION`	Регион S3 (по умолчанию: `us-east-1`). Требуется для AWS и некоторых S3-совместимых провайдеров
`S3_BUCKET`	Опциональное имя родительского бакета. Если задано, все логические бакеты становятся префиксами ключей внутри одного бакета

Внимание

S3_PUBLIC_URL обязателенS3_PUBLIC_URL должен быть публичным HTTPS URL. Он используется для генерации presigned URLs для прямых скачиваний файлов.

Автоматически создаваемые бакеты

При старте бот создаёт нужные бакеты, если их нет:

faq
partner
support
pwa
start
branding

Настройка S3