Настройка журнала

Настройка журнала управляет тем, как Xray выводит журналы.

Xray имеет два типа журналов: журнал доступа и журнал ошибок.
Вы можете настроить способ вывода каждого типа журнала отдельно.

LogObject

LogObject соответствует полю log в конфигурационном файле.

{
  "log": {
    "access": "путь/к/файлу",
    "error": "путь/к/файлу",
    "loglevel": "warning",
    "dnsLog": false,
    "maskAddress": ""
  }
}

access: string

Путь к файлу журнала доступа.
Значение должно быть допустимым путем к файлу, например "/var/log/Xray/access.log" (Linux) или "C:\\Temp\\Xray\\_access.log" (Windows).
Если этот параметр не указан или имеет пустое значение, журнал выводится в stdout.

  • Специальное значение none отключает журнал доступа.

error: string

Путь к файлу журнала ошибок.
Значение должно быть допустимым путем к файлу, например "/var/log/Xray/error.log" (Linux) или "C:\\Temp\\Xray\\_error.log" (Windows).
Если этот параметр не указан или имеет пустое значение, журнал выводится в stdout.

  • Специальное значение none отключает журнал ошибок.

loglevel: "debug" | "info" | "warning" | "error" | "none"

Уровень журнала ошибок, указывающий, какую информацию следует записывать в журнал ошибок.
Значение по умолчанию - "warning".

  • "debug": информация, используемая при отладке программы.
    Включает всю информацию уровня "info".
  • "info": информация о состоянии во время выполнения и т.д., не влияющая на нормальную работу.
    Включает всю информацию уровня "warning".
  • "warning": информация, выводимая при возникновении проблем, не влияющих на нормальную работу, но которые могут повлиять на работу пользователя.
    Включает всю информацию уровня "error".
  • "error": Xray столкнулся с проблемой, которая не позволяет ему работать нормально, и ее необходимо немедленно решить.
  • "none": не записывать ничего.

dnsLog: bool

Включить ведение журнала DNS-запросов, например: DOH//doh.server got answer: domain.com -> [ip1, ip2] 2.333ms.

maskAddress: "quarter" | "half" | "full"

Маскировка IP-адресов. При включении автоматически заменяет IP-адреса, встречающиеся в логах, для защиты конфиденциальности при совместном использовании логов. По умолчанию не включено.

В настоящее время доступны следующие уровни маскировки: quarter, half, full. Соответствующие форматы маскировки:

  • ipv4 1.2.*.* 1.*.*.* [Masked IPv4]
  • ipv6 1234:5678::/32 1234::/16 [Masked IPv6]