Операционная система
Linux (glibc 2.31+), macOS 13+ или Windows Server 2019. Минимум 2 ГБ оперативной памяти и 40 ГБ свободного места под каталог кэша.
Быстрый старт · 90 секунд
Начните элегантно.
Четыре шага отделяют вас от работающего узла PkgMirror. Никаких конфигурационных файлов, никаких очередей на доступ — только одна команда и первый синхронизированный артефакт.
90 сек
до первого hit
01 · Предварительные требования
Подготовьте окружение
PkgMirror не требует отдельной инфраструктуры. Узел встраивается в существующий хост и начинает обслуживать запросы сразу после инициализации.
Для запуска достаточно трёх условий: доступная операционная система, стабильное сетевое соединение и учётные данные вашего реестра. Всё остальное — ключи, каталог кэша и политики доступа — создаётся автоматически при первом запуске.
Если вы работаете в кластере, убедитесь, что порт 8443 открыт между узлами. Для одиночного узла наружу достаточно только порт 443 для внешнего контура.
Сетевой доступ
Исходящий доступ к публичным источникам пакетов и обратный канал на порт 8443 для меж-узлового обмена. TLS-сертификат генерируется автоматически.
Учётные данные
API-ключ вашего приватного реестра и токен глобального слоя. Передаются через переменные окружения — в файлах не хранятся.
02 · Установка в одну строку
Одна команда — и узел готов
Скрипт установки скачивает бинарь, генерирует ключи, создаёт каталог кэша и регистрирует узел в глобальной сети. Весь процесс занимает около 40 секунд.
curl | bash
curl -sSL https://get.pkgmirror.io | bash -s -- --region eu-central --registry mycorp. Скрипт определит архитектуру, установит бинарь в /usr/local/bin и запустит сервис.
PowerShell
iwr https://get.pkgmirror.io/install.ps1 | iex. Установка создаёт службу Windows и регистрирует её в диспетчере. Перезагрузка не требуется.
Контейнер
docker run -p 8443:8443 -v pkgmirror-cache:/cache ghcr.io/pkgmirror/node:2.4.1. Идеально для оркестраторов и CI-песочниц.
03 · Первый синхронизированный пакет
Первый hit за 4 секунды
Как только узел зарегистрирован, он начинает прозрачно кэшировать все входящие запросы. Первый артефакт из публичного источника попадает в локальный кэш почти мгновенно.
Откройте любой терминал и выполните стандартный запрос к вашему пакетному менеджеру. PkgMirror перехватит запрос, загрузит артефакт из публичного источника и сохранит его в каталог /var/lib/pkgmirror/cache с подписью и хэшем.
Повторный запрос того же пакета — уже из локального кэша. Вы увидите сокращение времени ответа с десятков секунд до миллисекунд.
4.2 с
Первый hit (cold)
3.8 мс
Повторный hit (warm)
0
Изменений в pipeline
SHA-256
Подпись каждого артефакта
04 · Проверка работоспособности
Убедитесь, что всё на месте
Три команды подтверждают, что узел зарегистрирован, кэш активен и подписи артефактов проходят проверку. Это занимает меньше минуты.
pkgmirror status
Показывает идентификатор узла, регион, версию ядра и время последней синхронизации с глобальным слоем. Ожидаемый результат: status: healthy · region: eu-central · last-sync: 2s ago.
pkgmirror cache list
Выводит каталог кэшированных артефактов с размером, хэшем и временем последнего доступа. После первого запроса вы увидите строку вида lodash@4.17.21 · 248 КБ · sha256:9f2….
pkgmirror verify --all
Пересчитывает SHA-256 всех артефактов в кэше и сверяет с подписями. Если хотя бы один байт изменён — команда вернёт ненулевой код и укажет конкретный файл.
Готовы к работе
Ваш узел уже в сети.
Если все три проверки пройдены — PkgMirror обслуживает ваш трафик. Подключите CI, направьте запросы и наблюдайте, как время сборки сокращается в разы.