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

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

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

Подсказка

Настройки логирования применяются не сразу. Поэтому в процессе запуска вы можете увидеть записи от несконфигурированного логгера. Например, могут появиться сообщения уровня "info", даже если вы установили уровень логирования "warning".

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". Обратите внимание, что этот параметр применяется только к журналу ошибок. Он не влияет на журнал доступа (за исключением значения "none"). Журнал доступа не имеет уровней логирования.

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

dnsLog: bool

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

Подсказка

  1. Xray не выполняет все DNS-запросы через свои встроенные клиенты. Поэтому включение этой опции не означает, что все DNS-запросы, выполняемые Xray, будут записаны в журнал.

  2. DNS-запросы, сделанные встроенными DNS-клиентами, также записываются в журнал ошибок (с уровнем "Info") даже если эта опция отключена.

  3. Запросы клиента FakeDNS никогда не записываются в журнал доступа.

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

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

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

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