Компания может держать пакеты у себя и пользоваться vibe без изменений. Эта страница нацеливает проект или целую машину на это место, с поисковым каталогом рядом или без него, а публичный оставляет запасным.
Агент выполняет `vibe registry add acme git@github.com:acme-specs --auth ssh --position primary`: команда записывает новый блок [реестра](../glossary/index.xml#registry) в начало списка в [манифесте](../glossary/index.xml#manifest). С этого момента каждое разрешение спрашивает сначала `acme`, потом публичный реестр, а пакет, который есть в обоих, приходит из `acme`. `vibe registry test` проверяет каждый реестр на доступность и аутентификацию, ничего не скачивая.
1. Добавьте реестр в проект. Адрес — корень организации, а не репозиторий пакета:
2. Выберите режим аутентификации флагом `--auth`. Значения: `none` для публичного чтения, `ssh` для ключей и `credential-helper` для системного помощника git. `token-env` читает токен из переменной окружения, названной по хосту.
3. Проверьте командой `vibe registry test`: она сообщает по каждому реестру, ответила ли организация и какую аутентификацию приняла, ничего не скачивая.
Положите тот же блок реестра в `~/.vibe/registry.toml`. Он подмешивается после собственного списка каждого проекта, так что проекты, которые называют свои реестры, ничего не замечают, а проекты без реестров наследуют машинные. Проект, который не называет ни одного реестра, а `vibe init` сегодня создаёт именно такие, пользуется списком машины; так корпоративное умолчание становится умолчанием каждого нового проекта.
Реестр может указывать на пакет, который живёт в другом месте. Вместо пакета репозиторий с его именем несёт один файл, `vibe-redirect.toml`, с таблицей `[redirect]`: `target_url` называет репозиторий, где пакет лежит на самом деле, а `ref_policy` говорит, какой тег там брать: тот же самый по умолчанию или один `pinned_ref` для всех версий. Потребитель, который ставит пакет, разницы не видит; резолвер идёт по указателю один раз, никогда по цепочке, и записывает адрес заглушки в [лок-файл](../glossary/index.xml#lock-file) полем `via_redirect`.
Версии, которые видит потребитель, — это теги заглушки, а не цели: владелец реестра допускает каждую версию, помечая тегом заглушку. `vibe registry redirect` создаёт заглушку, `redirect-sync` после подтверждения копирует в неё теги цели, а `redirect-update` меняет указатель. Когда у заглушки меняется цель, потому что сопровождающий переехал на другой хост, потребитель принимает переезд флагом `--trust-redirect`; молча vibe за изменившейся целью не идёт.
Токен никогда не попадает в файл, который пишет vibe, и никогда не появляется в его выводе. С `--auth token-env` vibe читает его из `VIBEVM_REGISTRY_TOKEN_<HOST>` во время работы и отправляет только по шифрованному соединению. Держите переменную в профиле оболочки или в секретном [хранилище](../glossary/index.xml#store) вашего CI, а не в репозитории.
Приватный реестр без [индекса](../glossary/index.xml#index-registry) всё равно работает: поиск его пропускает, а установка клонирует, что нужно. Добавьте рядом с пакетами репозиторий индекса и укажите на него переменной `VIBEVM_INDEX_URL_ACME`, чтобы поиск и холодные установки стали быстрыми.
[Зеркало](../glossary/index.xml#mirror) — не второй реестр. Для альтернативного адреса тех же пакетов, проверяемых по тем же [отпечаткам](../glossary/index.xml#fingerprint), используйте `vibe registry set-mirror`; для другого источника пакетов — `registry add`.
В скрипте, который должен заметить, что приватный реестр лежит, передайте `vibe install` флаг `--auth-required`: тогда ошибка аутентификации останавливает установку, вместо того чтобы идти дальше к публичному запасному.