Перейти к содержанию

Конфигурация

Эта страница описывает конфигурационные входные данные и где xp2p их ищет. Про строгие правила apply в стиле «желаемые входные данные → live-артефакты» см. Apply flow и Config compilation.

Корень конфигурации

По умолчанию xp2p использует XP2P_CONFIG_ROOT, если переменная задана. Иначе используются значения по умолчанию для платформы (например /etc/xp2p на Linux/OpenWrt).

Порядок загрузки (CLI)

Когда команда загружает конфигурацию, она объединяет настройки в таком порядке:

  1. Встроенные значения по умолчанию
  2. Опциональные конфигурационные файлы
  3. Переменные окружения
  4. Переопределения из CLI

По умолчанию xp2p загружает xp2p-client.toml и xp2p-server.toml из корня конфигурации; переопредели через --config path/to/file. Поддерживаются TOML и YAML.

Настройки сопоставляются 1:1 с переменными окружения через префикс XP2P_ (XP2P_SERVER_INSTALL_DIR, XP2P_CLIENT_SERVER_ADDRESS и т.д.). Пример файла лежит в config_templates/xp2p.example.yaml.

Глобальные флаги

У всех команд есть общие глобальные флаги: --config, --log-level (debug|info|warn|error), --log-json, --version.

Расширенные опции / устранение неполадок:

  • Переопредели путь к файлу конфигурации через --config path/to/file для одноразового запуска.
  • На Windows xp2p client|server service start --log-level <level> может сохранить XP2P_LOG_LEVEL в окружение сервиса для рабочих процессов. Пакеты и сервисы всё равно запускаются с параметрами по умолчанию.

Проверка версии Xray

Перед запуском проверок в рантайме валидируется закреплённая версия xray. Переопределение:

  • XP2P_XRAY_SKIP_VERSION_CHECK=1 (пропустить проверку)
  • XP2P_XRAY_ALLOW_MISMATCH=1 (вывести предупреждение и продолжить при несовпадении)