Миграция на zensical, актуализация под iptvc после рефакторинга

2026-07-22 01:11:07 +08:00
parent 7d61aadc5d
commit 8d0f3ebcce
665 changed files with 7626 additions and 922 deletions
@@ -0,0 +1,80 @@
+---
+icon: material/robot-outline
+---
+
+# :material-robot-outline: Telegram-бот
+
+!!! info "Обрати внимание"
+    Локальная среда разработки должна быть [настроена и запущена](local-dev.md).
+
+## Подготовка бота на стороне Telegram
+
+1. Написать [@botfather](https://t.me/botfather), создать бота
+2. Полученный токен установить значением переменной `TG_BOT_TOKEN` в файле `.env` репозитория `web`
+3. Командой `/mybots` в [@botfather](https://t.me/botfather) выбрать свежесозданного бота, далее `Edit Bot` > `Edit Commands` и отправить текст:
+    ```
+    list - Список плейлистов
+    info - Подробности о плейлисте по его коду
+    help - Помощь по командам бота
+    links - Ссылки на все страницы проекта
+    stats - Статистика по плейлистам и каналам
+    ```
+
+## Проброс внешних запросов на локальную машину
+
+1. Установить [telebit](https://telebit.cloud) и пройти примитивную регистрацию.
+    В результате будет выдан уникальный адрес в формате `https://foo-bar-99.telebit.io`.
+    На email, указанный при регистрации, будет оформлен бесплатный SSL-серификат Let's Encrypt для этого домена.
+    Если адрес не используется месяц+, то сертификат протухнет, но он автоматически восстановится, если адрес начнёт использоваться вновь.
+
+2. В терминале выполнить:
+    ```
+    telebit http 8080
+    ```
+    где `8080` — порт локальной машины, на который проброшен порт 80 из контейнера `iptv-nginx`.
+    Для выключения выполнить:
+    ```
+    telebit http
+    ```
+
+3. Проверить работу адреса, перейдя по нему браузером.
+   Должен открыться твой локальный проект.
+
+4. Полученный адрес установить значением переменной `APP_URL` в файле `.env` репозитория `web`
+
+5. Установить веб-хук, отправив запрос браузером или любым HTTP-клиентом на адрес:
+    ```
+    https://api.telegram.org/bot$BOT_TOKEN/setWebhook?url=$TELEBIT_URL/bot/webhook&secret_token=$SECRET_TOKEN
+    ```
+    где:
+    * `$BOT_TOKEN` - авторизационный токен, который @botfather выдал твоему боту;
+    * `$TELEBIT_URL` - адрес, который telebit выдал тебе;
+    * `$SECRET_TOKEN` - секретный токен, опционален, см. ниже.
+
+6. Проверить веб-хук, отправив запрос браузером или любым HTTP-клиентом на адрес:
+    ```
+    https://api.telegram.org/bot$BOT_TOKEN/getWebhookInfo
+    ```
+    где:
+    * `$BOT_TOKEN` - авторизационный токен, который @botfather выдал твоему боту.
+
+7. После разработки нужно установить "боевой" адрес веб-хука аналогично п4.
+
+## Что за секретный токен?
+
+Telegram авторизует твоего бота по токену, который выдал ему сам.
+
+Ты тоже можешь (не) авторизовать Telegram по токену, который ты выдашь ему.
+
+Для этого нужно в значением переменной `TG_BOT_SECRET` в файле `.env` репозитория `web` установить любую строку.
+Если ты это сделаешь, тогда ту же строку ты должен передать в параметре `secret_token` метода `setWebhook`.
+
+В этом случае, все HTTP-запросы, которые приходят от Telegram, будут содержать заголовок `X-Telegram-Bot-Api-Secret-Token` со этой строкой в качестве значения.
+Эта строка сверяется с той, что указана в `.env` проекта.
+Если такого заголовка нет или его значение некорректно, входящий запрос отклоняется.
+
+Если переменная `TG_BOT_SECRET` не задана, то заголовок проверяться не будет.
+
+См. подробности в документации: [setWebhook](https://core.telegram.org/bots/api#setwebhook)
+
+