mirror of
https://github.com/XTLS/Xray-docs-next.git
synced 2026-09-26 00:08:03 +03:00
79 lines
5.3 KiB
Markdown
79 lines
5.3 KiB
Markdown
# Настройка журнала
|
|
|
|
Настройка журнала управляет тем, как Xray выводит журналы.
|
|
|
|
Xray имеет два типа журналов: журнал доступа и журнал ошибок.
|
|
Вы можете настроить способ вывода каждого типа журнала отдельно.
|
|
|
|
::: tip
|
|
Настройки логирования применяются не сразу. Поэтому в процессе запуска вы можете увидеть записи от несконфигурированного логгера. Например, могут появиться сообщения уровня `"info"`, даже если вы установили уровень логирования `"warning"`.
|
|
:::
|
|
|
|
## LogObject
|
|
|
|
LogObject соответствует полю `log` в конфигурационном файле.
|
|
|
|
```json
|
|
{
|
|
"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.
|
|
|
|
::: tip
|
|
|
|
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]`
|