Объектное хранилище S3 HOSTKEY (S3 Object Storage)¶

В этой статье

• Описание сервиса S3 Object Storage
• Основные возможности S3 Object Storage
• Технические параметры S3 Object Storage
• Тарификация S3 Object Storage
• Создание S3 хранилища в Invapi
• Панель управления S3 хранилища в Invapi
• Получение учетных данных S3 хранилища в Invapi
• Работа с бакетами S3 хранилища в Invapi
• Использование через S3 Browser
• Основные операции с файлами
• Работа с S3 Object Storage через AWS CLI

Описание сервиса S3 Object Storage¶

Основные возможности S3 Object Storage¶

• Создание независимых хранилищ - в течение бесплатного бета-периода на тарифном плане Free Beta 1 пользователь может создать до 3 независимых S3-хранилищ.;
• Независимость от VPS/VDS - S3 хранилища работают автономно и не требуют аренды серверов HOSTKEY;
• Создание bucket - при создании хранилища автоматически создаётся первый bucket с уникальным именем. В течение бета-периода пользователь может создать до 10 бакетов в каждом S3-хранилище;
• S3-совместимый доступ - полная поддержка стандартного протокола Amazon S3 для всех операций с данными;
• Работа с любыми S3-клиентами - использование S3 Browser, Cyberduck, boto3 и других S3-совместимых инструментов;
• Защищённый доступ - авторизация через Access Key и Secret Key по протоколу HTTPS;
• Простое управление credentials - генерация и просмотр ключей доступа через веб-интерфейс личного кабинета;
• Готовые тарифы - выбор планов с фиксированным объёмом хранилища и пропускной способностью.

Технические параметры S3 Object Storage¶

• Endpoint URL: https://s3-nl.hostkey.com;
• Протокол: HTTPS (SSL/TLS);
• Авторизация: AWS Signature Version 4.

Тарификация S3 Object Storage¶

S3-хранилище предоставляется на платной основе. Ознакомиться с актуальными тарифными планами вы можете по ссылке. Также вы можете увеличить объём хранилища и трафика и оплачивать их по модели «оплата по факту потребления». Стоимость дополнительного потребления рассчитывается ежедневно.

В момент заказа услуги с баланса учетной записи будут списаны денежные средства за месяц фактического использования согласно условий выбранного тарифного плана. В дальнейшем оплата за следующие месяцы использования, а также оплата за превышения лимита ресурсов будет также производиться с баланса учетной записи.

Отчетные документы формируются 2 числа следующего за отчетным месяца в 05:00 UTC. Ознакомиться с отчетными документами вы можете в разделе Биллинг в Invapi. Сумма в отчетных документах формируется за календарный месяц и включает в себя стоимость использования услугой, а также весь объем дополнительных оплат за превышения лимита ресурсов.

Создание S3 хранилища в Invapi¶

1. Войдите в личный кабинет в Invapi;

2. Перейдите в раздел S3 Storage;

3. Создайте новое хранилище:

   

   • Регион: выберите регион (по умолчанию NL - Нидерланды);
   • Имя бакета: введите название бакета (например, bde347688-testbucket):
     • имя должно быть уникальным;
     • максимум 63 символа;
     • только строчные буквы, цифры и дефисы;
     • должно начинаться и заканчиваться буквой или цифрой.
   • Тариф: выберите тарифный план (например, Standart). Для выбора необходимо кликнуть на название тарифа;
   • Нажмите Создать хранилище.

   После создания хранилище вам будет предложено оплатить ваш заказ

   

Панель управления S3 хранилища в Invapi¶

После успешной оплаты вы попадете на панель Ваши независимые хранилища (или выбрав пункт S3 хранилище в верхнем меню) где сможете:

1. Посмотреть оплаченные вами хранилища и их тарифы
2. Создать новое независимое хранилище S3
3. Выбрать конкретное хранилище из списка, чтобы посмотреть его данные
4. Посмотреть статистику по использованию объема хранилища и трафика
5. Посмотреть учетные данные для подключения к хранилищу
6. Добавить новые бакеты в текущее хранилище
7. Посмотреть список добавленных бакетов и статистику по ним
8. Выполнить манипуляции с бакетами

Получение учетных данных S3 хранилища в Invapi¶

1. В списке ваших хранилищ найдите созданное хранилище и перейдите на вкладку Учетные данные:

   

2. Скопируйте учетные данные:

   Вам понадобятся:

   • Имя хоста (Endpoint URL): https://s3-nl.hostkey.com;
   • Идентификатор пользователя S3: (например, z5CrlJ67QuiF5xWp149TcmmhBjORRRu6);
   • Ключ доступа (Access key): нажмите чтобы показать ключ;
   • Секретный ключ (Secret key)*: нажмите чтобы показать ключ.

   Внимание

   Необходимо сначала нажать на иконку для отображения реальных значений ключей, только после этого их можно корректно скопировать.

   Сохраните эти данные - они понадобятся для подключения.

Работа с бакетами S3 хранилища в Invapi¶

Непосредственно из интерфейса работы с S3 хранилищем в Invapi вам доступны следующие действия с бакетами:

1. Просмотр места занимаемого бакетом в хранилище и числа объектов в нем;
2. Удаление бакета;
3. Просмотр содержимого бакета при нажатии на строку с его названием;
4. Получение информации о размере файла и дате создания файла в бакете;
5. Поиск файлов в бакете;
6. Удаление отдельных файлов из бакета.

Использование через S3 Browser¶

1. Скачайте бесплатную версию S3 Browser: https://s3browser.com;

2. Добавьте новый аккаунт:

   

   • Откройте S3 Browser;
   • Нажмите Accounts >> Add New Account.

3. Заполните форму:

   • Display name: HOSTKEY S3 (любое удобное имя);
   • Account type: S3 Compatible Storage (не Amazon S3 Storage!);
   • API endpoint: s3-nl.hostkey.com (без https://);
   • Access Key ID: вставьте ваш Access Key из панели HOSTKEY;
   • Secret Access Key: вставьте ваш Secret Key из панели HOSTKEY;
   • Use secure transfer (SSL/TLS): оставьте чекбокс активным.

4. Нажмите Add new account;

5. Работайте с файлами:

   

   После успешного подключения вы увидите:

   • Список buckets слева;
   • Файлы в bucket справа;
   • Кнопки управления: Upload, Download, Delete, New Folder, Refresh.

   Доступные операции:

   • Upload - загрузка файлов;
   • Download - скачивание файлов;
   • Delete - удаление файлов;
   • New Folder - создание папок;
   • Refresh - обновление списка.

Основные операции с файлами¶

После подключения к S3 хранилищу через S3-совместимый клиент вам доступны следующие операции:

Загрузка файлов¶

1. Через S3 Browser:

   • Выберите bucket в левой панели;
   • Нажмите кнопку Upload (загрузка файла) или Upload folder(s) (загрузка папки);
   • Выберите файлы на вашем компьютере;
   • Подтвердите загрузку:

   

2. Через drag-and-drop:

   • Просто перетащите файлы из проводника в окно S3 Browser.

Скачивание файлов¶

1. Выберите файл в bucket;

2. Нажмите кнопку Download или щёлкните правой кнопкой мыши и выберите Download:

   

3. Укажите папку для сохранения на вашем компьютере.

Удаление файлов и папок¶

1. Выберите файл или папку;

2. Нажмите кнопку Delete или клавишу Delete на клавиатуре:

   

3. Подтвердите удаление.

Создание структуры папок¶

1. Выберите bucket или папку;

2. Нажмите New Folder:

   

3. Введите имя папки:

   

4. Нажмите Create new folder.

Копирование и перемещение файлов¶

• Копирование: выберите файл > щёлкните правой кнопкой > Copy > перейдите в целевую папку > щёлкните правой кнопкой > Paste;
• Перемещение: перетащите файл в нужную папку с зажатой кнопкой мыши.

Переименование файлов¶

1. Щёлкните правой кнопкой мыши на файле;

2. Выберите Rename:

   

3. Введите новое имя;

4. Нажмите Enter на клавиатуре.

Управление правами доступа (ACL)¶

1. Щёлкните правой кнопкой мыши на файле или bucket;

2. В контекстном меню выберите Edit Permissions (ACL):

   

3. В открывшемся окне настройте права доступа для пользователей:

   • Owner (Владелец) - полный контроль над объектом;
   • Any AWS Users - доступ для любых пользователей AWS;
   • All Users - публичный доступ для всех.

4. Для каждой категории пользователей можно настроить:

   • Full Control - полный контроль;
   • Read - чтение объекта;
   • Write - запись/изменение объекта;
   • Read Permissions - чтение прав доступа;
   • Write Permissions - изменение прав доступа:

   

5. Для быстрой настройки используйте кнопки:

   • Make public - сделать файл публичным;
   • Make private - сделать файл приватным.

6. После настройки нажмите Apply changes для сохранения изменений.

Генерация веб-ссылок¶

Для создания публичной ссылки на файл или папку в S3 Object Storage:

1. Щёлкните правой кнопкой мыши на файле;

2. В контекстном меню выберите Generate Web URL:

   

3. В открывшемся окне Web URL Generator настройте параметры генерации ссылки:

4. Use secure transfer (HTTPS) - использовать защищённое соединение (рекомендуется включить для конфиденциальных данных);

5. Expiration - выберите период действия ссылки;

6. Hostname - выбор имени хоста:

   • Use default host name - использовать стандартный адрес (например: https://s3-nl.hostkey.com/bfcc62b88-testbucket/);
   • Или укажите собственный домен;

7. После настройки параметров система сгенерирует полную ссылку на файл, например:

   https://s3-nl.hostkey.com/bfcc62b88-testbucket/dedicated-server-architecture.drawio
   

Сокращение ссылки:¶

1. Для создания короткой ссылки нажмите кнопку Shorten и выберите сервис:

   • Shorten with Bitly - сокращение через Bitly;
   • Shorten with TinyURL - сокращение через TinyURL;
   • Configure... - настройка сервисов сокращения;

   

   

2. После успешного сокращения получите короткую ссылку (например: https://tinyurl.com/2dhcsk8y);

3. Используйте кнопки:

   • Copy - скопировать ссылку в буфер обмена;
   • Close - закрыть окно генератора.

   

Работа с S3 Object Storage через AWS CLI¶

Установка AWS CLI¶

AWS CLI можно установить двумя способами. Выберите один из них:

Способ 1: Установка через pip (универсальный)¶

Преимущества:

• Простая установка одной командой;
• Легко обновлять;
• Работает на всех платформах (Windows, Linux, macOS).

Недостатки:

• Требует установленный Python;
• Может показывать предупреждения в некоторых терминалах.

Установка:

pip install awscli boto3

Проверка установки:

aws --version

pip show awscli boto3

Обновление:

pip install --upgrade awscli boto3

Способ 2: MSI-установщик для Windows (рекомендуется)¶

Преимущества:

• Не требует Python;
• Нет предупреждений в терминале;
• Чистая установка в систему.

Недостатки:

• Только для Windows;
• Обновления нужно скачивать вручную.

Установка через терминал:

curl -o AWSCLIV2.msi https://awscli.amazonaws.com/AWSCLIV2.msi

msiexec /i AWSCLIV2.msi /quiet /norestart

После установки:

1. Перезапустите терминал;
2. Проверьте установку.

aws --version

where aws

Ожидаемый результат:

aws-cli/2.x.x Python/3.x.x Windows/10 exe/AMD64
C:\Program Files\Amazon\AWSCLIV2\aws.exe

Альтернативный способ установки:

• Скачайте вручную: https://awscli.amazonaws.com/AWSCLIV2.msi;
• Запустите установщик двойным кликом;
• Перезапустите терминал.

Проверка конфликтов:

where aws

Если показывает несколько путей - удалите одну из версий:

pip uninstall awscli -y

wmic product where "name like 'AWS Command Line Interface%'" call uninstall

Настройка подключения к S3 Object Storage¶

1. Получение Учетных данных S3 хранилища

1. Войдите в личный кабинет в Invapi;
2. Перейдите в раздел S3 Storage;
3. Откройте вкладку "Учетные данные";

4. Скопируйте следующие данные:

   Для идентификатора пользователя S3 (Access Key ID):

   • Нажмите иконку для отображения ключа;
   • Скопируйте отображенное значение вручную или через кнопку Копировать.

   Для секретного ключа (Secret Access Key):

   • Нажмите иконку для отображения ключа;
   • Скопируйте отображенное значение вручную или через кнопку Копировать.

   Внимание

   Необходимо сначала нажать на иконку для отображения реальных значений ключей, только после этого их можно корректно скопировать.

5. Также потребуются:

6. Имя хоста: https://s3-nl.hostkey.com;
7. Регион: отображается в панели (например, nl для Нидерландов).

2. Настройка профиля

aws configure --profile hostkey

При запросах введите:

AWS Access Key ID [None]: ваш_access_key_id
AWS Secret Access Key [None]: ваш_secret_access_key
Default region name [None]: nl
Default output format [None]: json

Пример:

AWS Access Key ID [None]: s3uid_XXXXXXXXXXXXXXXXX
AWS Secret Access Key [None]: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Default region name [None]: nl
Default output format [None]: json

3. Проверка конфигурации

aws configure list --profile hostkey

Ожидаемый вывод:

NAME       : VALUE                    : TYPE             : LOCATION
profile    : hostkey                  : manual           : --profile
access_key : ****************xxxx     : shared-credentials-file :
secret_key : ****************xxxx     : shared-credentials-file :
region     : nl                       : config-file      : ~/.aws/config

4. Проверка подключения

aws s3 ls --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Ожидаемый результат (список ваших buckets):

2025-11-26 13:54:16 ваш-bucket-name

Основные операции с файлами¶

Просмотр содержимого bucket¶

aws s3 ls s3://имя-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Пример:

aws s3 ls s3://ваш-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Результат:

2025-11-28 12:14:28         21 test.txt
2025-11-28 14:52:11         19 test_new.txt

Загрузка файла¶

Создать тестовый файл:

echo Hello HOSTKEY S3 > test.txt

Загрузить файл в bucket:

aws s3 cp test.txt s3://имя-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Пример:

aws s3 cp test_new.txt s3://ваш-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Результат:

upload: .\test_new.txt to s3://ваш-bucket-name/test_new.txt

Скачивание файла¶

aws s3 cp s3://имя-bucket/файл.txt ./локальный-файл.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Пример:

aws s3 cp s3://ваш-bucket-name/test.txt ./downloaded.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Результат:

download: s3://ваш-bucket-name/test.txt to .\downloaded.txt

Проверка скачанного файла (Windows):

type downloaded.txt

Проверка скачанного файла (Linux/macOS):

cat downloaded.txt

Удаление файла¶

aws s3 rm s3://имя-bucket/файл.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Пример:

aws s3 rm s3://ваш-bucket-name/test.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Результат:

delete: s3://ваш-bucket-name/test.txt

Синхронизация папок¶

Загрузка папки в bucket:

aws s3 sync путь/к/локальной/папке s3://имя-bucket/путь-в-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Пример:

aws s3 sync C:\Users\User\Documents\Test s3://ваш-bucket-name/remote-folder/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Результат:

upload: Documents\Test\file1.txt to s3://ваш-bucket-name/remote-folder/file1.txt
upload: Documents\Test\file2.docx to s3://ваш-bucket-name/remote-folder/file2.docx

Скачивание папки из bucket:

aws s3 sync s3://имя-bucket/путь-в-bucket/ путь/к/локальной/папке --profile hostkey --endpoint-url https://s3-nl.hostkey.com

С отображением прогресса:

aws s3 sync C:\Users\User\Documents\Test s3://ваш-bucket-name/backup/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com --progress

Правильно:

aws s3 sync "C:\Users\Name\My Documents" s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Неправильно (вызовет ошибку):

aws s3 sync C:\Users\Name\My Documents s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Дополнительные команды¶

Создание bucket¶

aws s3 mb s3://новый-bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Удаление пустого bucket¶

aws s3 rb s3://bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Удаление bucket со всем содержимым¶

aws s3 rb s3://bucket-name --force --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Копирование между buckets¶

aws s3 cp s3://source-bucket/file.txt s3://dest-bucket/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Перемещение файла¶

aws s3 mv s3://bucket-name/old-file.txt s3://bucket-name/new-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Устранение проблем¶

Ошибка: "aws" не является командой¶

Причина: AWS CLI не установлен или не добавлен в PATH.

Решение:

1. Перезапустите терминал после установки;
2. Проверьте установку с помощью команды where aws (должен показать путь);
3. Если не помогает - переустановите AWS CLI.

Ошибка: Invalid bucket name¶

Причина: Неправильное имя bucket.

Решение: Используйте точное имя bucket из панели HOSTKEY (например, prefix-testbucket).

Ошибка: AccessDenied¶

Причина: Неправильные credentials или недостаточно прав.

Решение:

1. Проверьте Access Key и Secret Key в панели HOSTKEY;
2. Пересоздайте профиль.

aws configure --profile hostkey

Конфликт версий pip и MSI¶

Симптомы: Команда where aws показывает два пути.

Решение: Удалите одну из версий (см. раздел "Не смешивайте методы установки").

Сброс конфигурации¶

Windows:

rmdir /S /Q %USERPROFILE%\.aws

Linux/macOS:

rm -rf ~/.aws

Настроить заново:

aws configure --profile hostkey

Расположение конфигурационных файлов¶

Windows:

C:\Users\ИМЯ_ПОЛЬЗОВАТЕЛЯ\.aws\credentials
C:\Users\ИМЯ_ПОЛЬЗОВАТЕЛЯ\.aws\config

Linux/macOS:

~/.aws/credentials
~/.aws/config

Содержание файлов:

• credentials - Access Key и Secret Key;
• config - настройки региона и формата вывода.

Полезные команды для проверки¶

Версия AWS CLI:

aws --version

Расположение исполняемого файла:

where aws

Информация о профиле:

aws configure list --profile hostkey

Информация о пакетах (для pip-версии):

pip show awscli boto3

Обновление (для pip-версии):

pip install --upgrade awscli boto3