feat: add one-question VPS installer

2026-10-14 17:25:10 +07:00
parent 1e1dfa7b92
commit 3f063dd2ca
6 changed files with 441 additions and 2 deletions
@@ -9,6 +9,75 @@
 > Telegram, в котором есть тип прокси `WEB`. Если такого пункта в настройках
 > нет, установленная версия клиента этот транспорт ещё не поддерживает.

+## Самый простой вариант: чистый VPS и один вопрос
+
+Этот вариант подходит, если вы только что купили отдельный чистый VPS и не
+хотите настраивать Nginx Proxy Manager. Скрипт сам установит Docker, запустит
+прокси вместе с Caddy и получит HTTPS-сертификат. Он спросит только домен.
+
+Понадобятся:
+
+- 64-битный VPS `x86_64` с Ubuntu или Debian;
+- один домен или поддомен с единственной DNS-записью `A`, которая уже указывает
+  прямо на публичный IPv4 этого VPS;
+- открытые у провайдера сервера входящие TCP-порты `80` и `443`.
+
+На странице проекта в Gitea нажмите **Code**, скопируйте адрес **HTTPS**, затем
+подключитесь к VPS по SSH и выполните команды ниже. Вместо текста в угловых
+скобках вставьте скопированный адрес:
+
+```sh
+sudo apt update
+sudo apt install -y git
+git clone <АДРЕС_РЕПОЗИТОРИЯ>
+cd telegram-web-proxy-stack
+sudo ./quick-install.sh
+```
+
+После запуска нужно ввести только подготовленный домен. Пароли или токены
+Gitea для публичного репозитория не требуются.
+
+Можно случайно вставить домен вместе с `https://` — установщик уберёт схему и
+лишний путь. После проверки DNS он автоматически:
+
+1. установит системные компоненты и Docker из официального репозитория;
+2. соберёт Telegram WEB proxy;
+3. запустит Caddy и выпустит HTTPS-сертификат;
+4. покажет сервер, секрет и готовую ссылку подключения.
+
+Для автоматического запуска домен разрешается передать сразу:
+
+```sh
+sudo ./quick-install.sh --domain proxy.example.com
+```
+
+Секрет сохраняется в Docker-томе и остаётся прежним при повторном запуске.
+Для обновления используйте только быстрый установщик:
+
+```sh
+git pull --ff-only
+sudo ./quick-install.sh
+```
+
+Если выпуск сертификата не завершился, проверьте DNS и правила входящего
+трафика у провайдера VPS, затем запустите ту же команду ещё раз. Этот вариант
+не использует Nginx Proxy Manager и не требует входа в какую-либо панель.
+
+Остановить быструю установку, не удаляя секрет и сертификат:
+
+```sh
+docker compose --env-file .env -f compose.yml -f compose.quick.yml down
+```
+
+Повторно запустить:
+
+```sh
+docker compose --env-file .env -f compose.yml -f compose.quick.yml up -d
+```
+
+Ниже описан второй, отдельный вариант для сервера, где Nginx Proxy Manager уже
+установлен.
+
 ## Схема работы

 ```text