mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-10-03 20:53:41 +03:00
a09e136001
* docs: add Discord bot to READMEs, architecture, operations guides, and locales * docs: address review feedback on Discord bot formatting, backup commands, and architecture * docs(discord): fix Persian typo and literal arrows on fa/zh bot pages Senior review of #6513, two LOW findings in the two new pages: - fa/operations/discord-bot.mdx:30 spelled "developers" with Cyrillic "де" in place of Persian "ده", rendering a mixed-script word. - Both pages copied `$\rightarrow$` from the en page. The docs site has no math plugin (nothing in source.config.ts, no remark-math installed), so the built HTML shows the literal string "$\rightarrow$" in every menu path. Replaced with a Unicode arrow on fa and zh; en and ru have carried the same since #6486 and are left for a separate change. --------- Co-authored-by: Sanaei <ho3ein.sanaei@gmail.com>
72 lines
5.1 KiB
Plaintext
72 lines
5.1 KiB
Plaintext
---
|
||
title: Знакомство с 3x-ui
|
||
description: Веб-панель для Xray-core — управляйте входящими подключениями, протоколами, клиентами и подписками из браузера, не редактируя JSON вручную.
|
||
icon: Info
|
||
---
|
||
|
||
**3x-ui** — это веб-панель управления, которая работает поверх
|
||
[Xray-core](https://github.com/XTLS/Xray-core), прокси-движка, который непосредственно
|
||
передаёт ваш трафик. Вместо того чтобы вручную писать и перезагружать JSON-конфигурацию Xray,
|
||
вы управляете всем — входящими подключениями, протоколами, клиентами, сертификатами,
|
||
подписками — из панели управления в браузере.
|
||
|
||
## Как всё связано между собой
|
||
|
||
<Mermaid
|
||
chart={`
|
||
flowchart LR
|
||
Admin["Admin browser"] -->|HTTPS panel| Panel["3x-ui panel"]
|
||
Panel -->|writes config, reloads| Xray["Xray-core"]
|
||
Panel --- DB[("SQLite or PostgreSQL")]
|
||
Clients["Client apps"] -->|VLESS / VMess / Trojan / ...| Xray
|
||
Xray -->|proxied traffic| Internet["Internet"]
|
||
`}
|
||
/>
|
||
|
||
- **Панель** — это уровень управления: она хранит вашу конфигурацию в
|
||
базе данных, отображает панель управления, предоставляет REST API и записывает
|
||
актуальную конфигурацию Xray.
|
||
- **Xray-core** — это уровень передачи данных: он принимает клиентские подключения на ваших
|
||
**входящих подключениях** и пересылает трафик к месту назначения.
|
||
- **Клиентские приложения** (такие как v2rayNG, Clash/Mihomo, Hiddify и другие) подключаются
|
||
по ссылке для подключения или подписке, которую панель генерирует для каждого клиента.
|
||
|
||
## Что она вам даёт
|
||
|
||
- Панель управления **входящими подключениями** по всем основным протоколам — VLESS, VMess,
|
||
Trojan, Shadowsocks, WireGuard, AmneziaWG, TUIC v5, Hysteria2, SOCKS, HTTP и Dokodemo-door.
|
||
- Полноценная поддержка **REALITY** и **XTLS-Vision** для скрытных и быстрых
|
||
транспортов.
|
||
- **Поклиентские** квоты трафика, даты истечения, ограничения по IP, статус «онлайн» и
|
||
ссылки для подключения / QR-коды в один клик.
|
||
- **Подписки** в форматах VLESS, Clash/Mihomo и JSON.
|
||
- Инструменты для эксплуатации: управление **несколькими узлами**, **Telegram- и Discord-боты**, резервные копии,
|
||
ограничение по IP на базе Fail2ban и документированный REST API.
|
||
|
||
## Что под капотом
|
||
|
||
| Уровень | Технология |
|
||
| ------------ | -------------------------------------------- |
|
||
| Бэкенд | Go с веб-фреймворком Gin |
|
||
| Фронтенд | TypeScript / React |
|
||
| База данных | SQLite (по умолчанию) или PostgreSQL |
|
||
| Прокси-движок | Xray-core (входит в комплект и управляется панелью) |
|
||
|
||
База данных SQLite по умолчанию находится по пути `/etc/x-ui/x-ui.db`, а панель слушает
|
||
порт **2053** по умолчанию. Оба значения настраиваются — см.
|
||
[Первый вход](/docs/guide/first-login) и справочник по переменным окружения.
|
||
|
||
## Для кого она
|
||
|
||
3x-ui рассчитана на всех, кто запускает собственный сервер Xray: от одного личного
|
||
VPS до операторов, управляющих множеством узлов и клиентов. Если вам нужна вся мощь
|
||
Xray-core без необходимости жить в файлах JSON-конфигурации, это для вас.
|
||
|
||
<Callout type="info">
|
||
3x-ui — это улучшенный форк оригинального проекта X-UI, добавляющий более широкую поддержку
|
||
протоколов, повышенную стабильность, поклиентский учёт трафика, управление несколькими
|
||
узлами и множество улучшений для удобства работы.
|
||
</Callout>
|
||
|
||
Готовы к установке? Переходите к разделу [Установка](/docs/guide/installation).
|