Перейти к содержимому
RWP Shop Docs

Сервер и эксплуатация

Настройка S3

Настройте S3-совместимое хранилище для загрузок и медиа

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

# 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
S3_FORCE_PATH_STYLE=true

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

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_FORCE_PATH_STYLE=${S3_FORCE_PATH_STYLE}

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

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

rustfs:
image: 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:

volumes:
rwp_shop_db_data:
rustfs_data:

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

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

Создайте бакет в Yandex Cloud → Object Storage. Получите статический ключ доступа в сервисном аккаунте с ролью storage.editor.

# Yandex Object Storage
S3_ENABLED=true
S3_ENDPOINT=https://storage.yandexcloud.net
S3_ACCESS_KEY=<KEY_ID>
S3_SECRET_KEY=<SECRET>
S3_PUBLIC_URL=https://<BUCKET>.storage.yandexcloud.net
S3_REGION=ru-central1
S3_BUCKET=<BUCKET>

Для публичного доступа включите ACL public-read на бакете или используйте Website hosting. Подключите свой домен через CNAME <BUCKET>.website.yandexcloud.net.

В панели VK Cloud → Cloud Storage создайте проект и Hotbox-бакет. Сгенерируйте S3 ключи в разделе аккаунта.

# VK Cloud Hotbox
S3_ENABLED=true
S3_ENDPOINT=https://hb.ru-msk.vkcs.cloud
S3_ACCESS_KEY=<ACCESS_KEY>
S3_SECRET_KEY=<SECRET_KEY>
S3_PUBLIC_URL=https://<BUCKET>.hb.ru-msk.vkcs.cloud
S3_REGION=ru-msk
S3_BUCKET=<BUCKET>

Icebox дешевле, но не подходит — латентность высокая. Используйте только Hotbox.

Создайте контейнер в панели Selectel → Облачное хранилище. Выберите тип «S3-совместимый». Сгенерируйте сервисного пользователя с ключами S3.

# Selectel Object Storage
S3_ENABLED=true
S3_ENDPOINT=https://s3.ru-1.storage.selcloud.ru
S3_ACCESS_KEY=<ACCESS_KEY>
S3_SECRET_KEY=<SECRET_KEY>
S3_PUBLIC_URL=https://<BUCKET>.s3.ru-1.storage.selcloud.ru
S3_REGION=ru-1
S3_BUCKET=<BUCKET>
S3_FORCE_PATH_STYLE=false

Для публичных файлов установите контейнеру тип «публичный» в панели. Альтернативно — подключите CDN Selectel.

Для бакетов Selectel с virtual-hosted адресацией установите S3_FORCE_PATH_STYLE=false. Иначе клиент сформирует path-style URL, и имя бакета может попасть в ключ объекта.

В панели Timeweb Cloud → Облачное хранилище создайте бакет. Ключи доступа в разделе «API и интеграции».

# Timeweb Cloud Storage
S3_ENABLED=true
S3_ENDPOINT=https://s3.timeweb.cloud
S3_ACCESS_KEY=<ACCESS_KEY>
S3_SECRET_KEY=<SECRET_KEY>
S3_PUBLIC_URL=https://<BUCKET>.s3.timeweb.cloud
S3_REGION=ru-1
S3_BUCKET=<BUCKET>

Установите политику бакета public-read через AWS CLI, либо включите публичный доступ в панели.

Создайте бакет в Cloud.ru → Evolution Object Storage. Сгенерируйте ключи в IAM.

# Cloud.ru Evolution Object Storage
S3_ENABLED=true
S3_ENDPOINT=https://s3.cloud.ru
S3_ACCESS_KEY=<TENANT_ID>:<KEY_ID>
S3_SECRET_KEY=<SECRET>
S3_PUBLIC_URL=https://<BUCKET>.s3.cloud.ru
S3_REGION=ru-central-1
S3_BUCKET=<BUCKET>

S3_ACCESS_KEY формируется как <tenant_id>:<key_id> — особенность Cloud.ru. Публичный доступ настраивается через политику бакета.

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

# 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). Egress бесплатный — выгодно для раздачи медиа.

Для прямой загрузки/скачивания через presigned URLs настройте CORS на бакете. Пример правила:

[
{
"AllowedOrigins": ["https://your-domain.com"],
"AllowedMethods": ["GET", "PUT", "HEAD"],
"AllowedHeaders": ["*"],
"ExposeHeaders": ["ETag"],
"MaxAgeSeconds": 86400
}
]

Замените https://your-domain.com на домен фронтенда/Mini App. Для wildcard поддоменов: https://*.your-domain.com.

docker compose up -d