From cf4b5f79b5c8d341f005dcd470a4e709960ab627 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D0=BD=D0=B4=D1=80=D0=B5=D0=B9=20=D0=91=D0=BE=D0=B1?= =?UTF-8?q?=D1=8B=D1=80=D0=B5=D0=B2?= Date: Sun, 31 May 2026 15:06:00 +0300 Subject: [PATCH] docs: CHANGELOG + troubleshooting (handshake/aarch64/phobos-import/uninstall) + update steps Co-Authored-By: Claude Opus 4.8 --- CHANGELOG.md | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 4 +++ 2 files changed, 74 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..9f11f78 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,70 @@ +# Changelog — PCA Phobos + +Каналы: **stable** (публичный, без токена) · **beta** / **dev** (приватный repo, токен подписчика). +Обновление: `phobos-update stable` · `GH_TOKEN=… phobos-update beta|dev` · из панели → «Версия и обновления». + +--- + +## Как обновиться после фиксов + +```bash +# stable (открытый) +phobos-update stable + +# beta/dev (токен уже сохранён в /opt/phobos-panel/.gh_token) +phobos-update beta # или: phobos-update dev +``` +Затем **пересоздать клиентов** в панели (старые конфиги могли содержать неверный порт обфускатора). +Обновляются: панель, скрипты онбординга, агент, updater. Ключи WireGuard, `server.env`, клиенты — НЕ трогаются. + +--- + +## stable + +### v1.2.7 +- **fix:** импорт `phobos://` в PhobosWG. Конфиги дополняются `= none` для недостающих полей (`PresharedKey` и др.) перед base64 — иначе приложение писало «невозможно импортировать туннель». + +### v1.2.6 +- **fix:** бинарники wg-obfuscator для роутеров. Keenetic = aarch64, а Ground-Zerro раздаёт только x86_64. Теперь install.sh и сборка пакета клиента авто-качают aarch64/mipsel/armv7 из ClusterM/wg-obfuscator releases. + +### v1.2.5 +- **feat:** поле токена подписчика + кнопки каналов (stable/beta/dev) прямо в карточке «Версия и обновления». Подписчик вставляет токен в панель и переключается на beta/dev без консоли. + +### v1.2.4 +- **feat:** установка по умолчанию стабильная; beta/dev — опционально (`CHANNEL=`). + +### v1.2.3 +- **fix:** дебаунс DOWN-алертов (3 цикла + повтор) — убирает ложный флап серверов. +- **fix:** `phobos-update` отменяет обновление на несуществующую версию (текущая не трогается). +- **feat:** `--check` / `--versions`, кнопка «Проверить обновления». + +### v1.2.2 +- контакт во всех местах → группа `@PCAdministration`. + +--- + +## Критичные фиксы (общие, во всех каналах) + +| Версия | Проблема | Решение | +|--------|----------|---------| +| 1.2.7 / 1.3.x | PhobosWG: «невозможно импортировать туннель» | `phobos://` дополняется `= none` для всех обязательных полей (`PresharedKey`) по спеке формата | +| 1.2.6 / 1.3.x | Роутер aarch64: «бинарник не найден в архиве» | авто-загрузка aarch64/mipsel/armv7 из ClusterM releases | +| (внутр.) | Клиент не подключается, «НЕТ СОЕДИНЕНИЯ», handshake не встаёт | клиентский обфускатор целился в порт 51821 (никто не слушал); теперь берёт первый из `OBFUSCATOR_PORTS` (2083) | +| (внутр.) | агент secondary не обновлялся через `phobos-update` | `server/api.py` добавлен в managed_files | + +--- + +## beta (приватный) + +### v1.3.0-beta +- скачивание `.conf` для телефона (Android `phobos://` + QR, iOS обычный WireGuard + QR); +- кнопка скачивания приложения **PhobosWG (APK)** — авто-загрузка из GitHub Release приватного repo; +- все критичные фиксы выше. + +--- + +## dev (приватный, активная разработка) + +### v1.3.1-dev +- **баланс по трафику:** агенты отдают пропускную способность канала (rx/tx NIC), `server_load = 0.45·cpu + 0.30·mem + 0.25·bw`; карточки серверов показывают ↕ Mbps; +- все фиксы и фичи из beta. diff --git a/README.md b/README.md index 5e185a2..b2ecf0c 100644 --- a/README.md +++ b/README.md @@ -152,6 +152,10 @@ phobos-update --list # список бэкапов | **Смена сервера применяется не сразу** | роутер тянет конфиг по cron | Применяется за ~12–15 сек, не мгновенно | | **Забыл порт панели** | случайный порт | `cat /opt/phobos-panel/.port` | | **Забыл API key** | | `grep server_api_key /opt/phobos-panel/settings.json` | +| **PhobosWG: «невозможно импортировать туннель»** | старая панель генерила неполный `phobos://` (без `PresharedKey`) | Обнови панель, заново скопируй `phobos://`-ссылку или пересканируй QR. Исправлено в v1.2.7 | +| **Роутер aarch64: «бинарник не найден в архиве»** | Ground-Zerro раздаёт только x86_64 | Обнови (`phobos-update`) — aarch64/mipsel/armv7 авто-качаются из ClusterM, затем пересоздай клиента. Исправлено в v1.2.6 | +| **Клиент не подключается, «НЕТ СОЕДИНЕНИЯ»** | клиентский обфускатор целился в неверный порт (51821) | Обнови панель → **пересоздай клиента** → переустанови на роутере. Порт берётся из `OBFUSCATOR_PORTS` | +| **Удалить сервер полностью** | | `bash <(curl -fsSL https://raw.githubusercontent.com/andrey271192/PCA_Phobos/main/uninstall.sh)` | Логи: `journalctl -u phobos-panel -n 50` · сторож: `/opt/Phobos/server/watchdog.log` · роутер: `/opt/etc/Phobos/health.log`.