{"id":49730979,"url":"https://github.com/aandstep/resultv","last_synced_at":"2026-06-15T13:00:42.161Z","repository":{"id":340308957,"uuid":"1163926653","full_name":"AandStep/ResultV","owner":"AandStep","description":"Free VPN and proxy client - ResultV","archived":false,"fork":false,"pushed_at":"2026-06-14T08:39:09.000Z","size":110841,"stargazers_count":73,"open_issues_count":4,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-06-14T09:04:46.621Z","etag":null,"topics":["amneziawg","golang","https","hysteria2","proxy","proxy-client","proxy-manage","react","shadowsocks","socks5","trojan","vless","vmess","vpn","vpn-client","vpn-manager","wails","wireguard"],"latest_commit_sha":null,"homepage":"https://result-proxy.ru/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AandStep.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-22T11:23:13.000Z","updated_at":"2026-06-10T23:18:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"4473da06-34c1-422d-bc51-54f552344653","html_url":"https://github.com/AandStep/ResultV","commit_stats":null,"previous_names":["aandstep/resultproxy","aandstep/resultv"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/AandStep/ResultV","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AandStep%2FResultV","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AandStep%2FResultV/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AandStep%2FResultV/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AandStep%2FResultV/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AandStep","download_url":"https://codeload.github.com/AandStep/ResultV/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AandStep%2FResultV/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34363557,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amneziawg","golang","https","hysteria2","proxy","proxy-client","proxy-manage","react","shadowsocks","socks5","trojan","vless","vmess","vpn","vpn-client","vpn-manager","wails","wireguard"],"created_at":"2026-05-09T06:17:51.745Z","updated_at":"2026-06-15T13:00:42.130Z","avatar_url":"https://github.com/AandStep.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"public/logo.png\" width=\"128\" alt=\"ResultProxy logo\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eResultV (prev. ResultProxy)\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eDesktop VPN and proxy client for Windows (macOS/Linux support in beta): Wails, Go, and sing-box.\u003c/b\u003e\u003cbr\u003e\n  Routing, subscriptions, smart rules, and system integration in one app.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-3.2.4-blue.svg\" alt=\"Version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/desktop-Wails-27272f.svg\" alt=\"Wails\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/backend-Go-00ADD8.svg\" alt=\"Go\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/frontend-React_18-61dafb.svg\" alt=\"React\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/engine-sing--box-22c55e.svg\" alt=\"sing-box\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#user-guide\"\u003eUser guide\u003c/a\u003e •\n  \u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e •\n  \u003ca href=\"#building\"\u003eBuilding\u003c/a\u003e •\n  \u003ca href=\"https://result-proxy.ru/\"\u003eWebsite\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"./README.md\"\u003eРусский\u003c/a\u003e | \u003cb\u003eEnglish\u003c/b\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eWebsite and downloads:\u003c/b\u003e \u003ca href=\"https://result-proxy.ru/\"\u003eresult-proxy.ru\u003c/a\u003e • \u003cb\u003eTelegram channel:\u003c/b\u003e \u003ca href=\"https://t.me/resultvpn\"\u003e@resultvpn\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Overview\n\nResultV **3.2.4** is a native desktop application built with **[Wails v2](https://wails.io/)**. The UI is **React 18** with **Vite** and **Tailwind CSS**; traffic is handled by a **Go** backend and **[sing-box](https://github.com/SagerNet/sing-box)** (with project-specific build tags in `wails.json`). The interface is localized with **i18next** (English and Russian).\n\n**Prebuilt releases:** GitHub Actions publishes **Windows amd64** artifacts (portable `.exe` and NSIS installer), **macOS** (`.dmg`) and **Linux** (`.AppImage`, `.deb`, `.rpm`) when a `v*` tag is pushed.\n\n---\n\n## Installation\n\nPrebuilt binaries live on the **[Releases](https://github.com/AandStep/ResultV/releases/latest)** page — you do **not** need to build from source with Wails.\n\n### Windows\n\nDownload the `*-installer.exe` (or the portable `.exe`) and run it.\n\n### macOS\n\nDownload `ResultV.dmg`, open it and drag the app into `Applications`.\n\n### Linux\n\nThe universal option for every distro is the **AppImage** — no installation required:\n\n```bash\nchmod +x ResultV*.AppImage\n./ResultV*.AppImage\n```\n\nIf the AppImage doesn't start, install FUSE (`fuse2`): on Debian/Ubuntu — `sudo apt install libfuse2`, on Fedora — `sudo dnf install fuse`, on Arch/CachyOS — `sudo pacman -S fuse2`.\n\n**Arch / CachyOS (and other Arch-based):** the AppImage runs natively (just needs `fuse2`, see above). The `.deb`/`.rpm` packages do not install directly — use the AppImage.\n\n**NixOS:** the AppImage **does not run directly** — the system has no standard FHS loader. Run it through a wrapper:\n\n```bash\nnix-shell -p appimage-run --run \"appimage-run ./ResultV*.AppImage\"\n```\n\nOr enable automatic AppImage execution in `configuration.nix` and rebuild:\n\n```nix\nprograms.appimage.enable = true;\nprograms.appimage.binfmt = true;\n```\n\nAfter that the AppImage launches with a plain `./ResultV*.AppImage`.\n\n**Debian / Ubuntu** — `.deb`: `sudo apt install ./ResultV*.deb`\n**Fedora / RHEL / openSUSE** — `.rpm`: `sudo dnf install ./ResultV*.rpm` (or `sudo zypper install`).\n\n\u003e Current builds target `linux/amd64` (x86_64).\n\n---\n\n## Features\n\n- **Proxy** and **Tunnel (TUN)** modes for system-wide routing where applicable\n- **Protocols:** HTTP, HTTPS, SOCKS5, **VLESS**, **VMESS**, **Trojan**, **Shadowsocks**, **WireGuard**, **AmneziaWG**, **Hysteria2**\n- **Subscriptions:** add, refresh, remove URL; grouping by provider/country where metadata is available\n- **Import:** paste from clipboard or bulk import from `.txt` / `.csv` / `.conf`\n- **Smart rules:** Global and Smart modes; **domain** and **application** exclusions (nested rules supported in the engine)\n- **Kill Switch**, optional **ad blocking**, **autostart**\n- **Encrypted export/import** of configuration (password-protected)\n- **Logs** view (UI and backend messages)\n- **System tray** integration;\n- **Update check** against `update.json` on GitHub (see [Updates](#updates))\n\n---\n\n## Supported protocols and constraints\n\n| Category | Protocols |\n|----------|-----------|\n| Classic proxy | HTTP, HTTPS, SOCKS5 |\n| VPN stack (sing-box) | VLESS, VMESS, Trojan, SS, WireGuard, AmneziaWG, Hysteria2 |\n\n**Important:**\n\n- **WireGuard** and **AmneziaWG** work only in **Tunnel** mode; they are unavailable in Proxy mode (checked in `internal/proxy/manager.go`).\n- **AmneziaWG 2.0** — full set of obfuscation fields: classic `Jc/Jmin/Jmax`, packet sizes `S1–S4`, headers `H1–H4`, special junk `I1–I5` + `Itime`, handshake junk `J1–J3`. In the UI they can be set in a structured editor (AmneziaWG tab) or in \"Raw JSON\" mode. URIs of the form `awg://...?Jc=5\u0026Jmin=10\u0026Jmax=50\u0026S1=16\u0026I1=...\u0026J1=...\u0026Itime=300` are accepted (both lower and upper case — AmneziaVPN clients provide `Jc/Jmin/...`).\n- Subscriptions in **JSON** (Xray format with `outbounds[]` and sing-box format with `type`) are parsed for all key protocols, including `wireguard`/`amneziawg` with an `amnezia` block.\n- **Tunnel** mode on Windows requires **running as Administrator**.\n- **Kill Switch** on Windows may require **administrator privileges** for firewall rules (`internal/system/killswitch_windows.go`).\n- If internet remains blocked after a crash or forced app termination, run in **PowerShell (Administrator)**:\n  `Get-NetFirewallRule -DisplayName 'ResultV_KillSwitch*' -ErrorAction SilentlyContinue | Remove-NetFirewallRule`\n- Some subscription providers enforce **HWID device limits**; the app sends a stable `x-hwid` when fetching subscriptions and shows the reason if the provider returned an empty response due to the limit.\n- **In case of issues**, please contact TG @resultpoint_manager.\n\n---\n\n## User guide\n\nScreenshots below show the **English** UI (files in [`docs/images/readme/`](./docs/images/readme/)).\n\n### Home\n\nConnect and disconnect, choose **Proxy** / **Tunnel** mode, switch servers, and see traffic summaries when connected.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/home-en.png\" width=\"720\" alt=\"Home\"\u003e\n\u003c/p\u003e\n\n### Buy proxy\n\nThe **Buy** tab links to partner offers ([impVPN:telegram](https://t.me/impVPNBot?start=NzQ3MDczMjUz)), ([impVPN:site](https://my.impio.space/?ref=NzQ3MDczMjUz)) - Best VPN servers at affordable prices, and with the promo code **result** a 20% bonus to the balance top-up. You can skip this step if you already have a server or a subscription.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/buy-en.png\" width=\"720\" alt=\"Buy proxy\"\u003e\n\u003c/p\u003e\n\n### Add server or subscription\n\nManual input, pasting **subscription links** and share-links, bulk import from clipboard or files.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/add-en.png\" width=\"720\" alt=\"Add server\"\u003e\n\u003c/p\u003e\n\n### Proxy list\n\nServer cards, **ping**, editing and deleting, working with groups from **subscriptions**, adding servers to favorites.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/list-en.png\" width=\"720\" alt=\"Proxy list\"\u003e\n\u003c/p\u003e\n\n### Smart rules\n\n**Global** and **Smart** modes; exclusion tabs by **sites** (e.g. `*.example.com`) and by **applications**.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/rules-1-en.png\" width=\"720\" alt=\"Smart rules\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/rules-2-en.png\" width=\"720\" alt=\"Smart rules\"\u003e\n\u003c/p\u003e\n\n### Logs\n\nInspect connection and routing messages to diagnose issues.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/logs-en.png\" width=\"720\" alt=\"Logs\"\u003e\n\u003c/p\u003e\n\n### Settings\n\n**Autostart**, **Kill Switch**, **ad blocking**, **custom DNS**, **listening to local network and setting a local port**, password-protected **export/import**.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/setting-1-en.png\" width=\"720\" alt=\"Settings\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/readme/settings-2-en.png\" width=\"720\" alt=\"Settings\"\u003e\n\u003c/p\u003e\n\n---\n\n## Updates\n\nThe app version is taken from the embedded `wails.json` / `GetVersion` and compared with the remote [`update.json`](https://raw.githubusercontent.com/AandStep/ResultProxy/main/update.json). Release metadata and notes are maintained in the root [`update.json`](./update.json).\n\n---\n\n## Development\n\n### Prerequisites\n\n- **Go:** version compatible with [`go.mod`](./go.mod) (see `go` and `toolchain` directives)\n- **Node.js:** **20+** recommended (CI uses **24** for releases)\n- **Wails CLI v2:** `go install github.com/wailsapp/wails/v2/cmd/wails@latest`\n- **Windows:** WebView2 runtime (usually present on current Windows 10/11)\n\n### Run in dev mode\n\nFrom the repository root:\n\n```bash\nwails dev\n```\n\nThis starts the Vite dev server with hot reload and connects it to the Go backend.\n\n---\n\n## Building\n\n### Local production build\n\n```bash\nwails build\n```\n\nAdd `-nsis` on Windows to produce an installer if NSIS is installed:\n\n```bash\nwails build -nsis\n```\n\nOutputs land under `build/bin/` (see [`build/README.md`](./build/README.md)).\n\n### CI releases\n\nThe [`.github/workflows/release.yml`](./.github/workflows/release.yml) workflow runs `wails build -clean -nsis -platform windows/amd64` and publishes GitHub Release assets.\n\n---\n\n## Tech stack\n\n| Layer | Technology |\n|-------|------------|\n| Shell | [Wails v2](https://wails.io/) |\n| UI | React 18, Vite, Tailwind CSS, i18next |\n| Backend | Go |\n| Proxy core | sing-box (see `go.mod` and replace directives), project build tags in [`wails.json`](./wails.json) |\n| Tray | getlantern/systray (platform-specific code under `internal/getlantern_systray/`) |\n\n---\n\n## License\n\nThis project is licensed under the **GNU General Public License v3.0** — see [`LICENSE`](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faandstep%2Fresultv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faandstep%2Fresultv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faandstep%2Fresultv/lists"}