Настройка журнала
Настройка журнала управляет тем, как 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]