mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-11-18 08:34:43 +03:00
9b91f0f42e
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.
53 lines
2.5 KiB
Plaintext
53 lines
2.5 KiB
Plaintext
---
|
||
title: Обратный прокси
|
||
description: Разместите панель 3x-ui и подписку за Nginx или Caddy с TLS от Let's Encrypt.
|
||
icon: Waypoints
|
||
---
|
||
|
||
Обратный прокси позволяет отдавать панель и подписку на аккуратном домене с
|
||
автоматическим HTTPS и скрывать реальные порты за портами 80/443. Хотите, чтобы
|
||
панель завершала TLS напрямую? Тогда получите сертификат через
|
||
[меню SSL `x-ui`](/docs/config/ssl-certificates).
|
||
|
||
## Сгенерировать конфигурацию
|
||
|
||
<ReverseProxyGenerator />
|
||
|
||
<Callout type="info">
|
||
Панель использует WebSockets для обновлений в реальном времени, поэтому прокси
|
||
должен передавать заголовки `Upgrade`/`Connection` (приведённая выше
|
||
конфигурация Nginx уже это делает). Caddy обрабатывает обновления WebSocket
|
||
автоматически.
|
||
</Callout>
|
||
|
||
## Nginx + сертификат
|
||
|
||
С Nginx получите сертификат с помощью `certbot` (или `acme.sh`) и укажите его в
|
||
блоке server:
|
||
|
||
```bash title="certbot"
|
||
certbot certonly --nginx -d panel.example.com
|
||
```
|
||
|
||
Перезагрузите Nginx после установки сертификата и настройте автоматическое
|
||
продление (`certbot renew` по умолчанию запускается по таймеру).
|
||
|
||
## Caddy
|
||
|
||
Caddy получает и продлевает сертификаты за вас — направьте Caddyfile на панель,
|
||
и всё просто заработает:
|
||
|
||
```text title="Caddyfile"
|
||
panel.example.com {
|
||
reverse_proxy 127.0.0.1:2053
|
||
}
|
||
```
|
||
|
||
## Советы
|
||
|
||
- Сохраняйте **базовый веб-путь** панели даже за прокси; это эшелонированная защита.
|
||
- Если вы завершаете TLS на прокси, возможно, стоит выставить `XUI_SKIP_HSTS=true` на
|
||
панели — см. [справочник по переменным окружения](/docs/reference/env-vars).
|
||
- Проксируйте также сервер [подписки](/docs/config/subscription), чтобы его содержимое
|
||
отдавалось по HTTPS.
|