Updating and Beta Versions

🧪 Обновление и Тестовые Сборки (Beta / Pre-release)

English below

В проекте NatBypass реализована автоматическая двухканальная система доставки обновлений:

1. 🟢 Стабильный канал (Stable): релизы, прошедшие полное тестирование (например, v1.9.220).
2. 🧪 Тестовый канал (Beta / Pre-release): новейшие предварительные сборки (например, v1.9.221-beta.1), содержащие оптимизации производительности, обновленные алгоритмы обхода ТСПУ/DPI, исправления ошибок и экспериментальные функции.

Все бинарные файлы и пакеты подписываются криптографической подписью Ed25519, проверяемой перед установкой.

---

📱 Android-приложение (NatBypass.apk)

Включение тестовых сборок в приложении:

1. Откройте приложение NatBypass на Android.
2. Нажмите иконку Шестерёнка (Настройки) или нажмите на колокольчик/иконку обновления в правом верхнем углу.
3. В открывшемся окне обновления найдите переключатель 🧪 Тестовые сборки (Beta).
4. Переведите переключатель во включенное положение.
5. Приложение моментально выполнит запрос к GitHub Releases API с параметром prerelease, отобразит список изменений бета-версии и кнопку «Скачать и обновить».
6. Скачивание происходит в фоне с отображением индикатора прогресса, скорости загрузки и размера. По завершении система предложит установить обновление в один клик без потери настроек профилей.

---

🌐 WebUI (Keenetic, OpenWrt, Linux, Windows)

Панель WebUI (http://<IP_УСТРОЙСТВА>:8080) доступна на всех устройствах, работающих под управлением демона natbypass.

Пошаговое обновление через браузер:

1. Перейдите в WebUI (http://192.168.1.1:8080 для роутера или http://127.0.0.1:8080 для ПК).
2. В правом верхнем углу нажмите кнопку 🔄 Обновление.
3. В появившемся диалоговом окне включите тумблер «Тестовые сборки (Beta / Pre-release)».
4. Нажмите кнопку «Проверить обновления».
5. Если новая бета-версия найдена, появится подробный список изменений (Changelog) и плашка 🧪 Предварительный релиз (Pre-release).
6. Нажмите «Установить обновление».
7. Демон выполнит потоковую загрузку бинарного файла, проверку контрольной суммы Ed25519, атомарную замену исполняемого файла и мягкий перезапуск службы. Соединения восстанавливаются автоматически за 1–2 секунды.

---

🪟 Windows Desktop GUI (NatBypass-GUI.exe)

В нативном приложении Windows:

1. Нажмите правой кнопкой мыши по иконке NatBypass в системном трее Windows (возле часов) либо перейдите в меню окна.
2. Выберите пункт «Проверить обновления...».
3. При обнаружении версии вам будет предложено обновиться до актуального релиза или бета-версии.
4. Обновление выполняется в отдельном фоновом потоке, не блокируя оконные сообщения и интерфейс Windows.

Также доступно обновление через PowerShell от Администратора:

# Обновление до последней бета-версии
irm https://raw.githubusercontent.com/jamixm4-crypto/natbypass/main/scripts/update.ps1 | iex -ArgumentList "-Beta"

---

🐧 Linux / Роутеры Keenetic & OpenWrt (CLI)

Обновление выполняется одной терминальной командой:

1. Быстрое обновление через онлайн-скрипт:

# Для обновления до бета-версии:
curl -fsSL https://raw.githubusercontent.com/jamixm4-crypto/natbypass/main/scripts/update.sh | sh -s -- --beta

(или через wget: wget -qO- https://raw.githubusercontent.com/jamixm4-crypto/natbypass/main/scripts/update.sh | sh -s -- --beta)

2. Через встроенную команду бинарника natbypass:

# Проверка и установка бета-версии:
natbypass update --beta

# Возврат на стабильную версию:
natbypass update --channel stable

---

🔒 Безопасность и Откат (Rollback)

• Атомарная замена: Перед заменой текущий исполняемый файл сохраняется как natbypass.bak. Если при запуске новой версии произойдет сбой, сторожевой таймер восстанавливает предыдущий рабочий файл.
• Подпись Ed25519: Обновления загружаются исключительно из официального репозитория jamixm4-crypto/natbypass. Загрузка неподписанных файлов отклоняется на уровне ядра обновления.

---

🇬🇧 Updating to Beta Builds (English)

NatBypass features an automated two-channel update delivery engine:

1. 🟢 Stable Channel: fully validated public releases (v1.9.220).
2. 🧪 Beta / Pre-release Channel: newest builds (v1.9.221-beta.1) with performance optimizations, DPI/TSPU tuning, and fixes.

Android:

Open Settings or Update Dialog -> Enable 🧪 Тестовые сборки (Beta) -> Click Download & Install.

WebUI:

Open http://<device-ip>:8080 -> Click Update -> Toggle Beta / Pre-release -> Apply Update.

Linux / Keenetic / OpenWrt:

curl -fsSL https://raw.githubusercontent.com/jamixm4-crypto/natbypass/main/scripts/update.sh | sh -s -- --beta