mirror of
https://github.com/XTLS/Xray-docs-next.git
synced 2025-01-20 17:51:40 +03:00
b8524c7437
* update log.md * update dns.md * update routing.md * update transport.md * update socks.md * update dns.md * update freedom.md * update vless.md * update splithttp.md
66 lines
3.8 KiB
Markdown
66 lines
3.8 KiB
Markdown
# Настройка журнала
|
||
|
||
Настройка журнала управляет тем, как Xray выводит журналы.
|
||
|
||
Xray имеет два типа журналов: журнал доступа и журнал ошибок.
|
||
Вы можете настроить способ вывода каждого типа журнала отдельно.
|
||
|
||
## 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"`.
|
||
|
||
- `"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]`
|