Xray-core: Add Lua script for dns and routing

https://github.com/XTLS/Xray-core/pull/6823
2026-10-12 17:28:16 +03:00 · 2026-10-11 09:55:19 +08:00
parent 4c8f3b2b7e
commit f179efd35d
48 changed files with 4950 additions and 0 deletions
@@ -0,0 +1,69 @@
+# xray.log
+
+Записывает сообщения в систему журналирования Xray.
+
+```lua
+local log = require("xray.log")
+```
+
+## Указатель API
+
+| Категория | Член API                           | Описание                 |
+| --------- | ---------------------------------- | ------------------------ |
+| Функция   | [`log.Debug(...)`](#log-debug)     | Запись сообщения debug   |
+| Функция   | [`log.Info(...)`](#log-info)       | Запись сообщения info    |
+| Функция   | [`log.Warning(...)`](#log-warning) | Запись сообщения warning |
+| Функция   | [`log.Error(...)`](#log-error)     | Запись сообщения error   |
+
+## Функции
+
+### log.Debug
+
+```lua
+log.Debug(...)
+```
+
+Записывает сообщение уровня `debug`.
+
+**Параметры**
+
+| Параметр | Тип                | Описание / Требования                                        |
+| -------- | ------------------ | ------------------------------------------------------------ |
+| `...`    | Любое значение Lua | Необязательны; любое число значений, объединяемых по порядку |
+
+**Возвращаемые значения**
+
+Нет возвращаемых значений.
+
+**Преобразование аргументов**
+
+Допускается вызов без аргументов, а также `nil`, `""`, `{}` и пустые срезы. Аргументы преобразуются в текст и объединяются по порядку без автоматической вставки пробелов или разделителей.
+
+- Значения [`error`](./data-types.md#error) в первую очередь преобразуются в сообщения об ошибках.
+- Для остальных значений с функцией `__tostring` используется это преобразование; исключения из него передаются вызывающему коду.
+- Остальные значения используют строковое представление по умолчанию. `nil` становится `"nil"`, пустая строка не добавляет текст; таблицы и срезы не разворачиваются в списки элементов.
+
+**Условия вывода**
+
+Сообщения имеют префикс с именем файла вызывающего скрипта. Вывод зависит от [`log.loglevel`](../../../config/log.md#logobject). Например, при уровне `warning` функции `Debug` и `Info` ничего не выводят и не вызывают преобразование аргументов через `__tostring`.
+
+Ни одна из четырёх функций не возвращает `err`. Если присвоить результат вызова переменной, она получит `nil`; по этому значению нельзя определить, было ли сообщение успешно записано.
+
+**Пример**
+
+```lua
+log.Info("Запрашиваемый домен: ", domain)
+log.Warning("Ошибка запроса к вышестоящему серверу: ", err)
+```
+
+### log.Info
+
+Как описано выше.
+
+### log.Warning
+
+Как описано выше.
+
+### log.Error
+
+Как описано выше.