zapret-kvn/README.md
XrayFluent Dev 7f8982fbb5 fix: TUN stability, IPv6 blackhole, status notifications, data preservation
- IPv6 blackhole route while TUN active (fixes BBC static CDN)
- LAN bypass routes (fixes DHCP loss / internet drop)
- Status notifications at every TUN stage
- Log throttling for xhttp flood connections
- Hot-swap keeps HTTP inbound alive for browser proxy extensions
- build_dist3.sh with data backup/restore
- Block LAN/broadcast in xray routing rules
- Updated CLAUDE.md: always use subagents rule

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 23:36:24 +03:00

2 KiB

Xray Fluent GUI (PyQt6 + Fluent Widgets)

Windows-focused GUI shell for xray.exe with a Windows 11-like Fluent interface.

What is included in this MVP

  • Fast node import from clipboard (vless://, vmess://, trojan://, ss://, socks://, http://, raw outbound JSON)
  • Quick switch between nodes (Dashboard + system tray)
  • Start/stop Xray core directly (core/xray.exe)
  • System proxy mode (HTTP + SOCKS loopback)
  • Routing modes: Global, Rule, Direct
  • Basic routing editor (direct/proxy/block lists)
  • TCP ping for nodes
  • Real connectivity test through Xray proxy
  • Live mini-metrics on Dashboard (download/upload rate + RTT)
  • Export selected outbound JSON and full runtime xray_config.json
  • Runtime logs, diagnostics export (ZIP with redacted config)
  • Separate Xray core updater with channels (stable, beta, nightly)
  • DPAPI-encrypted local state storage
  • Master password + auto-lock
  • Light / dark / system theme and accent color

Project layout

  • main.py - app entrypoint
  • xray_fluent/app_controller.py - app orchestration
  • xray_fluent/link_parser.py - URI parser
  • xray_fluent/config_builder.py - Xray config generator
  • xray_fluent/xray_manager.py - process lifecycle
  • xray_fluent/proxy_manager.py - Windows system proxy
  • xray_fluent/ui/ - all Fluent UI pages
  • core/ - Xray core binaries

Requirements

  • Windows 10/11 x64
  • Python 3.13

Install deps:

python -m pip install -r requirements.txt

If qfluentwidgets is not in your Python env, install it explicitly:

python -m pip install PyQt6-Fluent-Widgets

Run

python main.py

Start minimized to tray:

python main.py --minimized

Build portable EXE (PyInstaller)

./build_portable.ps1

Output:

  • dist/XrayFluent/ - portable folder
  • dist/XrayFluent-portable.zip - zipped portable bundle

Notes

  • No TUN mode in this version (system proxy only)
  • Subscription URLs are intentionally not implemented yet
  • App update feed and Xray core feed can be configured separately in Settings