Skip to main content
Gateway — це WebSocket-сервер OpenClaw (канали, вузли, сеанси, хуки). Усі наведені нижче підкоманди доступні в openclaw gateway ....

Виявлення Bonjour

Налаштування локального mDNS і глобального DNS-SD.

Огляд виявлення

Як OpenClaw оголошує та знаходить шлюзи.

Конфігурація

Ключі конфігурації Gateway верхнього рівня.

​
Запуск Gateway

  • Відмовляється запускатися, якщо в ~/.openclaw/openclaw.json не встановлено gateway.mode=local. Використовуйте --allow-unconfigured для спеціальних запусків або запусків у середовищі розробки; цей прапорець обходить перевірку без запису чи виправлення конфігурації.
  • openclaw onboard --mode local і openclaw setup записують gateway.mode=local. Якщо файл конфігурації існує, але gateway.mode відсутній, це вважається пошкодженою або перезаписаною конфігурацією, і Gateway не намагатиметься самостійно вгадати значення local — повторно виконайте початкове налаштування, установіть ключ вручну або передайте --allow-unconfigured.
  • Прив’язування за межами loopback без автентифікації блокується.
  • Значення lan, tailnet і custom для --bind наразі обробляються лише через шляхи IPv4; для конфігурацій із власним хостом лише з IPv6 потрібен допоміжний компонент IPv4 або проксі перед Gateway.
  • SIGUSR1 запускає перезапуск усередині процесу, якщо це дозволено. commands.restart (типово: увімкнено) контролює надіслані ззовні сигнали SIGUSR1; установіть значення false, щоб заблокувати ручні перезапуски через сигнал ОС, водночас залишивши можливість перезапуску за допомогою команди gateway restart, інструмента Gateway і застосування або оновлення конфігурації.
  • SIGINT/SIGTERM зупиняють процес, але не відновлюють спеціальний стан термінала — якщо ви обгортаєте CLI у TUI або використовуєте введення в необробленому режимі, самостійно відновіть термінал перед виходом.

​
Параметри

​
number
Порт WebSocket (типово береться з конфігурації або змінної середовища; зазвичай 18789).
​
string
Режим прив’язування: loopback (типово), lan, tailnet, auto, custom.
​
string
Спільний токен для connect.params.auth.token. Типово використовується OPENCLAW_GATEWAY_TOKEN, якщо її встановлено.
​
string
Режим автентифікації: none, token, password, trusted-proxy.
​
string
Пароль для --auth password.
​
string
Прочитати пароль Gateway із файлу.
​
string
Режим доступу через Tailscale: off, serve, funnel.
​
boolean
Скинути конфігурацію Tailscale serve/funnel під час завершення роботи.
​
boolean
Запустити без обов’язкової перевірки gateway.mode=local. Лише для спеціальної ініціалізації або ініціалізації середовища розробки; не зберігає та не виправляє конфігурацію.
​
boolean
Створити конфігурацію та робочий простір для розробки, якщо вони відсутні (пропускає BOOTSTRAP.md).
​
boolean
Скинути конфігурацію для розробки, облікові дані, сеанси та робочий простір. Потребує --dev.
​
boolean
Перед запуском завершити роботу всіх наявних слухачів на цільовому порту.
​
boolean
Докладне журналювання у stdout/stderr.
​
boolean
Показувати в консолі лише журнали серверної частини CLI (також вмикає stdout/stderr).
​
string
за замовчуванням:"auto"
Стиль журналу WebSocket: auto, full, compact.
​
boolean
Псевдонім для --ws-log compact.
​
boolean
Записувати необроблені події потоку моделі у форматі JSONL.
​
string
Шлях до JSONL необробленого потоку.
--claude-cli-logs — застарілий псевдонім для --cli-backend-logs. Для --bind custom установіть gateway.customBindHost на адресу IPv4. Для будь-якої адреси, крім 127.0.0.1 або 0.0.0.0, також потрібна адреса 127.0.0.1 на тому самому порту для клієнтів на тому самому хості; запуск завершиться помилкою, якщо хоча б один зі слухачів не зможе виконати прив’язування. Універсальна адреса 0.0.0.0 не додає окремого обов’язкового псевдоніма. Для конфігурацій із власним хостом лише з IPv6 потрібен допоміжний компонент IPv4 або проксі перед Gateway.

​
Перезапуск Gateway

--safe просить запущений Gateway попередньо перевірити активну роботу та запланувати один об’єднаний перезапуск після її завершення. Очікування обмежене параметром gateway.reload.deferralTimeoutMs (типово: 5 хвилин / 300000); коли відведений час спливає, перезапуск виконується примусово. Установіть deferralTimeoutMs: 0, щоб чекати необмежено довго (з періодичними попередженнями про незавершене очікування) замість примусового перезапуску. --safe не можна поєднувати з --force або --wait. --skip-deferral обходить перевірку відкладення через активну роботу під час безпечного перезапуску, тому Gateway перезапускається негайно навіть за наявності повідомлених блокувальних чинників. Потребує --safe — використовуйте, коли відкладення зависло через некероване завдання. --wait <duration> перевизначає час очікування завершення роботи для звичайного (небезпечного) перезапуску. Приймає значення в мілісекундах без суфікса або із суфіксами одиниць ms, s, m, h, d (наприклад, 30s, 5m, 1h30m); --wait 0 очікує необмежено довго. Несумісний із --force або --safe. --force пропускає очікування завершення активної роботи та виконує перезапуск негайно. Звичайна команда restart (без прапорців) зберігає наявну поведінку перезапуску через диспетчер служб.
Вбудований у команду параметр --password може бути видимим у локальних списках процесів. Надавайте перевагу --password-file, змінній середовища або gateway.auth.password на основі SecretRef.

​
Профілювання Gateway

  • OPENCLAW_GATEWAY_STARTUP_TRACE=1 записує тривалість фаз під час запуску, зокрема затримку eventLoopMax для кожної фази та час формування таблиць пошуку плагінів (індекс установлених плагінів, реєстр маніфестів, планування запуску, робота з картою власників).
  • OPENCLAW_GATEWAY_RESTART_TRACE=1 записує рядки restart trace:, пов’язані з перезапуском: обробку сигналів, очікування завершення активної роботи, фази завершення роботи, наступний запуск, час до готовності та показники пам’яті.
  • OPENCLAW_DIAGNOSTICS=timeline разом із OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=<path> записує в режимі найкращих зусиль часову шкалу діагностики запуску у форматі JSONL для зовнішніх засобів автоматизації контролю якості (рівнозначно конфігурації diagnostics.flags: ["timeline"]; шлях усе ще задається лише через змінну середовища). Додайте OPENCLAW_DIAGNOSTICS_EVENT_LOOP=1, щоб включити зразки циклу подій.
  • pnpm build, а потім pnpm test:startup:gateway -- --runs 5 --warmup 1 вимірюють продуктивність запуску Gateway через зібрану точку входу CLI: перший вивід процесу, /healthz, /readyz, часові показники трасування запуску, затримку циклу подій і час формування таблиць пошуку плагінів.
  • pnpm build, а потім pnpm test:restart:gateway -- --case skipChannels --runs 1 --restarts 5 вимірюють продуктивність перезапуску всередині процесу в macOS або Linux (не підтримується у Windows; для перезапуску потрібен SIGUSR1). Команда використовує SIGUSR1, вмикає обидва види трасування в дочірньому процесі та записує наступні /healthz і /readyz, час простою, час до готовності, використання CPU, RSS і показники трасування перезапуску.
  • /healthz перевіряє життєздатність; /readyz — готовність до використання. Розглядайте рядки трасування та результати вимірювань як сигнал для визначення відповідального компонента, а не як остаточний висновок про продуктивність на основі одного проміжку чи зразка.

​
Запити до запущеного Gateway

Усі команди запитів використовують RPC через WebSocket.
  • Типово: зручний для читання людиною формат (кольоровий у TTY).
  • --json: придатний для машинної обробки JSON (без стилізації та індикатора виконання).
  • --no-color (або NO_COLOR=1): вимкнути ANSI, зберігши форматування для читання людиною.
Коли ви задаєте --url, CLI не використовує резервні облікові дані з конфігурації або змінних середовища. Передайте --token або --password явно. Відсутність явно вказаних облікових даних є помилкою.

​
gateway health

/healthz — це перевірка життєздатності: вона повертає відповідь, щойно сервер може відповідати через HTTP. /readyz суворіша й залишається в стані помилки, доки допоміжні компоненти плагінів запуску, канали або налаштовані хуки ще ініціалізуються. Докладні локальні або автентифіковані відповіді /readyz містять блок діагностики eventLoop (затримка, завантаження, співвідношення до кількості ядер CPU, прапорець degraded).
​
number
Звернутися до локального Gateway через local loopback на цьому порту. Перевизначає OPENCLAW_GATEWAY_URL і OPENCLAW_GATEWAY_PORT для цього виклику.

​
gateway usage-cost

Отримати зведення витрат використання з журналів сеансів.
​
number
за замовчуванням:"30"
Кількість днів, які потрібно включити.
​
string
Обмежити зведення одним ідентифікатором налаштованого агента.
​
boolean
Агрегувати дані всіх налаштованих агентів. Не можна поєднувати з --agent.

​
gateway stability

Отримати останні дані реєстратора діагностичної стабільності із запущеного Gateway.
​
number
за замовчуванням:"25"
Максимальна кількість останніх подій для включення (не більше 1000).
​
string
Фільтрувати за типом діагностичної події, наприклад payload.large або diagnostic.memory.pressure.
​
number
Включити лише події після вказаного номера діагностичної послідовності.
​
string
Прочитати збережений пакет даних стабільності замість звернення до запущеного Gateway. --bundle latest (або просто --bundle) вибирає найновіший пакет у каталозі стану; також можна безпосередньо передати шлях до JSON-файлу пакета.
​
boolean
Записати придатний для передавання ZIP-архів діагностики підтримки замість виведення відомостей про стабільність.
​
string
Шлях виведення для --export.
  • Записи зберігають операційні метадані: назви подій, кількість, розміри в байтах, показники пам’яті, стан черги та сеансу, ідентифікатори схвалень, назви каналів і плагінів, а також знеособлені зведення сеансів. Вони не містять текст чатів, тіл Webhook, виводу інструментів, необроблених тіл запитів і відповідей, токенів, файлів cookie, секретних значень, імен хостів і необроблених ідентифікаторів сеансів. Установіть diagnostics.enabled: false, щоб повністю вимкнути реєстратор.
  • Фатальні завершення Gateway, перевищення часу очікування під час завершення роботи та збої запуску після перезапуску записують той самий діагностичний знімок у ~/.openclaw/logs/stability/openclaw-stability-*.json, якщо реєстратор містить події. Перегляньте найновіший пакет за допомогою openclaw gateway stability --bundle latest; --limit, --type і --since-seq також застосовуються до виведення пакета.

​
gateway diagnostics export

Записати локальний ZIP-архів діагностики, призначений для звітів про помилки. Опис моделі конфіденційності та вмісту пакета дивіться в розділі Експорт діагностики.
​
string
Шлях до вихідного ZIP-файлу. За замовчуванням — експорт для служби підтримки в каталозі стану.
​
number
за замовчуванням:"5000"
Максимальна кількість очищених рядків журналу, які буде включено.
​
number
за замовчуванням:"1000000"
Максимальна кількість байтів журналу для перевірки.
​
string
URL WebSocket Gateway для знімка стану працездатності.
​
string
Токен Gateway для знімка стану працездатності.
​
string
Пароль Gateway для знімка стану працездатності.
​
number
за замовчуванням:"3000"
Час очікування знімка статусу/стану працездатності.
​
boolean
Пропустити пошук збереженого пакета стабільності.
​
boolean
Вивести записані шлях, розмір і маніфест у форматі JSON.
Експорт містить: manifest.json (перелік файлів), summary.md (підсумок у форматі Markdown), diagnostics.json (зведення верхнього рівня щодо конфігурації, журналів, виявлення, стабільності, статусу та стану працездатності), config/sanitized.json, status/gateway-status.json, health/gateway-health.json, logs/openclaw-sanitized.jsonl і stability/latest.json, якщо пакет існує. Експорт призначений для передавання іншим. Він зберігає операційні відомості, корисні для налагодження, — безпечні поля журналів, назви підсистем, коди статусу, тривалості, налаштовані режими, порти, ідентифікатори плагінів і провайдерів, несекретні параметри функцій та операційні повідомлення журналу з вилученими конфіденційними даними — і вилучає або редагує текст чатів, тіла вебхуків, результати інструментів, облікові дані, файли cookie, ідентифікатори облікових записів і повідомлень, текст запитів та інструкцій, імена хостів і секретні значення. Коли повідомлення журналу схоже на текст корисного навантаження користувача, чату чи інструмента (наприклад, «користувач сказав», «текст чату», «результат інструмента», «тіло вебхука»), експорт зберігає лише факт вилучення повідомлення та кількість його байтів.

​
gateway status

Показує службу Gateway (launchd/systemd/schtasks), а також необов’язкову перевірку підключення та автентифікації.
​
string
Додати явну ціль перевірки. Налаштовану віддалену адресу та localhost усе одно буде перевірено.
​
string
Автентифікація токеном для перевірки.
​
string
Автентифікація паролем для перевірки.
​
number
за замовчуванням:"10000"
Час очікування перевірки.
​
boolean
Пропустити перевірку підключення (показати лише службу).
​
boolean
Також сканувати служби системного рівня.
​
boolean
Розширити перевірку підключення до перевірки читання та завершити роботу з ненульовим кодом у разі невдачі. Не можна поєднувати з --no-probe.
  • Залишається доступною для діагностики, навіть коли локальна конфігурація CLI відсутня або недійсна.
  • Типовий вивід підтверджує стан служби, підключення WebSocket і можливість автентифікації, видиму під час рукостискання, — але не операції читання, запису чи адміністрування.
  • Перевірки не вносять змін під час первинної автентифікації пристрою: вони повторно використовують наявний кешований токен пристрою, але ніколи не створюють нову ідентичність пристрою CLI або запис сполучення лише для читання тільки заради перевірки статусу.
  • За можливості розв’язує налаштовані посилання SecretRef автентифікації для перевірки. Якщо потрібне посилання SecretRef не вдалося розв’язати, --json повідомляє rpc.authWarning, коли перевірка підключення чи автентифікації завершується невдало; явно передайте --token/--password або виправте джерело секрету. Попередження про нерозв’язану автентифікацію приховуються після успішної перевірки.
  • Вивід JSON містить gateway.version, коли запущений Gateway повідомляє її; --require-rpc може використати як резервне джерело корисне навантаження RPC status.runtimeVersion, якщо перевірка рукостискання не може надати метадані версії.
  • Використовуйте --require-rpc у сценаріях і автоматизації, коли служби, що прослуховує порт, недостатньо й також потрібна працездатність RPC з областю читання.
  • --deep шукає додаткові інсталяції launchd/systemd/schtasks; якщо знайдено кілька служб, схожих на Gateway, текстовий вивід показує підказки щодо очищення (зазвичай слід запускати один Gateway на машину) і, коли це доречно, повідомляє про нещодавню передачу керування під час перезапуску супервізора.
  • --deep також виконує перевірку конфігурації в режимі з урахуванням плагінів (pluginValidation: "full") і показує попередження маніфестів плагінів (наприклад, про відсутні метадані конфігурації каналу). Типова команда gateway status зберігає швидкий шлях лише для читання, що пропускає перевірку плагінів.
  • Текстовий вивід містить визначений шлях до файлу журналу, а також шляхи й стан дійсності конфігурацій CLI та служби, щоб полегшити діагностику розбіжностей профілю або каталогу стану.
  • Перевірки розбіжностей автентифікації служби читають із юніта як Environment=, так і EnvironmentFile= (зокрема %h, шляхи в лапках, кілька файлів і необов’язкові файли з префіксом -).
  • Розв’язує посилання SecretRef gateway.auth.token, використовуючи об’єднане середовище виконання (спочатку середовище команди служби, потім резервно — середовище процесу).
  • Перевірки розбіжностей токена пропускають розв’язання токена з конфігурації, коли автентифікація токеном фактично неактивна (gateway.auth.mode явно має значення password/none/trusted-proxy або режим не задано, пароль може мати пріоритет і жоден кандидат на токен не може бути вибраний).

​
gateway probe

Команда для «налагодження всього». Вона завжди перевіряє:
  • налаштований віддалений Gateway (якщо задано) та
  • localhost (local loopback), навіть якщо налаштовано віддалений Gateway.
Передавання --url додає цю явну ціль перед обома іншими. У текстовому виводі цілі позначаються як URL (явний), Віддалений (налаштований) / Віддалений (налаштований, неактивний) і Local loopback.
Якщо доступні кілька цілей перевірки, буде виведено їх усі. Тунель SSH, URL TLS/проксі та налаштований віддалений URL можуть указувати на той самий Gateway навіть за різних транспортних портів; multiple_gateways використовується лише для доступних Gateway з різними або неоднозначними ідентичностями. Запуск кількох Gateway підтримується для ізольованих профілів (наприклад, аварійного бота), але більшість інсталяцій використовує один Gateway.
​
number
Використовувати цей порт для локальної цілі перевірки local loopback і віддаленого порту тунелю SSH. Без --url цей параметр вибирає лише локальну ціль local loopback замість URL середовища налаштованого Gateway, порту середовища або віддалених цілей.
  • Доступний: так означає, що принаймні одна ціль прийняла підключення WebSocket.
  • Можливості: лише читання|запис дозволено|адміністрування дозволено|очікування сполучення|лише підключення повідомляє, що перевірка змогла підтвердити щодо автентифікації, окремо від доступності.
  • Перевірка читання: успішно означає, що деталізовані виклики RPC з областю читання (health/status/system-presence/config.get) також виконано успішно.
  • Перевірка читання: обмежено — відсутня область: operator.read означає, що підключення успішне, але RPC з областю читання обмежено. Це повідомляється як погіршена доступність, а не повна невдача.
  • Перевірка читання: невдало після Підключення: успішно означає, що WebSocket підключився, але наступна діагностика читання перевищила час очікування або завершилася невдало — це також погіршений стан, а не недоступність.
  • Як і gateway status, перевірка повторно використовує наявну кешовану автентифікацію пристрою, але не створює первинну ідентичність пристрою або стан сполучення.
  • Код завершення є ненульовим, лише коли жодна перевірена ціль не доступна.
Верхній рівень:
  • ok: принаймні одна ціль доступна.
  • degraded: принаймні одна ціль прийняла підключення, але не завершила повну деталізовану діагностику RPC.
  • capability: найкращий рівень можливостей серед доступних цілей (read_only, write_capable, admin_capable, pairing_pending, connected_no_operator_scope або unknown).
  • primaryTargetId: найкраща ціль, яку слід вважати активною, у такому порядку: явний URL, тунель SSH, налаштована віддалена ціль, локальний local loopback.
  • warnings[]: записи попереджень, сформовані за принципом максимально можливої повноти, з code, message і необов’язковим targetIds.
  • network: підказки URL для локального local loopback/tailnet, отримані з поточної конфігурації та мережевих параметрів хоста.
  • discovery.timeoutMs / discovery.count: фактичний бюджет виявлення та кількість результатів, використані під час цього проходу перевірки.
Для кожної цілі (targets[].connect): ok (доступність і класифікація погіршеного стану), rpcOk (повний успіх деталізованого RPC), scopeLimited (деталізований RPC завершився невдало через відсутність області оператора).Для кожної цілі (targets[].auth): role і scopes, повідомлені в hello-ok, коли доступні, а також виведена класифікація capability.
  • ssh_tunnel_failed: не вдалося налаштувати тунель SSH; команда перейшла до прямих перевірок.
  • multiple_gateways: були доступні Gateway з різними ідентичностями або OpenClaw не зміг підтвердити, що доступні цілі є тим самим Gateway. Тунель SSH, URL проксі або налаштований віддалений URL до того самого Gateway не спричиняють цього попередження.
  • auth_secretref_unresolved: не вдалося розв’язати налаштоване посилання SecretRef автентифікації для цілі, перевірка якої завершилася невдало.
  • probe_scope_limited: підключення WebSocket успішне, але перевірку читання обмежено через відсутність operator.read.
  • local_tls_runtime_unavailable: локальний TLS Gateway увімкнено, але OpenClaw не зміг завантажити відбиток локального сертифіката.

​
Віддалене підключення через SSH (відповідність застосунку Mac)

Режим застосунку macOS “Remote over SSH” використовує локальне перенаправлення порту, щоб віддалений Gateway, доступний лише через local loopback, став доступним за адресою ws://127.0.0.1:<port>. Еквівалент у CLI:
​
string
user@host або user@host:port (порт за замовчуванням — 22).
​
string
Файл ідентичності.
​
boolean
Вибрати перший виявлений хост Gateway як ціль SSH із визначеної кінцевої точки виявлення (local. разом із налаштованим глобальним доменом, якщо він є). Підказки, що містять лише TXT, ігноруються.
Типові параметри конфігурації (необов’язкові): gateway.remote.sshTarget, gateway.remote.sshIdentity.

​
gateway call <method>

Низькорівневий допоміжний засіб RPC.
​
string
за замовчуванням:"{}"
Рядок об’єкта JSON із параметрами.
​
string
URL WebSocket Gateway.
​
string
Токен Gateway.
​
string
Пароль Gateway.
​
number
за замовчуванням:"10000"
Бюджет часу очікування.
​
boolean
Переважно для RPC у стилі агента, які транслюють проміжні події перед остаточним корисним навантаженням.
​
boolean
Машиночитаний вивід JSON.
--params має містити дійсний JSON, і кожен метод перевіряє власну структуру параметрів (зайві або неправильно названі поля відхиляються).

​
Керування службою Gateway

​
Встановлення з обгорткою

Використовуйте --wrapper, коли керована служба має запускатися через інший виконуваний файл, наприклад адаптер менеджера секретів або допоміжний засіб запуску від імені іншого користувача. Обгортка отримує звичайні аргументи Gateway і відповідає за те, щоб зрештою виконати openclaw або Node із цими аргументами.
Також обгортку можна встановити через середовище. gateway install перевіряє, що шлях указує на виконуваний файл, записує обгортку в ProgramArguments служби та зберігає OPENCLAW_WRAPPER у середовищі служби для подальших примусових перевстановлень, оновлень і виправлень через doctor.
Щоб видалити збережену обгортку, очистьте OPENCLAW_WRAPPER під час перевстановлення:
  • gateway status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
  • gateway install: --port, --runtime <node|bun> (типово: node), --token, --wrapper <path>, --force, --json
  • gateway restart: --safe, --skip-deferral, --force, --wait <duration>, --json
  • gateway uninstall|start: --json
  • gateway stop: --disable, --json
  • Використовуйте gateway restart, щоб перезапустити керовану службу. Не поєднуйте послідовно gateway stop і gateway start як заміну перезапуску.
  • У macOS команда gateway stop типово використовує launchctl bootout, що видаляє LaunchAgent із поточного сеансу завантаження, не зберігаючи стан вимкнення — автоматичне відновлення KeepAlive залишається активним для майбутніх збоїв, а gateway start коректно повторно вмикає службу без ручного виконання launchctl enable. Передайте --disable, щоб постійно блокувати KeepAlive і RunAtLoad, аби Gateway не запускався повторно до наступного явного виконання gateway start; використовуйте це, якщо зупинка вручну має зберігатися після перезавантажень.
  • Команди життєвого циклу приймають --json для використання у скриптах.
  • Коли для автентифікації за токеном потрібен токен, а gateway.auth.token керується через SecretRef, gateway install перевіряє, чи можна отримати значення SecretRef, але не зберігає отриманий токен у метаданих середовища служби.
  • Якщо для автентифікації за токеном потрібен токен, а значення налаштованого SecretRef токена неможливо отримати, установлення завершується відмовою замість збереження резервного відкритого тексту.
  • Для автентифікації за паролем у gateway run надавайте перевагу OPENCLAW_GATEWAY_PASSWORD, --password-file або gateway.auth.password на основі SecretRef замість вбудованого --password.
  • У режимі автоматичного визначення автентифікації змінна OPENCLAW_GATEWAY_PASSWORD, доступна лише в оболонці, не послаблює вимог щодо токена під час установлення; під час установлення керованої служби використовуйте постійну конфігурацію (gateway.auth.password або env у конфігурації).
  • Якщо налаштовано і gateway.auth.token, і gateway.auth.password, а gateway.auth.mode не задано, установлення блокується, доки режим не буде задано явно.

​
Виявлення Gateway (Bonjour)

gateway discover сканує маяки Gateway (_openclaw-gw._tcp).
  • Багатоадресна DNS-SD: local.
  • Одноадресна DNS-SD (Bonjour для глобальної мережі): виберіть домен (наприклад, openclaw.internal.) і налаштуйте розділену DNS та DNS-сервер; див. Bonjour.
Маяк оголошують лише ті Gateway, для яких увімкнено виявлення Bonjour (типово). Підказки TXT у кожному маяку: role (підказка щодо ролі Gateway), transport (підказка щодо транспорту, наприклад gateway), gatewayPort (порт WebSocket, зазвичай 18789), tailnetDns (ім’я хоста MagicDNS, якщо доступне), gatewayTls / gatewayTlsSha256 (TLS увімкнено + відбиток сертифіката). sshPort і cliPath публікуються лише в режимі повного виявлення (discovery.mdns.mode: "full"; типовим є "minimal", у якому їх пропущено — тоді клієнти типово використовують порт 22 для цілей SSH).

​
gateway discover

​
number
за замовчуванням:"2000"
Час очікування для кожної команди (перегляд/розпізнавання).
​
boolean
Машиночитаний вивід (також вимикає стилізацію та індикатор перебігу).
Приклади:
  • Сканує local. і налаштований домен глобальної мережі, якщо його ввімкнено.
  • wsUrl у виводі JSON визначається з розпізнаної кінцевої точки служби, а не лише з підказок TXT, як-от lanHost або tailnetDns.
  • discovery.mdns.mode керує публікацією sshPort/cliPath як у mDNS local., так і в DNS-SD глобальної мережі (див. вище).

​
Пов’язані матеріали