{"id":13512064,"url":"https://github.com/Cenmrev/V2RayX","last_synced_at":"2025-03-30T22:31:54.867Z","repository":{"id":38345339,"uuid":"51430111","full_name":"Cenmrev/V2RayX","owner":"Cenmrev","description":"GUI for v2ray-core on macOS","archived":true,"fork":false,"pushed_at":"2023-03-20T07:08:01.000Z","size":23703,"stargazers_count":7677,"open_issues_count":118,"forks_count":1136,"subscribers_count":176,"default_branch":"master","last_synced_at":"2025-01-18T20:36:48.638Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Objective-C","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/Cenmrev.png","metadata":{"files":{"readme":"README.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}},"created_at":"2016-02-10T08:56:28.000Z","updated_at":"2025-01-18T05:42:59.000Z","dependencies_parsed_at":"2022-07-13T15:29:34.685Z","dependency_job_id":"825b5331-36de-46c2-a4a4-1318dc10f049","html_url":"https://github.com/Cenmrev/V2RayX","commit_stats":null,"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cenmrev%2FV2RayX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cenmrev%2FV2RayX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cenmrev%2FV2RayX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cenmrev%2FV2RayX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cenmrev","download_url":"https://codeload.github.com/Cenmrev/V2RayX/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246390896,"owners_count":20769475,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-08-01T03:01:27.694Z","updated_at":"2025-03-30T22:31:52.958Z","avatar_url":"https://github.com/Cenmrev.png","language":"Objective-C","readme":"# V2RayX: A simple GUI for V2Ray on macOS\n\n[![Build Status](https://travis-ci.org/Cenmrev/V2RayX.svg?branch=master)](https://travis-ci.org/Cenmrev/V2RayX)\n\n## What is V2Ray?\n\n__READ THIS__: [Project V2Ray](http://www.v2ray.com).\n\n__YOU SHOULD READ V2RAY'S OFFICIAL INSTRUCTION BEFORE USING V2RAYX!__\n\nOther V2Ray clients on macOS: [V2RayU](https://github.com/yanue/v2rayu).\n(Not related to or endorsed by authors of this repo. USE AT YOUR OWN RISK.)\n\n## Download V2RayX\n\nDownload from [Releases](https://github.com/Cenmrev/V2RayX/releases). (compiled by [travis-ci.org](https://travis-ci.org/Cenmrev/V2RayX)).\n\nBy [Homebrew-Cask](https://caskroom.github.io/).\n\n```sh\nbrew cask install v2rayx\n```\n\n## How to build\n\nV2RayX.app is built by running one of the following commands in your terminal. You can install this via the command-line with curl.\n\n`sh -c \"$(curl -fsSL https://raw.githubusercontent.com/Cenmrev/V2RayX/master/compilefromsource.sh)\"`\n\nor step by step:\n\n`git clone --recursive https://github.com/Cenmrev/V2RayX.git`\n\nopen V2RayX.xcodeproj and use Xcode to build V2RayX.\n\n## How does V2RayX work\n\nV2RayX provides a GUI to generate the config file for V2Ray. It includes V2Ray's binary executable in the app bundle. V2RayX starts and stops V2Ray with `launchd` of macOS.\n\nV2RayX also allows users to change system proxy settings and switch proxy servers on the macOS menu bar.\n\nAs default, V2RayX will open a socks5 proxy at port `1081` as the main inbound, as well as a http proxy at port `8001` as an inboundDetour.\n\nV2RayX provide three modes:\n* Global Mode: V2RayX asks macOS to route all internet traffic to v2ray core if the network traffic obeys operating system's network rules.\n* PAC Mode: macOS will determine the routing based on a pac file and some traffic may be routed to v2ray core.\n* Manual Mode: V2RayX will not modify any macOS network settings, but only start or stop v2ray core.\n\nOptions in menu list `Routing Rule` determine how v2ray core deals with incoming traffic. Core routing rules apply to all three modes above.\n\n### auto-run on login\n\nOpen macOS System Preferences -\u003e Users \u0026 Group -\u003e Login Items, add V2RayX.app to\nthe list.\n\n### manually update v2ray-core\nreplace `V2RayX.app/Contents/Resources/v2ray` with the newest v2ray \nversion from [v2ray-core \nrepo](https://github.com/v2ray/v2ray-core/releases). However, compatibility is not guaranteed.\n\n### Uninstall\n\nV2RayX will create the following files and folders:\n\n* `/Library/Application Support/V2RayX`\n* `~/Library/Application Support/V2RayX`\n* `~/Library/Preferences/cenmrev.V2RayX.plist`\n\nSo, to totally uninstall V2RayX, just delete V2RayX.app and the files above. :)\n\n## Acknowledge\n\nV2RayX uses [GCDWebServer](https://github.com/swisspol/GCDWebServer) to provide a local pac server. V2RayX also uses many ideas and codes from [ShadowsocksX](https://github.com/shadowsocks/shadowsocks-iOS/tree/master), especially, the codes of [v2rays_sysconfig](https://github.com/Cenmrev/V2RayX/blob/master/v2rayx_sysconf/main.m) are simply copied from [shadowsocks_sysconf](https://github.com/shadowsocks/shadowsocks-iOS/blob/master/shadowsocks_sysconf/main.m) with some modifications.\n\n## Donation\n\nIf Project V2Ray or V2RayX helped you, you can also help us by donation __in your will__. To donate to Project V2Ray, you may refer to [this page](https://www.v2ray.com/chapter_00/02_donate.html).\n\n## Disclaimer\n\nThis tool is mainly for personal usage. For professional users and technique \nsupport, commercial software like proxifier is recommended. Please refer to [#60](https://github.com/Cenmrev/V2RayX/issues/60#issuecomment-369531443).\n\nThe developer does not major in CS nor Software Engineer and currently is busy with grad school courses. So V2rayX will not be updated frequently. Users can replace V2RayX.app/Contents/Resources/v2ray with the newest v2ray-core downloaded from [https://github.com/v2ray/v2ray-core/releases](https://github.com/v2ray/v2ray-core/releases).\n\nThe developer currently does not have enough time to add more features to V2RayX, nor to merge PRs. However, forking and releasing your own version are always welcome.\n","funding_links":[],"categories":["Objective-C","自由上网","inbox"],"sub_categories":["科学上网"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCenmrev%2FV2RayX","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCenmrev%2FV2RayX","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCenmrev%2FV2RayX/lists"}