diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..2ddc2fa
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,35 @@
+# Changelog
+
+Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/).
+
+## [0.10.0-beta] — 2026-05-21
+
+Первый публичный beta-релиз Telegram-бота для VPN на базе [Remnawave](https://docs.rw/).
+
+### Добавлено
+
+- Базовый Telegram-бот на Go: приветствие `/start`, long polling
+- Переменные окружения: `BOT_TOKEN`, `BOT_DEBUG`, `TELEGRAM_ADMIN_ID`
+- Интеграция с панелью Remnawave (панель 1):
+  - `REMNAWAVE_PANEL_NAME`, `REMNAWAVE_PANEL_URL`, `REMNAWAVE_API_TOKEN`
+  - `REMNAWAVE_CADDY_TOKEN`, `REMNAWAVE_SUBSCRIPTION_URL`
+- Админ-меню (только для `TELEGRAM_ADMIN_ID`):
+  - `/admin` — меню и команды в Telegram
+  - `/admin check` — проверка панели, API и подписки
+  - `/admin config` — просмотр конфигурации в боте
+  - Inline-кнопки и клавиатура быстрого доступа
+- Проверка `/admin check`:
+  - доступность веб-панели
+  - API: статистика, пользователи, ноды
+  - подписка: настройки и список (`/api/subscription-settings`, `/api/subscriptions`)
+  - публичная страница подписки (`REMNAWAVE_SUBSCRIPTION_URL`)
+- Docker Compose: `Dockerfile`, `docker-compose.yml`, multi-stage сборка
+- Документация в `README.md`: развёртывание (VPS, Windows), переменные, админ-меню, **обновление бота**, устранение неполадок
+
+### Структура
+
+- `internal/bot` — обработчики Telegram
+- `internal/config` — загрузка конфигурации
+- `internal/remnawave` — HTTP-клиент и health-check панели
+
+[0.10.0-beta]: https://git.evilfox.cc/test/tgvpn/releases/tag/v0.10.0-beta
diff --git a/README.md b/README.md
index 6292a65..0a4a78c 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # tgvpn
 
+**Версия:** [0.10.0-beta](CHANGELOG.md) · [Релизы](https://git.evilfox.cc/test/tgvpn/releases)
+
 Telegram-бот на Go (базовое приветствие; далее — VPN-функции).
 
 ## Требования
@@ -410,6 +412,7 @@ tgvpn/
 ├── .env.example         # шаблон переменных
 ├── .dockerignore
 ├── go.mod / go.sum
+├── CHANGELOG.md
 └── README.md
 ```