docs: vendor the documentation site into the monorepo

Fold the standalone 3x-ui-docs project (Next.js 16 + Fumadocs, deployed to docs.sanaei.dev) into docs/ so the panel and its documentation share a single source of truth, the way sing-box keeps its docs in-tree. The old repo becomes redundant and can be retired. - Import the full site under docs/ (app, components, content, lib, public, scripts, config). The self-contained pnpm project sits alongside the existing engineering notes with no filename collisions. - Re-point "Edit on GitHub" links from MHSanaei/3x-ui-docs to this repo's docs/content/docs path (docs/lib/shared.ts, docs/app/.../page.tsx). - Add docs-ci.yml and docs-deploy.yml under .github/workflows/, scoped to docs/** and run with working-directory: docs, since GitHub only runs workflows from the repo-root .github/. deploy-static.yml's GitHub Pages publish (CNAME docs.sanaei.dev) carries over unchanged. Follow-up (outside this commit): attach the docs.sanaei.dev custom domain to this repository's Pages (or set the Vercel project's root directory to docs), confirm the site is live from the monorepo, then delete MHSanaei/3x-ui-docs.
2026-11-12 16:15:02 +03:00 · 2026-07-07 23:07:14 +02:00
parent 2c49dbf54e
commit 9b91f0f42e
283 changed files with 44179 additions and 0 deletions
@@ -0,0 +1,100 @@
+---
+title: Входящие подключения и протоколы
+description: Создание входящих подключений в 3x-ui — протоколы, транспорты, сброс трафика и срок действия, а также fallback-правила, обслуживающие несколько протоколов на одном порту.
+icon: ArrowDownToLine
+---
+
+**Входящее подключение** (inbound) — это слушатель, который принимает клиентские
+соединения на порту, используя определённый протокол и транспорт. Большая часть
+повседневной работы состоит в создании и управлении входящими подключениями и
+клиентами внутри них.
+
+## Создание входящего подключения
+
+<Steps>
+
+<Step>
+### Добавьте входящее подключение
+
+Откройте **Inbounds → Add**, задайте примечание, выберите **протокол**, а также
+**порт** и адрес прослушивания.
+</Step>
+
+<Step>
+### Выберите транспорт и безопасность
+
+Выберите транспорт (TCP, WebSocket, gRPC, HTTPUpgrade, XHTTP, …) и уровень
+безопасности (без шифрования, TLS или REALITY). См. [Транспорты](/docs/config/transports) и
+[REALITY](/docs/config/reality).
+</Step>
+
+<Step>
+### Добавьте клиентов
+
+Добавьте одного или нескольких клиентов, у каждого со своими учётными данными,
+ограничениями и ссылкой для подключения. См. [Клиенты](/docs/config/clients).
+</Step>
+
+<Step>
+### Задайте лимит трафика, срок действия и сброс
+
+При необходимости ограничьте общий объём трафика и установите дату истечения для
+входящего подключения, а также выберите расписание периодического **сброса трафика**:
+`never` (по умолчанию), `hourly`, `daily`, `weekly` или `monthly`.
+</Step>
+
+</Steps>
+
+## Поддерживаемые протоколы
+
+Редактор входящих подключений принимает следующие протоколы:
+
+| Протокол               | Примечания                                                               |
+| ---------------------- | ------------------------------------------------------------------------ |
+| **VLESS**              | Лёгкий; основа для REALITY + XTLS-Vision. Рекомендуется.                  |
+| **VMess**              | Более старый, но очень широко поддерживается клиентами.                   |
+| **Trojan**             | На основе TLS; поддерживает XTLS и fallback-правила.                      |
+| **Shadowsocks**        | Включает шифры Shadowsocks-2022 (`2022-blake3-*`).                        |
+| **WireGuard**          | Современный туннель.                                                      |
+| **Hysteria2**          | Выбирается как `hysteria`; панель создаёт ссылки `hysteria2://`.          |
+| **HTTP**               | HTTP-прокси.                                                              |
+| **Mixed (SOCKS/HTTP)** | Совмещённый слушатель SOCKS + HTTP.                                       |
+| **Dokodemo-door / Tunnel** | Перенаправление портов / перенаправление трафика.                    |
+| **MTProto**            | Прокси Telegram MTProto, обслуживаемый встроенным процессом `mtg` (не Xray). |
+
+<Callout type="info">
+  Hysteria2 внутренне не является отдельным протоколом — это протокол `hysteria`
+  с версией транспорта, установленной в 2, и панель генерирует для него ссылки
+  `hysteria2://` для подключения.
+</Callout>
+
+## Fallback-правила — несколько протоколов на одном порту
+
+Fallback-правила позволяют одному TLS-порту (например, `443`) обслуживать более
+одного протокола — например, VLESS **и** Trojan — направляя несовпавшие
+рукопожатия на дочернее входящее подключение. В 3x-ui fallback-правила
+управляются в панели (список **Fallbacks** у главного входящего подключения), а
+не прописываются вручную в JSON.
+
+Fallback-правила доступны только тогда, когда главное входящее подключение:
+
+- использует **VLESS** или **Trojan**,
+- работает на «сыром» транспорте **TCP**,
+- с безопасностью **TLS** или **REALITY**.
+
+Каждое fallback-правило указывает на дочернее входящее подключение и может
+сопоставляться по `path`, `alpn` и `dest`. Клиентские ссылки для дочернего
+fallback-подключения автоматически переписываются так, чтобы указывать адрес,
+порт и TLS главного подключения.
+
+## Не уверены, что выбрать?
+
+Воспользуйтесь мастером, чтобы получить рекомендацию исходя из ваших целей и клиентов:
+
+<ProtocolWizard />
+
+<Callout type="info">
+  Для устойчивости к цензуре с современными клиентами **VLESS + REALITY +
+  XTLS-Vision** обычно является лучшим выбором — перейдите к
+  [REALITY](/docs/config/reality).
+</Callout>