index.mdx 5.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. ---
  2. title: Знакомство с 3x-ui
  3. description: Веб-панель для Xray-core — управляйте входящими подключениями, протоколами, клиентами и подписками из браузера, не редактируя JSON вручную.
  4. icon: Info
  5. ---
  6. **3x-ui** — это веб-панель управления, которая работает поверх
  7. [Xray-core](https://github.com/XTLS/Xray-core), прокси-движка, который непосредственно
  8. передаёт ваш трафик. Вместо того чтобы вручную писать и перезагружать JSON-конфигурацию Xray,
  9. вы управляете всем — входящими подключениями, протоколами, клиентами, сертификатами,
  10. подписками — из панели управления в браузере.
  11. ## Как всё связано между собой
  12. <Mermaid
  13. chart={`
  14. flowchart LR
  15. Admin["Admin browser"] -->|HTTPS panel| Panel["3x-ui panel"]
  16. Panel -->|writes config, reloads| Xray["Xray-core"]
  17. Panel --- DB[("SQLite or PostgreSQL")]
  18. Clients["Client apps"] -->|VLESS / VMess / Trojan / ...| Xray
  19. Xray -->|proxied traffic| Internet["Internet"]
  20. `}
  21. />
  22. - **Панель** — это уровень управления: она хранит вашу конфигурацию в
  23. базе данных, отображает панель управления, предоставляет REST API и записывает
  24. актуальную конфигурацию Xray.
  25. - **Xray-core** — это уровень передачи данных: он принимает клиентские подключения на ваших
  26. **входящих подключениях** и пересылает трафик к месту назначения.
  27. - **Клиентские приложения** (такие как v2rayNG, Clash/Mihomo, Hiddify и другие) подключаются
  28. по ссылке для подключения или подписке, которую панель генерирует для каждого клиента.
  29. ## Что она вам даёт
  30. - Панель управления **входящими подключениями** по всем основным протоколам — VLESS, VMess,
  31. Trojan, Shadowsocks, WireGuard, AmneziaWG, TUIC v5, Hysteria2, SOCKS, HTTP и Dokodemo-door.
  32. - Полноценная поддержка **REALITY** и **XTLS-Vision** для скрытных и быстрых
  33. транспортов.
  34. - **Поклиентские** квоты трафика, даты истечения, ограничения по IP, статус «онлайн» и
  35. ссылки для подключения / QR-коды в один клик.
  36. - **Подписки** в форматах VLESS, Clash/Mihomo и JSON.
  37. - Инструменты для эксплуатации: управление **несколькими узлами**, **Telegram- и Discord-боты**, резервные копии,
  38. ограничение по IP на базе Fail2ban и документированный REST API.
  39. ## Что под капотом
  40. | Уровень | Технология |
  41. | ------------ | -------------------------------------------- |
  42. | Бэкенд | Go с веб-фреймворком Gin |
  43. | Фронтенд | TypeScript / React |
  44. | База данных | SQLite (по умолчанию) или PostgreSQL |
  45. | Прокси-движок | Xray-core (входит в комплект и управляется панелью) |
  46. База данных SQLite по умолчанию находится по пути `/etc/x-ui/x-ui.db`, а панель слушает
  47. порт **2053** по умолчанию. Оба значения настраиваются — см.
  48. [Первый вход](/docs/guide/first-login) и справочник по переменным окружения.
  49. ## Для кого она
  50. 3x-ui рассчитана на всех, кто запускает собственный сервер Xray: от одного личного
  51. VPS до операторов, управляющих множеством узлов и клиентов. Если вам нужна вся мощь
  52. Xray-core без необходимости жить в файлах JSON-конфигурации, это для вас.
  53. <Callout type="info">
  54. 3x-ui — это улучшенный форк оригинального проекта X-UI, добавляющий более широкую поддержку
  55. протоколов, повышенную стабильность, поклиентский учёт трафика, управление несколькими
  56. узлами и множество улучшений для удобства работы.
  57. </Callout>
  58. Готовы к установке? Переходите к разделу [Установка](/docs/guide/installation).