Документация ExCloud

ExCloud использует протокол, совместимый с Amazon S3. Если ваш инструмент умеет работать с S3, он будет работать с ExCloud — достаточно указать эндпоинт и ключи.

Быстрый старт

Создайте бакет в консоли, сгенерируйте ключ доступа и подключите любой S3-клиент. Три шага:

Войдите в консоль и откройте раздел «Бакеты S3».
Создайте бакет, выбрав регион хранения.
В разделе «Ключи доступа» получите Access Key и Secret Key.

Ключи доступа

Каждый ключ можно ограничить по бакетам, правам (чтение/запись) и диапазону IP. Secret Key показывается один раз — сохраните его сразу.

Храните Secret Key как пароль. Если ключ скомпрометирован, отзовите его в консоли — доступ прекратится немедленно.

Эндпоинт и регионы

# S3-эндпоинт ExCloud
Endpoint: https://s3.excloude.rest
Region: ru-msk-1 # ru-msk-1, ru-spb-1, kz-ala-1, de-fra-1, nl-ams-1, sg-sin-1

Подключение rclone

Добавьте удалённое хранилище в ~/.config/rclone/rclone.conf:

[excloud]
type = s3
provider = Other
endpoint = https://s3.excloude.rest
access_key_id = EXC...
secret_access_key = ••••••••
region = ru-msk-1

# синхронизировать папку в бакет
rclone sync ./data excloud:prod-backups -P

Резервные копии restic

export AWS_ACCESS_KEY_ID=EXC...
export AWS_SECRET_ACCESS_KEY=••••••••
restic -r s3:https://s3.excloude.rest/prod-backups init
restic -r s3:https://s3.excloude.rest/prod-backups backup /var/data

AWS CLI и SDK

aws --endpoint-url https://s3.excloude.rest s3 ls
aws --endpoint-url https://s3.excloude.rest s3 cp file.zip s3://prod-backups/

SDK для Python (boto3), Go, Node.js и PHP работают так же — передайте параметр endpoint_url.