Статья 132 из 141
Гайды
MinIO на VPS в 2026: своё S3-хранилище в Docker, бакеты, ключи доступа и rclone
MinIO — сервер объектного хранилища с API, совместимым с Amazon S3. На своём VPS он нужен, чтобы складывать бэкапы, файлы приложений и статику туда, куда умеют писать почти все программы: restic, rclone, Nextcloud, GitLab, бэкап-плагины WordPress.
Перед установкой прочитайте раздел о статусе проекта. С 2025 года бесплатная версия MinIO сильно изменилась.
Что произошло с MinIO Community Edition
Заголовок раздела «Что произошло с MinIO Community Edition»Факты по официальному репозиторию 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 ноября 2026docker 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/minionano DockerfileFROM golang:1.25 AS buildARG MINIO_TAG=RELEASE.2025-10-15T17-29-55ZRUN git clone --depth 1 --branch ${MINIO_TAG} https://github.com/minio/minio.git /srcWORKDIR /srcRUN 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-slimRUN 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 9001ENTRYPOINT ["minio"]Образ собирает сервер из последнего тега и кладёт рядом клиент mc. Он понадобится для пользователей и ключей, потому что в консоли этого больше нет.
Логин и пароль администратора (root user) храните в .env:
cat > .env <<EOFMINIO_ROOT_USER=admin-$(openssl rand -hex 3)MINIO_ROOT_PASSWORD=$(openssl rand -hex 20)EOFchmod 600 .envcat .envdocker-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:/datadocker compose builddocker compose up -ddocker compose exec minio minio --versioncurl -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.
Nginx и HTTPS
Заголовок раздела «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.

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


Пользователей, политики, ключи доступа, квоты и настройки сервера консоль больше не показывает. Всё это делается через mc.
Пользователь и ключи через mc
Заголовок раздела «Пользователь и ключи через mc»Не давайте программам root-логин. Создайте отдельного пользователя с доступом к одному бакету.
cd /opt/miniodocker compose exec minio shВнутри контейнера:
mc alias set local http://127.0.0.1:9000 "$MINIO_ROOT_USER" "$MINIO_ROOT_PASSWORD"mc mb local/backupscat > /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/*"] } ]}EOFmc admin policy create local backups-rw /tmp/backups-rw.jsonmc admin user add local backup-user ДЛИННЫЙ_ПАРОЛЬmc admin policy attach local backups-rw --user backup-usermc admin accesskey create local/ backup-userПоследняя команда выведет Access Key и Secret Key. Секрет показывается один раз, сохраните его. Список ключей: mc admin accesskey ls local/ backup-user.
На тесте пользователь с такой политикой читал и писал в backups, а попытка записать в другой бакет вернула «Insufficient permissions».
Подключение через rclone
Заголовок раздела «Подключение через rclone»Конфиг ~/.config/rclone/rclone.conf на машине, откуда вы шлёте файлы:
[minio]type = s3provider = Minioaccess_key_id = ВАШ_ACCESS_KEYsecret_access_key = ВАШ_SECRET_KEYendpoint = https://s3.example.comno_check_bucket = truerclone copy /var/backups/db.sql.gz minio:backups/2026-11-18/rclone ls minio:backupsno_check_bucket = true обязателен для пользователя без прав на создание бакетов. Без него rclone перед загрузкой пытается создать бакет и получает AccessDenied. Мы проверили это на rclone 1.76.
Для mc на другой машине: mc alias set remote https://s3.example.com ВАШ_ACCESS_KEY ВАШ_SECRET_KEY. Клиент тоже архивирован, но работает. Подробнее о стратегии копий: бэкапы.
Бэкап самой MinIO
Заголовок раздела «Бэкап самой MinIO»Данные лежат в /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-адресом консоли |