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

Статья 132 из 141

Гайды

MinIO на VPS в 2026: своё S3-хранилище в Docker, бакеты, ключи доступа и rclone

MinIO — сервер объектного хранилища с API, совместимым с Amazon S3. На своём VPS он нужен, чтобы складывать бэкапы, файлы приложений и статику туда, куда умеют писать почти все программы: restic, rclone, Nextcloud, GitLab, бэкап-плагины WordPress.

Перед установкой прочитайте раздел о статусе проекта. С 2025 года бесплатная версия MinIO сильно изменилась.

Факты по официальному репозиторию minio/minio на GitHub:

Дата Что изменилось
май 2025 Веб-консоль урезана до файлового браузера (Object Browser). Управление пользователями, политиками, ключами и вход через LDAP/OIDC убраны из бесплатной версии и перенесены в коммерческий продукт AIStor
октябрь 2025 Последний релиз RELEASE.2025-10-15T17-29-55Z. Проект перешёл на распространение только исходным кодом: готовых бинарников и Docker-образов больше нет
декабрь 2025 Режим поддержки: без новых функций
25 апреля 2026 Репозиторий minio/minio архивирован, он только для чтения
14 июля 2026 Архивирован клиент minio/mc

Что это значит на практике:

  • Образы minio/minio с Docker Hub и quay.io/minio/minio больше не скачиваются. На 18 ноября 2026 docker pull для обоих возвращает ошибку доступа.
  • Код по-прежнему под лицензией AGPL v3, его можно собрать самому. Обновлений безопасности больше не будет.
  • Версии до RELEASE.2025-10-15T17-29-55Z содержат уязвимость CVE-2025-62506 (обход ограничений сервисных аккаунтов). Если у вас осталась старая MinIO из образа 2025 года, она уязвима.
  • Официальная замена от разработчиков — MinIO AIStor. У него есть бесплатный уровень (Free) для одного сервера, но нужен лицензионный ключ, который выдают после регистрации на сайте min.io. Образ: quay.io/minio/aistor/minio.

Для нового проекта на VPS выбирайте осознанно: AIStor Free с лицензией, другой S3-совместимый сервер или сборку последней MinIO Community, если она нужна для совместимости. Ниже третий вариант: мы проверили его на тестовом сервере.

Ресурс Значение
RAM от 1 ГБ. На тесте MinIO занимала около 340 МБ
vCPU 1–2. Сборка образа занимает 2–3 минуты
Диск сколько нужно под данные. Образ около 350 МБ
Софт Docker и Compose
Домен например s3.example.com для API и minio.example.com для консоли (DNS)
Окно терминала
mkdir -p /opt/minio && cd /opt/minio
nano Dockerfile
FROM golang:1.25 AS build
ARG MINIO_TAG=RELEASE.2025-10-15T17-29-55Z
RUN git clone --depth 1 --branch ${MINIO_TAG} https://github.com/minio/minio.git /src
WORKDIR /src
RUN CGO_ENABLED=0 go build -tags kqueue -trimpath -ldflags "$(go run buildscripts/gen-ldflags.go)" -o /out/minio .
RUN CGO_ENABLED=0 GOBIN=/out go install github.com/minio/mc@latest
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl \
&& rm -rf /var/lib/apt/lists/*
COPY --from=build /out/minio /out/mc /usr/local/bin/
EXPOSE 9000 9001
ENTRYPOINT ["minio"]

Образ собирает сервер из последнего тега и кладёт рядом клиент mc. Он понадобится для пользователей и ключей, потому что в консоли этого больше нет.

Логин и пароль администратора (root user) храните в .env:

Окно терминала
cat > .env <<EOF
MINIO_ROOT_USER=admin-$(openssl rand -hex 3)
MINIO_ROOT_PASSWORD=$(openssl rand -hex 20)
EOF
chmod 600 .env
cat .env

docker-compose.yml:

services:
minio:
build: .
image: minio-local:RELEASE.2025-10-15T17-29-55Z
restart: unless-stopped
command: server /data --console-address ":9001"
env_file: .env
environment:
MINIO_BROWSER_REDIRECT_URL: "https://minio.example.com"
ports:
- "127.0.0.1:9000:9000"
- "127.0.0.1:9001:9001"
volumes:
- ./data:/data
Окно терминала
docker compose build
docker compose up -d
docker compose exec minio minio --version
curl -s -o /dev/null -w '%{http_code}\n' 127.0.0.1:9000/minio/health/live

Последняя команда должна вывести 200.

Порты:

Порт Что это
9000 S3 API: сюда подключаются программы и mc
9001 веб-консоль (Object Browser)

Оба слушают только 127.0.0.1. Наружу их выпускает Nginx с HTTPS.

Для API и консоли нужны два поддомена. Пример для API:

server {
listen 80;
server_name s3.example.com;
client_max_body_size 0;
proxy_buffering off;
proxy_request_buffering off;
location / {
proxy_pass http://127.0.0.1:9000;
proxy_http_version 1.1;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}

client_max_body_size 0 снимает ограничение на размер загрузки. Host $http_host обязателен: S3-подписи запросов проверяют имя хоста. Для консоли сделайте такой же блок с server_name minio.example.com и proxy_pass http://127.0.0.1:9001, добавьте заголовки Upgrade и Connection "upgrade". Затем выпустите сертификаты: Let’s Encrypt, подробнее о Nginx.

Войдите на https://minio.example.com с MINIO_ROOT_USER и MINIO_ROOT_PASSWORD.

Страница входа MinIO Community Edition

При первом входе консоль показывает текст лицензии AGPL v3, нажмите Acknowledge. В урезанной консоли доступно:

  • Create Bucket: создать бакет;
  • просмотр, загрузка (Upload), скачивание и удаление объектов;
  • Rewind: просмотр прошлых версий, если для бакета включено версионирование.

Создание бакета в консоли MinIO

Содержимое бакета в Object Browser

Пользователей, политики, ключи доступа, квоты и настройки сервера консоль больше не показывает. Всё это делается через mc.

Не давайте программам root-логин. Создайте отдельного пользователя с доступом к одному бакету.

Окно терминала
cd /opt/minio
docker compose exec minio sh

Внутри контейнера:

Окно терминала
mc alias set local http://127.0.0.1:9000 "$MINIO_ROOT_USER" "$MINIO_ROOT_PASSWORD"
mc mb local/backups
cat > /tmp/backups-rw.json <<'EOF'
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket", "s3:GetBucketLocation"],
"Resource": ["arn:aws:s3:::backups"]
},
{
"Effect": "Allow",
"Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
"Resource": ["arn:aws:s3:::backups/*"]
}
]
}
EOF
mc admin policy create local backups-rw /tmp/backups-rw.json
mc admin user add local backup-user ДЛИННЫЙ_ПАРОЛЬ
mc admin policy attach local backups-rw --user backup-user
mc admin accesskey create local/ backup-user

Последняя команда выведет Access Key и Secret Key. Секрет показывается один раз, сохраните его. Список ключей: mc admin accesskey ls local/ backup-user.

На тесте пользователь с такой политикой читал и писал в backups, а попытка записать в другой бакет вернула «Insufficient permissions».

Конфиг ~/.config/rclone/rclone.conf на машине, откуда вы шлёте файлы:

[minio]
type = s3
provider = Minio
access_key_id = ВАШ_ACCESS_KEY
secret_access_key = ВАШ_SECRET_KEY
endpoint = https://s3.example.com
no_check_bucket = true
Окно терминала
rclone copy /var/backups/db.sql.gz minio:backups/2026-11-18/
rclone ls minio:backups

no_check_bucket = true обязателен для пользователя без прав на создание бакетов. Без него rclone перед загрузкой пытается создать бакет и получает AccessDenied. Мы проверили это на rclone 1.76.

Для mc на другой машине: mc alias set remote https://s3.example.com ВАШ_ACCESS_KEY ВАШ_SECRET_KEY. Клиент тоже архивирован, но работает. Подробнее о стратегии копий: бэкапы.

Данные лежат в /opt/minio/data в собственном формате MinIO. Копировать эту папку можно только при остановленном контейнере. Надёжнее зеркалировать бакеты на другой сервер или в другое хранилище: rclone sync minio:backups другое-хранилище:backups.

Симптом Причина и решение
pull access denied for minio/minio Официальные образы больше не публикуются. Соберите образ из исходников, как выше
В консоли нет пользователей и ключей Так устроена Community Edition с мая 2025. Используйте mc admin
rclone: CreateBucket ... AccessDenied Добавьте no_check_bucket = true в конфиг rclone
SignatureDoesNotMatch через Nginx Прокси меняет заголовок Host. Нужен proxy_set_header Host $http_host
Ошибка 413 при загрузке больших файлов В Nginx не задан client_max_body_size 0
После входа консоль перекидывает на внутренний адрес Не задан MINIO_BROWSER_REDIRECT_URL с вашим HTTPS-адресом консоли