Встановлення MinIO Object Storage на

Що ми налаштовуємо і навіщо

Ми будемо налаштовувати MinIO — це високопродуктивний, розподілений сервер об'єктного сховища, написаний на Go. Він розроблений для забезпечення S3-сумісного API, що робить його ідеальною заміною або доповненням до хмарних сервісів, таких як Amazon S3, DigitalOcean Spaces або Google Cloud Storage. MinIO дозволяє розгорнути власне об'єктне сховище на будь-якому обладнанні, від одного сервера до кластера з десятків вузлів, забезпечуючи при цьому високу доступність та масштабованість.

Що отримає читач у підсумку? Ви отримаєте повний контроль над своїми даними, незалежність від сторонніх провайдерів та можливість використовувати знайомий S3 API для своїх застосунків. Це особливо цінно для розробників, яким потрібно зберігати великі обсяги неструктурованих даних (зображення, відео, документи, логи, резервні копії) та інтегрувати їх зі своїми сервісами, будь то веб-застосунки, мікросервіси або аналітичні платформи. MinIO чудово підходить для створення приватної хмари для зберігання даних, хостингу статичних сайтів, зберігання медіа-файлів для CDN або навіть як бекенд для CI/CD-пайплайнів.

Які альтернативи існують і чому self-hosted на VPS? На ринку існує безліч хмарних рішень для об'єктного зберігання, таких як Amazon S3, Google Cloud Storage, Azure Blob Storage, DigitalOcean Spaces, Backblaze B2. Ці сервіси пропонують високу надійність, масштабованість і часто мають низьку вартість входу. Однак вони також мають свої недоліки: залежність від одного провайдера, потенційні проблеми з приватністю даних (особливо для чутливої інформації), непередбачувані витрати при великих обсягах трафіку та сховища, а також неможливість повного контролю над інфраструктурою.

Розгортання MinIO на власному VPS або виділеному сервері дає вам:

• Повний контроль: Ви керуєте даними, безпекою та конфігурацією.
• Передбачувані витрати: Ви платите фіксовану ціну за сервер, незалежно від обсягу збережених даних або трафіку (в рамках лімітів сервера).
• Приватність даних: Ваші дані залишаються на вашому сервері, під вашим контролем.
• Продуктивність: Можливість оптимізувати MinIO під свої конкретні завдання та використовувати ресурси сервера максимально ефективно.
• Гнучкість: Можливість інтеграції з локальними сервісами без затримок та додаткових витрат на вихідний трафік.

Який VPS-конфіг потрібен для цього завдання

Вибір відповідного VPS-конфігу для MinIO залежить від передбачуваного навантаження, обсягу збережених даних та вимог до продуктивності. MinIO ефективно використовує доступні ресурси, але об'єктне сховище, особливо при інтенсивній роботі, може бути вимогливим до певних параметрів.

Мінімальні вимоги:

• Процесор (CPU): 1-2 ядра. MinIO не є сильно CPU-інтенсивним для базових операцій, але багатопотокові запити виграють від більшої кількості ядер. Для невеликих навантажень достатньо 1 ядра, для більш активного використання — 2 ядра.
• Оперативна пам'ять (RAM): 2 ГБ. MinIO використовує RAM для кешування метаданих та буферизації даних. 2 ГБ — це комфортний мінімум для стабільної роботи. Якщо планується дуже багато дрібних об'єктів або високе конкурентне навантаження, 4 ГБ буде кращим варіантом.
• Диск: Найкритичніший компонент.
  • Тип: Для об'єктного сховища вкрай важлива продуктивність диска. NVMe SSD або високопродуктивні SATA SSD є обов'язковими для гарної швидкості читання/запису. HDD підходять тільки для архівного зберігання з низькою частотою доступу.
  • Обсяг: Мінімум 50 ГБ для системи та початкових даних. Реальний обсяг залежить від ваших потреб. Переконайтеся, що у вас є достатньо місця для зростання.
  • Відмовостійкість: Якщо ви використовуєте один диск, розгляньте регулярні резервні копії. Для багатодискових конфігурацій MinIO підтримує erasure coding, але на одному VPS це зазвичай неактуально, якщо тільки ви не використовуєте блокове сховище, надане провайдером.
• Мережа: 1 Гбіт/с. Хороша пропускна здатність мережі важлива, оскільки MinIO буде активно передавати дані. Для більшості VPS 1 Гбіт/с є стандартом. Переконайтеся, що у вашого провайдера немає прихованих обмежень або надмірних витрат на вихідний трафік.

Конкретний VPS-план для завдання:

Для запуску MinIO для команди розробників, невеликого SaaS-проєкту або особистих резервних копій рекомендується наступна конфігурація:

• CPU: 2 ядра
• RAM: 4 ГБ
• Диск: 200-500 ГБ NVMe SSD (або більше, залежно від потреб)
• Мережа: 1 Гбіт/с, необмежений або щедрий ліміт трафіку.

Можна взяти VPS із зазначеними характеристиками або аналогічний план в іншого провайдера, що пропонує NVMe SSD та достатній обсяг пам'яті.

Коли потрібен dedicated, а не VPS:

Виділений сервер стає необхідним, коли:

• Потрібна екстремальна продуктивність I/O: Для дуже великих обсягів даних, високої частоти доступу або специфічних робочих навантажень, де продуктивність дискової підсистеми VPS може стати вузьким місцем через спільне використання ресурсів.
• Потрібні великі обсяги зберігання: Якщо вам потрібно кілька терабайт або петабайт даних, виділений сервер з кількома дисками (наприклад, у RAID-масиві) буде більш економічним та продуктивним рішенням.
• Висока доступність та відмовостійкість: Для кластерних розгортань MinIO з erasure coding, що вимагають кілька фізичних вузлів для розподілу даних та забезпечення відмовостійкості на рівні дисків та серверів.
• Специфічні вимоги до безпеки або відповідності: Деякі нормативи можуть вимагати фізичної ізоляції обладнання.

Локація: на що впливає

Вибір локації сервера MinIO важливий з кількох причин:

• Затримка (Latency): Чим ближче сервер до вашої цільової аудиторії або до серверів застосунків, які використовуватимуть MinIO, тим нижчою буде затримка при доступі до даних. Це критично для інтерактивних застосунків.
• Законодавство: Розташування сервера може впливати на застосовне законодавство про захист даних (наприклад, GDPR в Європі).
• Вартість трафіку: Деякі провайдери можуть мати різні тарифи на вихідний трафік залежно від регіону.

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

Підготовка сервера

Підготовка сервера

Перед встановленням MinIO необхідно провести базове налаштування операційної системи. Передбачається, що ви використовуєте свіжу інсталяцію Ubuntu Server 24.04 LTS.

1. Підключення по SSH та оновлення системи

Спочатку підключіться до свого VPS по SSH, використовуючи облікові дані, надані провайдером. Зазвичай це користувач root або стандартний користувач з правами sudo.

ssh user@your_vps_ip_address

Потім оновіть список пакетів та встановлені пакети до останніх версій:

sudo apt update && sudo apt upgrade -y

Це забезпечить наявність усіх актуальних патчів безпеки та останніх версій системних утиліт.

2. Створення нового користувача з правами sudo (якщо не використовуєте root)

Робота під користувачем root не рекомендується для повсякденних завдань. Створіть нового користувача та надайте йому права sudo.

sudo adduser minioadmin
sudo usermod -aG sudo minioadmin

Тепер ви можете вийти з поточної сесії та увійти під новим користувачем:

exit
ssh minioadmin@your_vps_ip_address

3. Налаштування SSH-ключів для безпечного доступу

Використання SSH-ключів набагато безпечніше, ніж паролів. Якщо ви ще не згенерували ключі, зробіть це на своїй локальній машині:

ssh-keygen -t rsa -b 4096

Потім скопіюйте публічний ключ на ваш VPS (замініть minioadmin та your_vps_ip_address):

ssh-copy-id minioadmin@your_vps_ip_address

Після успішного копіювання ключа, рекомендується відключити автентифікацію за паролем для root та вашого нового користувача, щоб підвищити безпеку. Відредагуйте файл /etc/ssh/sshd_config:

sudo nano /etc/ssh/sshd_config

Знайдіть та змініть наступні рядки:

# Відключити вхід для root за паролем
PermitRootLogin prohibit-password
# Відключити автентифікацію за паролем для всіх
PasswordAuthentication no

Збережіть зміни (Ctrl+O, Enter, Ctrl+X) та перезапустіть SSH-сервіс:

sudo systemctl restart sshd

Важливо: Переконайтеся, що ви можете увійти по SSH за допомогою ключа, перш ніж відключати автентифікацію за паролем! Інакше ви втратите доступ до сервера.

4. Налаштування фаєрволу (UFW)

Фаєрвол необхідний для обмеження доступу до вашого сервера лише за необхідними портами. Ubuntu використовує UFW (Uncomplicated Firewall).

sudo apt install ufw -y # Встановлюємо UFW, якщо його немає
sudo ufw allow OpenSSH # Дозволяємо SSH (порт 22)
sudo ufw allow 80/tcp # Дозволяємо HTTP (для Caddy)
sudo ufw allow 443/tcp # Дозволяємо HTTPS (для Caddy)
sudo ufw enable # Вмикаємо фаєрвол
sudo ufw status # Перевіряємо статус

На даному етапі MinIO ще не встановлено, тому його порт (за замовчуванням 9000) поки що не відкриваємо.

5. Встановлення Fail2ban

Fail2ban допомагає захистити сервер від атак методом підбору паролів (brute-force) шляхом блокування IP-адрес, які здійснюють занадто багато невдалих спроб входу.

sudo apt install fail2ban -y
sudo systemctl enable fail2ban
sudo systemctl start fail2ban

Fail2ban за замовчуванням налаштований для захисту SSH. Ви можете перевірити його статус:

sudo fail2ban-client status
sudo fail2ban-client status sshd

Тепер ваш сервер готовий до встановлення MinIO та супутнього ПЗ.

Встановлення ПЗ — покроково

На цьому етапі ми встановимо MinIO та Caddy, який використовуватиметься для забезпечення HTTPS-доступу до MinIO.

1. Встановлення MinIO Server

Ми встановимо MinIO, завантаживши офіційний бінарник та налаштувавши його як системний сервіс. Для актуальності у 2026 році будемо використовувати останні стабільні версії.

1.1. Створення користувача та груп для MinIO

Для підвищення безпеки MinIO працюватиме під своїм власним непривілейованим користувачем.

sudo groupadd -r minio-user # Створюємо групу для MinIO
sudo useradd -r -s /sbin/nologin -g minio-user minio-user # Створюємо користувача без оболонки

1.2. Створення каталогів для MinIO

Створимо каталог для зберігання бінарника MinIO, даних та конфігурації.

sudo mkdir -p /usr/local/bin
sudo mkdir -p /etc/minio
sudo mkdir -p /var/lib/minio

1.3. Завантаження бінарника MinIO

Завантажимо останню стабільну версію MinIO. Актуальні версії можна завжди знайти на офіційному сайті MinIO або GitHub. На момент 2026 року, припустимо, що актуальна версія MinIO має формат RELEASE.2026-XX-XXTXX-XX-XXZ. Ми використовуватимемо mc (MinIO Client) для керування MinIO.

# Завантаження MinIO Server
wget -O /usr/local/bin/minio https://dl.min.io/server/minio/release/linux-amd64/minio # Завантажуємо бінарник MinIO
# Завантаження MinIO Client (mc)
wget -O /usr/local/bin/mc https://dl.min.io/client/mc/release/linux-amd64/mc # Завантажуємо бінарник MinIO Client

1.4. Надання прав на виконання

Зробимо завантажені файли виконуваними.

sudo chmod +x /usr/local/bin/minio # Робимо MinIO виконуваним
sudo chmod +x /usr/local/bin/mc # Робимо MinIO Client виконуваним

1.5. Налаштування прав доступу для каталогу даних

Встановимо власника каталогу даних MinIO на створеного користувача minio-user.

sudo chown minio-user:minio-user /var/lib/minio # Змінюємо власника каталогу даних

2. Встановлення Caddy Web Server

Caddy використовуватиметься як зворотний проксі для MinIO та автоматично керуватиме SSL-сертифікатами Let's Encrypt. Це значно спрощує налаштування HTTPS.

2.1. Додавання репозиторію Caddy

Для отримання останньої стабільної версії Caddy додамо його офіційний репозиторій.

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https # Встановлюємо необхідні пакети
curl -1s https://dl.cloudsmith.io/public/caddy/stable/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg # Додаємо GPG-ключ
curl -1s https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt | sudo tee /etc/apt/sources.list.d/caddy-stable.list # Додаємо репозиторій

2.2. Встановлення Caddy

Оновимо список пакетів та встановимо Caddy.

sudo apt update # Оновлюємо список пакетів
sudo apt install caddy -y # Встановлюємо Caddy

Caddy буде встановлений як системний сервіс та автоматично запущений. Ви можете перевірити його статус:

sudo systemctl status caddy

3. Відкриття порту MinIO у фаєрволі (UFW)

Тепер, коли MinIO працюватиме, нам потрібно відкрити порт, на якому він слухатиме (за замовчуванням 9000). Caddy проксіюватиме запити на цей порт.

sudo ufw allow 9000/tcp # Дозволяємо доступ до порту MinIO
sudo ufw status # Перевіряємо статус UFW

На цьому етапі все необхідне програмне забезпечення встановлено. Переходимо до конфігурації.

Конфігурація

Тепер, коли MinIO та Caddy встановлені, необхідно налаштувати їх для спільної роботи та забезпечити безпечний доступ через HTTPS.

1. Налаштування змінних середовища MinIO

MinIO використовує змінні середовища для своїх налаштувань, включаючи ключі доступу. Ми створимо файл /etc/minio/minio.conf для зберігання цих змінних.

Важливо: Замініть YOUR_MINIO_ACCESS_KEY та YOUR_MINIO_SECRET_KEY на надійні, довгі та складні значення. Ці ключі використовуватимуться для доступу до вашого сховища!

sudo nano /etc/minio/minio.conf

Додайте наступний вміст:

# MinIO Server Configuration
MINIO_ROOT_USER="YOUR_MINIO_ACCESS_KEY"
MINIO_ROOT_PASSWORD="YOUR_MINIO_SECRET_KEY"
MINIO_VOLUMES="/var/lib/minio" # Каталог для зберігання даних MinIO
MINIO_SERVER_URL="https://minio.your-domain.com" # URL, за яким буде доступний MinIO через Caddy

Збережіть файл (Ctrl+O, Enter, Ctrl+X).

Переконайтеся, що цей файл доступний лише для читання користувачеві minio-user:

sudo chown root:minio-user /etc/minio/minio.conf
sudo chmod 640 /etc/minio/minio.conf

2. Створення Systemd Service для MinIO

Ми створимо системний сервіс, щоб MinIO автоматично запускався при старті сервера та керувався через systemctl.

sudo nano /etc/systemd/system/minio.service

Додайте наступний вміст:

[Unit]
Description=MinIO S3 Compatible Object Storage
Documentation=https://min.io/docs/minio/linux/index.html
Wants=network-online.target
After=network-online.target

[Service]
ExecStart=/usr/local/bin/minio server $MINIO_VOLUMES --console-address ":9001"
EnvironmentFile=/etc/minio/minio.conf # Завантажуємо змінні середовища з нашого файлу
User=minio-user
Group=minio-user
ProtectSystem=full
AmbientCapabilities=CAP_NET_BIND_SERVICE
NoNewPrivileges=true
Restart=always
RestartSec=5s

[Install]
WantedBy=multi-user.target

Збережіть файл (Ctrl+O, Enter, Ctrl+X).

Тепер перезавантажте systemd, увімкніть та запустіть сервіс MinIO:

sudo systemctl daemon-reload # Перезавантажуємо systemd
sudo systemctl enable minio # Вмикаємо автозапуск MinIO при старті системи
sudo systemctl start minio # Запускаємо MinIO
sudo systemctl status minio # Перевіряємо статус MinIO

MinIO має бути запущений і слухати на порту 9000 (API) та 9001 (консоль). Переконайтеся, що у виводі systemctl status minio немає помилок.

3. Налаштування Caddyfile для зворотного проксі та SSL

Caddy проксіюватиме запити з вашого доменного імені на локальний MinIO, автоматично отримуючи та оновлюючи SSL-сертифікати.

Важливо: Переконайтеся, що ваш домен (наприклад, minio.your-domain.com) вказує на IP-адресу вашого VPS у DNS за допомогою A-запису.

sudo nano /etc/caddy/Caddyfile

Замініть існуючий вміст на наступний (замініть minio.your-domain.com на ваш фактичний домен):

minio.your-domain.com {
    reverse_proxy localhost:9000 # Проксіюємо API MinIO
    # Для консолі MinIO (опціонально, якщо потрібна веб-консоль через той самий домен)
    # reverse_proxy /minio-console/ localhost:9001
    # Якщо ви хочете, щоб вся консоль була доступна на окремому піддомені,
    # або просто через інший порт, то це краще налаштувати окремо.
    # Для простоти, ми проксіюємо лише API MinIO на 9000.
    # Консоль MinIO за замовчуванням доступна на порту 9001.
    # Якщо ви хочете її проксіювати через той самий домен, то
    # minio.your-domain.com {
    #     handle /minio-console/ {
    #         reverse_proxy localhost:9001
    #     }
    #     handle / {
    #         reverse_proxy localhost:9000
    #     }
    # }
    # Для простоти та безпеки, можна залишити консоль доступною лише локально або через SSH-тунель
    # або на окремому домені. Тут ми проксіюємо лише API.

    # Додаємо заголовки, необхідні для MinIO
    header Access-Control-Allow-Origin ""
    header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"
    header Access-Control-Allow-Headers "Accept, Authorization, Content-Type, Content-Length, X-Amz-Date, X-Amz-User-Agent, X-Amz-Content-Sha256, X-Amz-SignedHeaders, X-Amz-Signature, X-Minio-Deployment-ID, X-Minio-Identity-Tag, X-Minio-Release"
    header X-Minio-Deployment-ID "MINIO_DEPLOYMENT_ID"
    header X-Minio-Identity-Tag "MINIO_IDENTITY_TAG"
    header X-Minio-Release "MINIO_RELEASE"
}

sudo systemctl reload caddy # Перезавантажуємо Caddy
sudo systemctl status caddy # Перевіряємо статус Caddy

curl -I https://minio.your-domain.com/minio/health/live

HTTP/2 200
server: Caddy
content-length: 0
date: Mon, 01 Jan 2026 12:00:00 GMT

mc alias set myminio https://minio.your-domain.com YOUR_MINIO_ACCESS_KEY YOUR_MINIO_SECRET_KEY --api S3v4

mc mb myminio/myfirstbucket # Створюємо новий бакет
echo "Hello MinIO" > testfile.txt
mc cp testfile.txt myminio/myfirstbucket/ # Завантажуємо файл
mc ls myminio/myfirstbucket # Перевіряємо вміст бакету