3x-ui/docs/content/docs/ru/operations/multi-node.mdx
Nikan Zeyaei 21aa662629
docs(nodes): note that updating an mTLS node needs a node-admin token (#6957)
A master that reaches a node over mTLS with no bearer token is treated as
node-sync, which cannot call /server/updatePanel, so "Update panel" on such a
node fails with HTTP 403. That is intended, but the multi-node guide said the
API token is "not needed in mTLS mode" (#6953).

The guide (en/fa/ru/zh) and the node form's mTLS hint (all 14 locales) now say
that updating the node from the master still needs a token with the
node-admin scope. No logic changes.

The CI workflow's path filter does not cover internal/web/translation or docs,
so only Docs CI ran on this head; the locale-dependent tests were run locally.
2026-11-13 16:54:30 +01:00

112 lines
7.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: Несколько узлов и управляемые хосты
description: Управляйте несколькими панелями 3x-ui из одной главной панели — с доверием на основе API-токена или mTLS, heartbeat-сигналами и переопределением хостов для отдельных inbound-соединений в подписках.
icon: Boxes
---
3x-ui может управлять **несколькими серверами** из одной главной панели и
переопределять то, как каждое inbound-соединение объявляется в подписках, с
помощью **управляемых хостов**.
## Узлы
**Узел** — это другая панель 3x-ui, которой ваша главная панель управляет через
API этого узла. Главная панель опрашивает каждый узел и в одном месте показывает
его статус, версии, загрузку CPU/памяти, время работы и трафик.
### Добавление узла
Укажите данные подключения к узлу:
| Поле | Примечания |
| ----------------- | --------------------------------------------------------------------- |
| **Имя** | Уникальная метка (например, `de-fra-1`). |
| **Схема** | `https` (по умолчанию) или `http`. |
| **Адрес / Порт** | Хост и порт панели узла. |
| **Базовый путь** | Веб-базовый путь узла. |
| **API-токен** | Bearer-токен, созданный на узле (в режиме mTLS необязателен, кроме **Обновления панели** — нужен `node-admin`). |
| **Проверка TLS** | `verify` (по умолчанию), `skip`, `pin` (закрепить SHA-256 сертификата) или `mtls`. |
| **Синхронизация inbound** | `all` (все) inbound-соединения или `selected` (выбранные) по тегу. |
| **Тег исходящего**| При необходимости обращаться к узлу **через** именованное исходящее соединение (мост исходящего трафика). |
Главная панель проверяет доступность при добавлении или тестировании узла. Затем
она каждые несколько секунд отправляет **heartbeat**, обновляя статус узла
(`online` / `offline`) и генерируя события `node.up` / `node.down` (см.
[Telegram-бот](/docs/operations/telegram-bot) и [Discord-бот](/docs/operations/discord-bot)).
<Callout type="info">
Узлы идентифицируются по стабильному GUID, уникальному для каждой панели,
поэтому узел сохраняет свою идентичность между перезапусками. Узел сам может
управлять другими узлами — главная панель отображает их как доступные только
для чтения **транзитивные** подузлы (Узел 1 → Узел 2 → Узел 3).
</Callout>
### Взаимный TLS (mTLS) между главной панелью и узлом
Для максимально надёжного доверия используйте `tlsVerifyMode = mtls` (требуется
`https`):
<Steps>
<Step>
### Получите CA главной панели
На главной панели получите её CA-сертификат для аутентификации узлов (приватный
ключ CA никогда не покидает панель).
</Step>
<Step>
### Доверьте ему на узле
Вставьте этот CA в настройку «доверенный CA» на узле. Изменения вступят в силу
при следующем перезапуске узла.
</Step>
<Step>
### Переключите узел на mTLS
Задайте на узле режим проверки TLS `mtls`. Теперь главная панель предъявляет
клиентский сертификат вместо API-токена.
<Callout type="warn">
Узел, подключённый по mTLS без токена, имеет только область `node-sync`, которая
не позволяет выполнить **Обновление панели** (узел отвечает HTTP 403,
«this API token is not permitted to access this endpoint»). Чтобы обновить такой
узел с главной панели, создайте на узле API-токен с областью `node-admin` и
вставьте его в поле **API-токен** этого узла на главной панели. Режим проверки
TLS оставьте `mtls`.
</Callout>
</Step>
</Steps>
## Управляемые хосты
**Управляемый хост** — это переопределяющая конечная точка, привязанная к
inbound-соединению. Во время формирования подписки каждый включённый хост
добавляет дополнительную ссылку-share / прокси со своим адресом, портом, TLS,
SNI, заголовком host, путём и другими параметрами — заменяя устаревший список
«внешних прокси». Используйте их, чтобы:
- проксировать inbound через **CDN** (Cloudflare) с другим адресом/SNI,
- объявлять для одного inbound **несколько доменов** или конечные точки для
разных регионов,
- настраивать ALPN, fingerprint, ECH или mux для каждой конечной точки.
У каждого хоста есть примечание (которое поддерживает те же
[шаблонные переменные](/docs/config/share-links#remark-template-variables)),
переключатель включения, порядок сортировки, и он может быть **исключён из
определённых форматов подписки** или **ограничен конкретными узлами**.
<Callout type="info">
Хосты, чей адрес/порт указывают на CDN, позволяют держать реальный адрес
сервера в секрете, пока клиенты подключаются через граничные узлы CDN.
</Callout>
## Связанное
<Cards>
<Card title="Исходящие соединения и маршрутизация" href="/docs/operations/outbounds-routing" description="WARP, NordVPN, подписки на исходящие соединения и маршрутизация." />
<Card title="Подписка" href="/docs/config/subscription" description="Как хосты формируют вывод подписки." />
</Cards>