SubVost Connect for Linux — 1.0.4 candidate
 
NEW IN 1.0.4 CANDIDATE / НОВОЕ В КАНДИДАТЕ 1.0.4
The app is named SubVost Connect; the network service remains SubVost VPN.
Portable and DEB installers authenticate a protected root-owned copy before
privileged use. The source candidate includes native configuration validation.
Frozen-package, native CPU/device and desktop authorization UI qualification
are separate release gates; this source preparation is not a published release.
Приложение называется SubVost Connect; сетевая служба — SubVost VPN.
Установщики проверяют защищённую копию файлов перед использованием с правами
root. Подготовлены проверки конфигурации native-компонента. Проверка собранных
пакетов, CPU/устройств и окна авторизации остаётся отдельным условием выпуска.

NEW IN 1.0.3 CANDIDATE / НОВОЕ В КАНДИДАТЕ 1.0.3
SteamOS portable/AppImage installation without disabling OS read-only protection;
installation preflight and removal rollback improvements. Steam Deck field
acceptance is pending. See the SteamOS section before installing.
Установка компонента на SteamOS без отключения защиты системы, проверка условий
перед установкой и восстановление файлов при прерванном удалении. Проверка на
реальном Steam Deck ещё не завершена; прочитайте раздел SteamOS ниже.

NEW IN 0.5.20 / НОВОЕ В 0.5.20
Patched Xray 26.9.30, bounded diagnostic history and opt-in system-DNS / DoH
comparison. Updates require a pinned publisher signature, size and SHA-256;
partial files are never offered for installation. Portable/AppImage users must
have the system openssl command installed for publisher verification.
Xray 26.9.30 с сохранёнными патчами SubVost, ограниченный журнал диагностики
и ручное сравнение системного DNS с DoH. Обновления проверяются по подписи
издателя, размеру и SHA-256; неполные файлы установить нельзя.

NEW IN 0.5.10
Local site/app exceptions and updated desktop settings. Settings → Updates
includes automatic checks and expandable release notes. Downloaded packages
are size/SHA-256 verified. Installation remains an explicit package-manager
action and requires disconnecting VPN first; no silent tunnel interruption.

НОВОЕ В 0.5.10
Исключения сайтов и приложений, обновлённые настройки. В «Обновлениях» есть
автоматическая проверка и раскрываемый список изменений. Пакет проверяется
по размеру и SHA-256. Установка — только по действию пользователя.

INSTALLATION
DEB: sudo apt install ./SubVost-VPN-Linux-*.deb
RPM: install with your distribution's package manager.
Archive: extract, then run ./install.sh as your normal user inside the extracted directory.
AppImage: open as your normal user and select Install component in Settings.
The signed installation tree is copied out of the AppImage before authorization.
The isolated system Python verifier authenticates its own root-owned copy before
running the installer. A missing or invalid publisher proof stops installation.
Do not launch the archive's installation script with sudo.
Portable installer preflight: ./install.sh --check (does not modify the system).
The installer checks the actual executable architecture and bundled CA store.
After installation, launch SubVost Connect from the application menu as your normal user.
Do not run the GUI as root. Import your subscription link from @subvost_vpn_bot.

STEAMOS (CANDIDATE; Steam Deck field acceptance pending)
On SteamOS with systemd 257+, the portable/AppImage installer uses an additive
system extension under /var/lib/extensions. Do not disable SteamOS read-only
protection. Existing package-manager or conflicting installations are refused.
If the installed authorization policy cannot be activated with a supported
reload, installation requests a SteamOS restart before connecting; it does not
restart polkit or claim that the component is ready.
The extension is bound to the exact SteamOS version. After a SteamOS upgrade,
disconnect/close the app, remove the old component using the command below,
then install the current package again. User profiles and identity are retained.
Do not force an incompatible extension or delete its files by hand.
Removal also works when the old overlay is no longer mounted:
sudo sh /var/lib/extensions/subvost-vpn/usr/lib/subvost-vpn/uninstall.sh

SteamOS: установка не требует отключать защиту системы. Если установщик просит
перезагрузить SteamOS для активации разрешений, сделайте это перед подключением.
После обновления SteamOS компонент может потребовать удаления и повторной
установки; подписка, идентификатор устройства и состояние восстановления DNS
сохраняются. Принудительное подключение несовместимого расширения не применяется.

UNINSTALLATION
For DEB/RPM/Arch packages, use the package manager used to install them.
For portable/AppImage installations: sudo ./uninstall.sh from the archive,
or sudo /usr/lib/subvost-vpn/uninstall.sh after installation.
Disconnect and close the app first. The script stops the service, checks for
pending DNS recovery, and removes only application installation files.
Subscription, HWID and helper recovery data are preserved.

REQUIREMENTS
64-bit x86_64 or ARM64; glibc 2.35 or newer; Linux TUN support;
an X11 or Wayland desktop; Python 3.10+, iproute2, curl, openssl, polkit, systemd, ca-certificates and xdg-utils.
HTTPS uses your distribution's CA store, with a bundled CA store as fallback
when no system store exists. SSL_CERT_FILE/SSL_CERT_DIR overrides are respected.
Certificate and hostname verification are always enabled.
DNS: systemd-resolved or resolvconf; a regular unmanaged resolv.conf is also supported.
musl-only Alpine, 32-bit systems and other CPU architectures are not supported by
these glibc builds. A package extension is not proof that every distribution works.
Non-systemd service adapters are not included in this first build.

SECURITY / PERMISSIONS
The system component is installed once with administrator authorization.
Only active local users may control it; another user cannot stop an owned tunnel.
The component validates configurations and does not accept arbitrary executable
paths, listeners, log destinations or external certificate/key files.
Subscription data stays in ~/.config/subvost-vpn (0700 directory, 0600 files).
Those permissions do not hide it from other programs running as your account.
Removing the subscription preserves the device ID (HWID).
Closing the application stops the tunnel and restores DNS.

FEATURES IN THIS BUILD
SubVost/INCY JSON subscriptions: VLESS + XHTTP + REALITY, Xray TUN, subscription
DNS/routing, optional TLS fragmentation, country list and offline map, compact list,
RU/EN interface, diagnostics, keyboard navigation.
TCP ingress latency can be measured while TUN is active; DNS resolution still
uses the current system resolver. This is not an exit-country or REALITY/SNI test.
Each location uses repeated samples; locations are checked concurrently with a
bounded deadline. Measurements do not block disconnect or status requests.
Daily update checks and SHA-256-verified same-architecture downloads are available
in Settings. Installation is confirmed in the system package manager; AppImage
and archive builds open the downloaded folder for manual replacement/installation.
Local site exclusions accept domains, wildcard masks and IP networks. Application
exclusions send selected executable paths directly; other traffic follows the
subscription. Rules are saved explicitly in their own editor. Application matching
depends on socket ownership; sandboxed or helper processes may need extra entries.
Unattended privileged installation, include-only-apps mode and tray support are not included.
The default is Dark, with an explicit Dark/Light choice in Settings.
The GTK desktop's accent is retained in either appearance where available; this
preference no longer switches automatically with the desktop's light/dark setting.
The traffic bar shows usage; expiry dates follow the application's RU/EN language.

KEYBOARD
Ctrl+, Settings / Ctrl+R Refresh subscription / Ctrl+Q Quit / Escape Close settings.
Tab, Shift+Tab, arrows, Space and Enter use native GTK keyboard navigation.

TROUBLESHOOTING
Component: systemctl status subvost-vpn.service
Service log: journalctl -u subvost-vpn.service --no-pager -n 60
If another VPN installs overlapping /1 routes, disconnect it first.
The default Automatic DNS mode preserves subscription resolvers and adds
Cloudflare/Google DoH through the selected VPN for continuous DNS redundancy.
Network settings also offer Subscription DNS only and Fallback DoH only.
DNS mode changes apply on the next connection; no plaintext fallback is added.
Do not delete /var/lib/subvost-vpn/dns-recovery.json while DNS recovery is pending.
If DNS was changed by another program, SubVost preserves that change rather than
overwriting it; the recovery journal retains the previous resolver configuration.
The VPN has no persistent kill switch in this build: traffic can use the normal
network after disconnect or a core crash. Do not rely on it as a kill switch.

Support: https://t.me/subvost_vpn_bot
Downloads: https://pystoyplayer.github.io/subvost-vpn/
Third-party license notices are included in the application assets.
