Update README.md to enhance local setup instructions and add Docker Registry usage examples

2026-03-09 16:17:01 +07:00
parent eb07c8c78f
commit 43bb8e4f4c
1 changed files with 51 additions and 4 deletions
@@ -19,15 +19,62 @@
 - `TELEGRAM_HTTP_TIMEOUT_SECONDS` - timeout запросов к Telegram (по умолчанию `60`).
 - `TELEMT_HTTP_TIMEOUT_SECONDS` - timeout запросов к Telemt API (по умолчанию `5`).

-## Быстрый старт (PowerShell)
+## Быстрый старт (локально, Linux/bash)

-```powershell
-Copy-Item .env.example .env
-# отредактируй .env
+```bash
+cp .env.example .env
+# отредактируй .env под свой Telemt и Telegram
 docker compose up --build -d
 docker compose logs -f
 ```

+## Запуск из Docker Registry
+
+### Через docker compose
+
+Пример `docker-compose.yml`, который использует уже собранный образ из Gitea Registry:
+
+```yaml
+services:
+  telemt-bot:
+    image: git.shts.su/denozord/telemt-bot:latest
+    restart: unless-stopped
+    environment:
+      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}
+      TELEGRAM_ADMIN_CHAT_ID: ${TELEGRAM_ADMIN_CHAT_ID}
+      TELEMT_API_BASE_URL: ${TELEMT_API_BASE_URL}
+      TELEMT_API_AUTH_HEADER: ${TELEMT_API_AUTH_HEADER}
+      TELEGRAM_HTTP_TIMEOUT_SECONDS: ${TELEGRAM_HTTP_TIMEOUT_SECONDS:-60}
+      TELEMT_HTTP_TIMEOUT_SECONDS: ${TELEMT_HTTP_TIMEOUT_SECONDS:-5}
+```
+
+Запуск (Linux/bash):
+
+```bash
+export TELEGRAM_BOT_TOKEN="xxx:telegram_bot_token"
+export TELEGRAM_ADMIN_CHAT_ID="123456789"
+export TELEMT_API_BASE_URL="http://host.docker.internal:9091"
+export TELEMT_API_AUTH_HEADER="Bearer secret"
+
+docker compose up -d
+docker compose logs -f
+```
+
+### Через docker CLI (Linux/bash)
+
+```bash
+docker run -d \
+  --name telemt-bot \
+  --restart unless-stopped \
+  -e TELEGRAM_BOT_TOKEN="xxx:telegram_bot_token" \
+  -e TELEGRAM_ADMIN_CHAT_ID="123456789" \
+  -e TELEMT_API_BASE_URL="http://host.docker.internal:9091" \
+  -e TELEMT_API_AUTH_HEADER="Bearer secret" \
+  -e TELEGRAM_HTTP_TIMEOUT_SECONDS="60" \
+  -e TELEMT_HTTP_TIMEOUT_SECONDS="5" \
+  git.shts.su/denozord/telemt-bot:latest
+```
+
 ## Почему решение экономное по ресурсам

 - Go-бинарник без рантайма и с нулевым CGO.