Параметры конфигурации

NORA настраивается через переменные окружения, файл config.toml или аргументы командной строки. Переменные окружения имеют наивысший приоритет.

Переменные окружения

Сервер

Переменная	По умолчанию	Описание
`NORA_HOST`	`127.0.0.1`	Адрес привязки
`NORA_PORT`	`4000`	Порт
`NORA_BODY_LIMIT_MB`	`2048`	Максимальный размер тела запроса в МБ
`RUST_LOG`	`info`	Уровень логирования (`debug`, `info`, `warn`, `error`)

Хранилище

Переменная	По умолчанию	Описание
`NORA_STORAGE_MODE`	`local`	Способ хранения: `local` или `s3`
`NORA_STORAGE_PATH`	`data/storage`	Путь локального хранилища
`NORA_STORAGE_S3_URL`	—	Адрес S3-совместимого хранилища
`NORA_STORAGE_BUCKET`	`registry`	Имя S3-бакета

Аутентификация

Переменная	По умолчанию	Описание
`NORA_AUTH_ENABLED`	`false`	Включить аутентификацию
`NORA_AUTH_HTPASSWD_FILE`	`users.htpasswd`	Путь к файлу htpasswd
`NORA_AUTH_TOKEN_STORAGE`	`data/tokens`	Каталог хранения токенов

Подробнее: Руководство по аутентификации.

Ограничения запросов

Переменная	По умолчанию	Описание
`NORA_RATE_LIMIT_ENABLED`	`true`	Включение/отключение ограничений. Для внутренних инсталляций можно отключить
`NORA_RATE_LIMIT_AUTH_RPS`	`1`	Запросов аутентификации в секунду
`NORA_RATE_LIMIT_AUTH_BURST`	`5`	Пиковое число запросов аутентификации
`NORA_RATE_LIMIT_UPLOAD_RPS`	`200`	Запросов загрузки в секунду
`NORA_RATE_LIMIT_UPLOAD_BURST`	`500`	Пиковое число запросов загрузки
`NORA_RATE_LIMIT_GENERAL_RPS`	`100`	Общих запросов в секунду
`NORA_RATE_LIMIT_GENERAL_BURST`	`200`	Пиковое число общих запросов

Подробнее: Ограничения запросов.

Проксирование Docker

Переменная	По умолчанию	Описание
`NORA_DOCKER_UPSTREAMS`	`https://registry-1.docker.io`	Список upstream-реестров через запятую
`NORA_DOCKER_PROXY_TIMEOUT`	`60`	Таймаут запросов к upstream (секунды)

Подробнее: Проксирование Docker.

Секреты

Переменная	По умолчанию	Описание
`NORA_SECRETS_PROVIDER`	`env`	Источник секретов (`env`)
`NORA_SECRETS_CLEAR_ENV`	`false`	Очищать переменные окружения после чтения

config.toml

NORA ищет файл config.toml в текущем каталоге:

[server]
host = 0.0.0.0
port = 4000

[storage]
mode = local
path = data/storage

# S3-хранилище (раскомментируйте для использования)
# mode = s3
# s3_url = https://s3.amazonaws.com
# bucket = my-registry

[auth]
enabled = true
htpasswd_file = users.htpasswd
token_storage = data/tokens

[rate_limit]
enabled = true
auth_rps = 1
auth_burst = 5
upload_rps = 200
upload_burst = 500
general_rps = 100
general_burst = 200

[secrets]
provider = env
clear_env = false

Docker Compose

Пример для рабочей среды:

services:
  nora:
    image: ghcr.io/getnora-io/nora:latest
    ports:
      - 4000:4000
    volumes:
      - nora-data:/data
      - ./users.htpasswd:/data/users.htpasswd:ro
    environment:
      - RUST_LOG=info
      - NORA_HOST=0.0.0.0
      - NORA_PORT=4000
      - NORA_AUTH_ENABLED=true
      - NORA_BODY_LIMIT_MB=4096
    restart: unless-stopped

volumes:
  nora-data:

Конечные точки

Адрес	Описание
`/ui/`	Веб-интерфейс
`/api-docs`	Swagger UI (OpenAPI)
`/health`	Проверка работоспособности
`/ready`	Проверка готовности
`/metrics`	Метрики Prometheus
`/v2/`	Docker Registry v2
`/maven2/`	Maven-репозиторий
`/npm/`	Реестр npm
`/cargo/`	Реестр Cargo
`/simple/`	Индекс PyPI

См. также

Аутентификация — htpasswd, токены, управление доступом
TLS / HTTPS — настройка обратного прокси, незащищённые реестры
Ограничения запросов — тонкая настройка для рабочей среды
Развёртывание — рекомендации по развёртыванию