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

s3cmd с WebShield S3

Настройка s3cmd для работы с S3-совместимым объектным хранилищем WebShield.

s3cmd — консольный клиент S3 на Python; ставится из репозитория дистрибутива, из Homebrew или через pip. Для подключения задайте endpoint и способ адресации в ~/.s3cfg. Ключи и бакеты — в разделе Объектное хранилище.

  • Хост endpoint: s3.webshield.pro
  • Access Key ID и Secret Access Key со страницы Хранилище S3 в личном кабинете.
  • Точное имя бакета из личного кабинета (например, company-backups).
Terminal window
# Debian/Ubuntu
sudo apt install s3cmd
# macOS
brew install s3cmd
# или через pip: pip install s3cmd

s3cmd нужно указать хост для API и шаблон адреса бакета. Пример с именем бакета в пути — создайте ~/.s3cfg:

[default]
access_key = WSS...
secret_key = <секрет>
host_base = s3.webshield.pro
host_bucket = s3.webshield.pro/%(bucket)s
use_https = True
signature_v2 = False

Строка host_bucket с /%(bucket)s после хоста включает адресацию через путь. Для доменной адресации замените её на host_bucket = %(bucket)s.s3.webshield.pro; host_base оставьте прежним.

Terminal window
s3cmd ls # список бакетов
s3cmd ls s3://company-backups/ # список объектов
s3cmd put ./dump.sql.gz s3://company-backups/db/ # загрузить
s3cmd get s3://company-backups/db/dump.sql.gz . # скачать
s3cmd sync ./media/ s3://company-backups/media/ # синхронизировать каталог
s3cmd del s3://company-backups/db/dump.sql.gz # удалить

Крупные файлы загружаются multipart-загрузкой автоматически.

  • Для создания и удаления бакетов нужен ключ с правом управления бакетами; как его выпустить.
  • При отрицательном балансе хранилище переходит в режим «только чтение»: загрузка (put/sync) отклоняется, скачивание работает. Пополните баланс, чтобы вернуть запись.