mirror of
https://github.com/XTLS/Xray-docs-next.git
synced 2025-02-12 12:39:25 +03:00
78 lines
5.3 KiB
Markdown
78 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]`
|