OpenRepoУстановка

НАСТРОЙКА / ПЕРВЫЙ ЗАПУСК

Подготовьте установку без скрытых значений.

Параметры ниже относятся к комплекту Docker Compose для нового одноузлового стенда. Это не полная справка всех настроек OpenRepo.

Обязательные значения .env

ИмяНазначениеТребование
OPENREPO_DEMO_PROJECTНеизменное имя проекта Docker Compose и его именованных томов.Уникально для новой установки; смена имени создаёт другой набор данных.
OPENREPO_DEMO_IMAGEОбраз OpenRepo.Только точная ссылка registry/repository@sha256:… из подписанного манифеста выпуска.
OPENREPO_DEMO_DB_PASSWORDПароль отдельной базы PostgreSQL.Значение, безопасное для URL; не переиспользуйте пароль администратора.
OPENREPO_DEMO_ADMIN_PASSWORDНачальный пароль первого администратора.Смените после первого входа. Перезапуск с этим значением не сбрасывает пароль активированной учетной записи.
OPENREPO_DEMO_MASTER_KEYКлюч AES для шифрования сохранённых секретов.Ровно 64 шестнадцатеричных символа; храните вместе с резервными копиями и не меняйте при перезапуске.
OPENREPO_DEMO_DOMAINПубличное DNS-имя для Caddy и OPENREPO_PUBLIC_URL.Только имя узла без схемы, порта и пути.

Комплект конкретной версии должен содержать точную ссылку на образ в .env.example. Контрольную сумму образа не требуется переносить из текста страницы вручную.

Создайте секреты локально

Выполняйте команды на сервере в интерактивной оболочке Bash. Они выводят новые значения в текущий терминал и ничего не отправляют на сайт. Сохраните значения в принятом в организации хранилище секретов, затем внесите их в .env.

openssl rand -hex 32
openssl rand -hex 24
openssl rand -hex 24

Первая строка создаёт 64-символьный мастер-ключ; вторая — пароль базы данных, безопасный для URL; третья — начальный пароль администратора. Не помещайте реальные значения в задачи, снимки экрана, историю команд или репозиторий. Файл .env должен иметь режим 0600.

Мастер-ключ — часть данных.

Потеря ключа делает сохранённые учетные данные прокси, секреты OIDC и другие зашифрованные значения нечитаемыми. Новый ключ не расшифрует старые данные.

Сеть и TLS

ИсточникНазначениеПротоколУсловие
Пользователи и CICaddyTCP 443Веб-интерфейс, API и клиенты пакетов.
ИнтернетCaddyTCP 80/443Только для проверки ACME HTTP и автоматического выпуска сертификата.
Клиент HTTP/3CaddyUDP 443Необязательно для обычного HTTPS.
OpenRepoПубличные реестрыTCP 443Для получения отсутствующего пакета и обновления метаданных.
OpenRepoСлужба лицензированияTCP 443Для активации пробной лицензии и продления подписанного подтверждения.

PostgreSQL, Valkey и порт приложения не публикуются в пользовательскую сеть. В Docker Compose приложение доступно на 127.0.0.1:8081 для локальной проверки, а внешний доступ проходит через Caddy. Не используйте curl --insecure как исправление TLS.

Постоянные данные

  • postgres-data — метаданные, учетные записи, идентификатор установки и состояние лицензии;
  • valkey-data — постоянный кеш и данные сеансов этого профиля;
  • openrepo-data — двоичные файлы, резервные копии и рабочие кеши;
  • caddy-data и caddy-config — состояние TLS.

Не выполняйте docker compose down -v в эксплуатации. Смена имени проекта выбирает другой набор томов и может выглядеть как пустая установка. Копия на том же хранилище не является аварийной резервной копией.

Первый административный вход

  1. Проверьте готовность приложения.

    Используйте команду со страницы установки.

  2. Откройте окончательный адрес HTTPS.

    Войдите начальной учетной записью администратора и смените пароль.

  3. Войдите повторно.

    Уведомление об успешной смене не заменяет проверку нового входа.

  4. Проверьте лицензию.

    На странице /system/status найдите идентификатор установки и состояние лицензии. Для пробной лицензии продолжите по отдельной процедуре.