release 1.5.0: one panel in all channels; Apple apps (iOS, new macOS tab) only in beta/dev
- stable gets the beta panel and server features (new design, presets, firewall, monthly traffic, router failover over all ports/addresses + TCP, altip, HR tab, Windows tab, update banner); ios/ macos/ windows/ sources stay out of stable - menu item "Update to N" under Settings when a new version is out - mobile: top menu no longer stretches to 200px - urllib User-Agent: Cloudflare in front of git.bobyrev.com returns 403 to Python-urllib - docs: GitHub adleibzon-rgb as source, password/uninstall/devices sections, new screenshots, PORTS.md TCP fallback and second IP Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@@ -11,6 +11,8 @@ fails", or "panel is too exposed".
|
||||
| `PANEL_PORT` | TCP | admin browser, secondary setup/register, router pull fallback | yes | Web panel and `/api/*`. Real value: `cat /opt/phobos-panel/.port`. |
|
||||
| `80` | TCP | routers during install, Android APK download | recommended | nginx serves `/init/`, `/packages/`, `/app/`. |
|
||||
| `2083,5443,993` | UDP | routers and Android PhobosWG | yes | wg-obfuscator public entry ports. Real value: `grep OBFUSCATOR_PORTS /opt/Phobos/server/server.env`. |
|
||||
| `443` (else `8443`/`2096`/`4433`) | TCP | PCA Phobos VPN apps, Windows, routers (1.5.0+) when UDP is blocked | recommended | TCP fallback `phobos-tcp` (udptcp) since 1.4.1; port chosen at install/update, shown in `phobos-update` output (`TCP fallback: port N`). |
|
||||
| second public IP: obfuscator ports + TCP | UDP/TCP | routers whose ISP blocks the main IP | optional | `phobos-altip` (1.5.0) DNATs the second IP to the main one; list it in panel → «Адрес для клиентов» → spare addresses. |
|
||||
| `51820` | UDP | plain WireGuard clients only | no by default | Usually blocked to force obfuscation. Open only if installed with `ALLOW_PLAIN_WG=1` for iOS/plain WG. |
|
||||
| `22` | TCP | admin only | optional | SSH maintenance. Do not expose broadly. |
|
||||
|
||||
|
||||
47
docs/SERVER-SWITCH.md
Normal file
@@ -0,0 +1,47 @@
|
||||
# Смена сервера у клиента: что и как работает
|
||||
|
||||
Клиент (учётка) в панели привязан к серверу. Если в панели открыть «Редактировать» и выбрать другой
|
||||
сервер, адрес меняется у клиента **автоматически только в наших приложениях**. Сторонние клиенты
|
||||
(PhobosWG и др.) ничего не знают о панели — им нужно заново импортировать ссылку `phobos://`.
|
||||
|
||||
## Кто подхватывает смену сервера
|
||||
|
||||
| Клиент | Как узнаёт о смене | Задержка |
|
||||
|---|---|---|
|
||||
| Роутер (Keenetic/OpenWrt) | pull-агент `phobos-pull.sh` раз в минуту забирает `failover.conf`; `phobos-health.sh` видит рассинхрон (DESYNC) и переключает (SWITCH) | до ~1 мин |
|
||||
| iOS (build 7+), Android 1.4.5+ | подписка `# pca-sub` в ссылке: приложение читает `/api/phone-sub/<клиент>?token=…` | при запуске и по таймеру |
|
||||
| Windows 1.4.5+ | помощник `sub` читает `# pca-sub`, раз в минуту; при другом host/ключе переписывает `profile.conf` и переподключается | до ~1 мин |
|
||||
| Сторонние (PhobosWG и др.) | никак | переимпорт ссылки вручную |
|
||||
|
||||
## Как это устроено
|
||||
1. Панель → Клиенты → «Редактировать» → «Сервер» (поле `client_assignments` в `settings.json`).
|
||||
2. Панель добавляет WG-пир клиента на выбранный сервер и рассылает конфиг (`fanout_router_config`).
|
||||
3. «Переход на другие серверы»: «Да, при блокировке» — выбранный сервер первый, остальные запасные;
|
||||
«Только этот сервер» (`client_pinned`) — в списке один выбранный сервер.
|
||||
4. Список отдаётся роутеру (`failover.conf`) и телефонам/Windows (`/api/phone-sub`); первый в списке — назначенный.
|
||||
|
||||
## Что нужно, чтобы это работало
|
||||
- **Проверено 03.11.2026** (главная панель на ВМ + secondary на VPS): регистрация (`registered`), пир клиента появляется на secondary, «Сервер» меняет порядок в `/api/phone-sub` (назначенный первый), «Только этот сервер» оставляет один. Команда secondary в панели сама подставляет подсеть главной.
|
||||
- **Один сервер управления.** Остальные серверы ставятся как secondary командой из панели
|
||||
(раздел «Серверы»): общий список клиентов и адресов. Отдельная панель на втором VPS (полный
|
||||
`install.sh`) — это другая панель со своими клиентами, смена сервера между ними не работает.
|
||||
- Если всё же ставите независимые серверы — у каждого своя подсеть (`10.25.0.0/16`, `10.25.11.0/24`, …),
|
||||
иначе клиенты получат одинаковые IP и второй туннель на роутере не поднимется.
|
||||
Подсеть вида `10.25.11.0/16` установщик превращает в `10.25.11.0/24`.
|
||||
- В ссылке клиента должна быть строка `# pca-sub = …`. Старые ссылки без неё импортировать заново один раз.
|
||||
- Несколько учёток на одном роутере (по стране на учётку): у каждой «Только этот сервер», в beta/dev
|
||||
они ставятся в `/opt/etc/Phobos/acc/<учётка>/`. Не пробовать на канале stable (v1.4.7): там затрёт главную.
|
||||
|
||||
## Как проверить за минуту
|
||||
```bash
|
||||
# что панель отдаёт клиенту (первый сервер = назначенный)
|
||||
curl -s "http://ПАНЕЛЬ:ПОРТ/api/phone-sub/КЛИЕНТ?token=ТОКЕН"
|
||||
# роутер: новый сервер и журнал переключения
|
||||
cat /opt/etc/Phobos/failover.conf | grep ^SERVER_1; tail /opt/etc/Phobos/health.log
|
||||
# Windows: журнал и профиль
|
||||
type C:\ProgramData\PCAPhobos\pcaphobos.log # «panel moved us to … -> reconnect»
|
||||
```
|
||||
|
||||
## Ограничения
|
||||
- Windows-помощник сравнивает host, ключ обфускатора и WG-ключ; смена только порта не вызывает переподключения.
|
||||
- Пока клиент оффлайн, он узнает о смене при следующем запуске/подключении.
|
||||
|
Before Width: | Height: | Size: 141 KiB After Width: | Height: | Size: 160 KiB |
|
Before Width: | Height: | Size: 141 KiB After Width: | Height: | Size: 158 KiB |
|
Before Width: | Height: | Size: 482 KiB |
|
Before Width: | Height: | Size: 94 KiB After Width: | Height: | Size: 178 KiB |
|
Before Width: | Height: | Size: 93 KiB After Width: | Height: | Size: 168 KiB |
BIN
docs/img/mobile-servers-dark.png
Normal file
|
After Width: | Height: | Size: 215 KiB |
|
Before Width: | Height: | Size: 81 KiB After Width: | Height: | Size: 238 KiB |
|
Before Width: | Height: | Size: 120 KiB After Width: | Height: | Size: 334 KiB |
|
Before Width: | Height: | Size: 119 KiB After Width: | Height: | Size: 345 KiB |
|
Before Width: | Height: | Size: 106 KiB After Width: | Height: | Size: 128 KiB |
|
Before Width: | Height: | Size: 105 KiB After Width: | Height: | Size: 129 KiB |
|
Before Width: | Height: | Size: 224 KiB After Width: | Height: | Size: 589 KiB |
|
Before Width: | Height: | Size: 221 KiB After Width: | Height: | Size: 608 KiB |