Docker registry proxy на личном VPS в 2026

Чтобы развернуть docker registry proxy на своём сервере, вам нужен личный VPS с внешним IP и возможность запускать Docker. С SANSARA вы получаете готовый личный VPS в одной из 9+ стран, подключаете его через кабинет или Telegram-бота SANSARA, затем запускаете прокси-контейнер для ускорения и кеширования образов из публичных реестров. Настройка займёт несколько минут и не требует работы в терминале — всё делается через клиенты на iPhone, Android, Windows и macOS.

Коротко:

• Docker registry proxy — это промежуточный сервер, который кеширует образы из Docker Hub и других реестров, ускоряя повторные загрузки и снижая зависимость от внешних лимитов.
• На личном VPS SANSARA вы получаете выделенный узел с внешним IP и полным контролем над контейнерами.
• Настройка сводится к запуску одного контейнера-прокси с указанием внешнего реестра и порта.
• Клиенты на iPhone, Android, Windows и macOS подключаются к вашему прокси через импорт конфигурации из кабинета SANSARA или через Telegram-бота.
• Прокси полезен командам разработки, CI/CD-системам и всем, кто часто перетаскивает одни и те же образы.

Что это и кому подходит

Docker registry proxy — это сервис, который работает как промежуточный слой между вашими Docker-клиентами и удалённым реестром (например, Docker Hub). Когда клиент запрашивает образ, прокси сначала проверяет свой локальный кеш. Если образ уже есть — отдаёт его быстро, без повторной загрузки из интернета. Если нет — скачивает из внешнего реестра, сохраняет у себя и передаёт клиенту.

Основные преимущества:

• Ускорение сборок и развёртываний — повторные docker pull выполняются из локального кеша.
• Снижение нагрузки на внешние реестры — меньше рисков упереться в лимиты по запросам.
• Контроль доступа — можно ограничить, какие образы и кому доступны.
• Географическая близость — если ваш VPS расположен ближе к команде или CI-серверам, задержки уменьшаются.

Прокси подходит:

• Командам разработки, которые часто используют одни и те же базовые образы.
• CI/CD-системам, где много параллельных сборок тянут одинаковые образы.
• Организациям, которые хотят меньше зависеть от доступности публичных реестров.
• Пользователям SANSARA, которые хотят использовать свой личный VPS не только для защищённого канала, но и как инфраструктурный узел.

Сравнение подходов:

Как настроить по шагам (с личным VPS SANSARA)

Настройка docker registry proxy на личном VPS SANSARA состоит из трёх этапов: получение сервера, запуск прокси-контейнера и настройка клиентов.

1. Получите личный VPS в SANSARA

• Зарегистрируйтесь в SANSARA, выберите тариф с личным VPS.
• В кабинете выберите одну из 9+ доступных стран — ту, которая ближе к вашей команде или CI-инфраструктуре.
• Активируйте сервер. Данные для подключения появятся в кабинете: адрес сервера, логин, пароль (или ключ), а также готовая конфигурация для импорта в клиенты.

Если вы предпочитаете мобильные устройства, используйте Telegram-бота SANSARA: он поможет выбрать локацию, создать сервер и отправит готовую конфигурацию для импорта.

2. Запустите прокси-контейнер на VPS

Для примера используем популярный прокси для Docker Hub — registry:2 в режиме mirror или специализированный прокси-образ вроде registry:2 с настройкой proxy. Конкретные образы могут меняться к 2026 году, но логика остаётся той же.

Пример команды для запуска прокси, который зеркалирует Docker Hub:

`bash docker run -d \ --name registry-proxy \ -p 5000:5000 \ -e REGISTRY_PROXY_REMOTEURL=https://registry-1.docker.io \ -v /path/to/registry-data:/var/lib/registry \ registry:2 `

Что здесь происходит:

• --name registry-proxy — называем контейнер для удобства.
• -p 5000:5000 — публикуем порт 5000 контейнера на порт 5000 VPS.
• -e REGISTRY_PROXY_REMOTEURL=... — указываем внешний реестр (Docker Hub).
• -v /path/to/registry-data:/var/lib/registry — монтируем том для хранения кешированных образов.

После запуска ваш прокси будет доступен по адресу http://ВАШ_VPS_IP:5000 (или https, если настроите TLS).

3. Настройте Docker-клиенты на работу через прокси

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

Пример настройки daemon.json на Linux-сервере:

`json { "registry-mirrors": ["http://ВАШ_VPS_IP:5000"] } `

После перезагрузки демона Docker будет пытаться брать образы сначала из вашего прокси, а если их там нет — из Docker Hub.

На стороне CI-серверов или рабочих станций настройка аналогична: вы указываете адрес вашего прокси в конфигурации Docker.

Устройства: iPhone, Android, Windows, macOS

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

iPhone и Android

• Установите подходящий клиент для работы с личным сервером (например, стандартные клиенты для защищённых каналов).
• В кабинете SANSARA скопируйте готовую конфигурацию для мобильного устройства или получите её через Telegram-бота SANSARA.
• Импортируйте конфигурацию в клиент. После подключения все запросы к Docker-реестрам, идущие через этот канал, будут проходить через ваш VPS с запущенным прокси.

Windows и macOS

• Скачайте и установите клиент для вашей ОС.
• Импортируйте конфигурацию из кабинета SANSARA или через Telegram-бота.
• Запустите подключение. Теперь вы можете работать с Docker (если он установлен) так, будто находитесь в сети вашего VPS, и использовать ваш registry proxy.

Важно: сам Docker обычно не ставится на мобильные устройства, но если вы используете удалённые серверы или CI-системы, которые находятся «за» вашим личным VPS, то все их запросы к реестрам тоже будут идти через прокси.

Частые ошибки и как их избежать

1. 01Прокси не стартует из-за занятого порта

Если порт 5000 уже занят другим сервисом, Docker выдаст ошибку. Проверьте, что порт свободен (netstat -tulpn | grep :5000 на Linux) или измените порт в команде запуска, например -p 5001:5000.

1. 01Клиенты не могут подключиться к прокси

Убедитесь, что:

• На VPS открыт нужный порт в файрволе.
• В конфигурации клиентов указан правильный IP и порт прокси.
• Прокси запущен (docker ps показывает registry-proxy).

1. 01Образы всё равно качаются мимо прокси

Проверьте настройки registry-mirrors в daemon.json. После изменения файла перезапустите Docker демон. Также убедитесь, что вы не используете явно другой реестр в командах (docker pull registry.example.com/image будет идти мимо mirror).

1. 01Нехватка места на диске для кеша

Прокси хранит все скачанные образы локально. Если вы кешируете много крупных образов, выделите достаточно места в томе (-v /большой/диск/registry-data:/var/lib/registry) и следите за занятым местом.

1. 01Отсутствие TLS и ошибки безопасности

По умолчанию прокси может работать по HTTP. В продакшне рекомендуется настроить TLS-сертификат и использовать HTTPS. Иначе некоторые клиенты могут отказываться работать с «небезопасным» реестром.

FAQ

Итог

• Получите личный VPS в SANSARA в подходящей локации и запустите на нём Docker-контейнер с registry proxy, указав внешний реестр и порт.
• Настройте Docker-клиенты на CI-серверах и рабочих станциях так, чтобы они использовали ваш прокси как mirror для ускорения загрузок.
• Подключитесь к своему VPS с iPhone, Android, Windows или macOS через импорт конфигурации из кабинета SANSARA или через Telegram-бота, чтобы весь трафик к реестрам шёл через ваш защищённый канал.
• Выделите достаточно дискового пространства для кеша образов и настройте TLS, если планируете использовать прокси в продакшне.
• Используйте прокси для снижения нагрузки на публичные реестры и ускорения повторных развёртываний, сохраняя полный контроль над инфраструктурой на своём личном сервере.