{"id":51942165,"url":"https://github.com/drmikecrypto/v2rayf","last_synced_at":"2026-07-28T20:01:06.235Z","repository":{"id":367618401,"uuid":"1281613053","full_name":"drmikecrypto/v2rayF","owner":"drmikecrypto","description":"Cross-platform V2Ray/Xray proxy client for Windows, macOS, Linux and Android.","archived":false,"fork":false,"pushed_at":"2026-06-26T18:41:01.000Z","size":101,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-26T20:11:10.389Z","etag":null,"topics":["android","avalonia","cross-platform","desktop-app","proxy","shadowsocks","trojan","tun","v2ray","vless","vmess","vpn-client","xray"],"latest_commit_sha":null,"homepage":"https://github.com/drmikecrypto/v2rayF/releases/latest","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/drmikecrypto.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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-06-26T18:28:21.000Z","updated_at":"2026-06-26T18:41:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/drmikecrypto/v2rayF","commit_stats":null,"previous_names":["drmikecrypto/v2rayf"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/drmikecrypto/v2rayF","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fv2rayF","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fv2rayF/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fv2rayF/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fv2rayF/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/drmikecrypto","download_url":"https://codeload.github.com/drmikecrypto/v2rayF/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fv2rayF/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36006421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-28T02:00:06.341Z","response_time":109,"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":["android","avalonia","cross-platform","desktop-app","proxy","shadowsocks","trojan","tun","v2ray","vless","vmess","vpn-client","xray"],"created_at":"2026-07-28T20:01:05.496Z","updated_at":"2026-07-28T20:01:06.227Z","avatar_url":"https://github.com/drmikecrypto.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# v2rayF\n\n**Cross-platform proxy client** for [V2Ray](https://www.v2fly.org/) / [Xray](https://github.com/XTLS/Xray-core), Shadowsocks, and Trojan.\n\nImport servers from clipboard or subscription URLs, test latency, pick routing rules, connect with one click — on **Windows**, **macOS**, **Linux** (x64 \u0026 ARM64), and **Android** (ARM64).\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/drmikecrypto/v2rayF/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/tag/drmikecrypto/v2rayF?style=flat-square\u0026label=release\" alt=\"Latest release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/drmikecrypto/v2rayF/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/drmikecrypto/v2rayF/ci.yml?branch=main\u0026style=flat-square\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue?style=flat-square\" alt=\"License MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/drmikecrypto/v2rayF/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/drmikecrypto/v2rayF?style=flat-square\" alt=\"GitHub stars\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Download\n\n**[→ Latest release](https://github.com/drmikecrypto/v2rayF/releases/latest)** — pick the zip for your platform:\n\n| Platform | File | Run |\n|----------|------|-----|\n| Windows x64 | `v2rayF-win-x64.zip` | `v2rayF.exe` |\n| Windows ARM64 | `v2rayF-win-arm64.zip` | `v2rayF.exe` |\n| Linux x64 | `v2rayF-linux-x64.zip` | `./run-v2rayF.sh` |\n| Linux ARM64 | `v2rayF-linux-arm64.zip` | `./run-v2rayF.sh` |\n| macOS Intel | `v2rayF-osx-x64.zip` | `./run-v2rayF.sh` |\n| macOS Apple Silicon | `v2rayF-osx-arm64.zip` | `./run-v2rayF.sh` |\n| Android ARM64 | `v2rayF-android-arm64.zip` | Install `v2rayF-android-arm64.apk` |\n\nEach desktop package includes **Xray-core** and geo data (`geoip.dat`, `geosite.dat`) — no extra setup. The Android APK bundles the same core and geo files.\n\n\u003e **macOS first launch:** if Gatekeeper blocks the app, run `xattr -cr /path/to/folder` or right-click → Open once.\n\n---\n\n## Features\n\n- **Protocols** — VMess, VLESS (incl. REALITY), Shadowsocks, Trojan, SOCKS\n- **Import** — clipboard, paste box, subscription URL (`https://…`)\n- **Latency test** — per server or test all\n- **Routing** — Global, Bypass LAN, Bypass China, custom direct list\n- **TUN / VPN mode** — full-device capture (Admin on Windows; VPN permission on Android)\n- **System proxy** — Windows, macOS, GNOME, KDE, XFCE (desktop only)\n- **Tray icon** — status at a glance; minimize to tray while connected\n- **Local proxies** — SOCKS `127.0.0.1:10808`, HTTP `127.0.0.1:10809`\n\n---\n\n## Quick start\n\n1. Download and extract the zip for your OS from [Releases](https://github.com/drmikecrypto/v2rayF/releases/latest).\n2. Import your share link (`vless://…`, `vmess://…`, etc.) or subscription URL.\n3. Select a server → **Connect**.\n4. Browse — system proxy is set automatically (unless you use TUN-only mode).\n\nSee [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md) for routing, TUN, and troubleshooting.\n\n---\n\n## Screenshots\n\n\u003c!-- Add screenshots after first release: docs/images/main-window.png --\u003e\n_Screenshots coming soon — PRs welcome!_\n\n---\n\n## Build from source\n\n### Requirements\n\n- [.NET 10 SDK](https://dotnet.microsoft.com/download)\n- PowerShell 7+ (for packaging)\n\n### Run in dev (desktop)\n\n```bash\ngit clone https://github.com/drmikecrypto/v2rayF.git\ncd v2rayF\ndotnet run --project src/v2rayF.Desktop/v2rayF.Desktop.csproj\n```\n\nPlace `xray` / `xray.exe` in `src/v2rayF.Desktop/cores/` for local connects, or run the packager (downloads Xray automatically):\n\n```powershell\npwsh -File scripts/package-all.ps1\n```\n\n### Build Android APK\n\nRequires the [.NET Android workload](https://learn.microsoft.com/dotnet/android/overview):\n\n```powershell\ndotnet workload install android\npwsh -File scripts/package-android.ps1      # download Xray for Android assets\npwsh -File scripts/package-android-release.ps1\n```\n\nOutput: `dist/v2rayF-android-arm64.zip` containing the signed-ready APK.\n\n---\n\n## Project structure\n\n```\nv2rayF/\n├── src/\n│   ├── v2rayF.Core/      # Shared models \u0026 services (Xray, parsing, stores)\n│   ├── v2rayF/           # Shared Avalonia UI (ViewModels, Views)\n│   ├── v2rayF.Desktop/   # Desktop entry + bundled cores/\n│   └── v2rayF.Android/   # Android entry + VPN services\n├── scripts/              # Packaging \u0026 launch scripts\n├── .github/workflows/    # CI + release automation\n└── docs/\n```\n\n---\n\n## Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n- [Report a bug](https://github.com/drmikecrypto/v2rayF/issues/new?template=bug_report.md)\n- [Request a feature](https://github.com/drmikecrypto/v2rayF/issues/new?template=feature_request.md)\n- [Security issues](SECURITY.md)\n\n---\n\n## Legal \u0026 credits\n\n- Licensed under [MIT](LICENSE).\n- Uses [Xray-core](https://github.com/XTLS/Xray-core) (bundled in releases, not committed to this repo).\n- UI built with [Avalonia UI](https://avaloniaui.net/).\n\n**Use only on networks and servers you are authorized to access.** Circumventing restrictions may be illegal in your jurisdiction.\n\n---\n\n## Repository topics (for discoverability)\n\nWhen starring or forking, these topics help others find the project:\n\n`v2ray` `xray` `proxy` `vpn-client` `shadowsocks` `trojan` `vless` `vmess` `cross-platform` `avalonia` `android` `desktop-app` `tun`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrmikecrypto%2Fv2rayf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrmikecrypto%2Fv2rayf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrmikecrypto%2Fv2rayf/lists"}