{"id":33337100,"url":"https://github.com/hopsayer/vless-win-starter","last_synced_at":"2025-11-22T08:02:21.880Z","repository":{"id":324474052,"uuid":"1097366333","full_name":"hopsayer/vless-win-starter","owner":"hopsayer","description":"Double-click tool to start VLESS proxy (VPN) on your Windows computer.","archived":false,"fork":false,"pushed_at":"2025-11-16T11:34:40.000Z","size":88,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-16T13:15:14.782Z","etag":null,"topics":["batch","batch-script","launcher","proxy","script","sing-box","sing-box-client","sing-box-config","starter","vless","vless-reality","vless-reality-vision","vless-tcp","vpn","vpn-client","vpn-key","windows","xray-engine","xtls-reality","xtls-rprx-vision"],"latest_commit_sha":null,"homepage":"","language":"Batchfile","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/hopsayer.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,"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":"2025-11-16T03:10:48.000Z","updated_at":"2025-11-16T12:56:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hopsayer/vless-win-starter","commit_stats":null,"previous_names":["hopsayer/vless-win-starter-simple","hopsayer/vless-win-starter"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/hopsayer/vless-win-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hopsayer%2Fvless-win-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hopsayer%2Fvless-win-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hopsayer%2Fvless-win-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hopsayer%2Fvless-win-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hopsayer","download_url":"https://codeload.github.com/hopsayer/vless-win-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hopsayer%2Fvless-win-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285573085,"owners_count":27194648,"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","status":"online","status_checked_at":"2025-11-21T02:00:06.175Z","response_time":61,"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":["batch","batch-script","launcher","proxy","script","sing-box","sing-box-client","sing-box-config","starter","vless","vless-reality","vless-reality-vision","vless-tcp","vpn","vpn-client","vpn-key","windows","xray-engine","xtls-reality","xtls-rprx-vision"],"created_at":"2025-11-21T07:00:19.811Z","updated_at":"2025-11-21T07:00:44.716Z","avatar_url":"https://github.com/hopsayer.png","language":"Batchfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VLESS Windows Starter \n\nSimple one-click VLESS proxy starter for Windows using sing-box. \n\n\\+ VLESS link parsing explained simply\n\n\u003cimg width=\"1003\" height=\"549\" alt=\"image\" src=\"https://github.com/user-attachments/assets/94dc9064-0fa6-4b20-876d-1a26cae20f73\" /\u003e\n\n## Features\n\n- Extremely simple: one-button proxy enable/disable. \n- Minimal configuration\n- Auto dependency pulling\n- Most compatible version (1.9.7) of most modern proxy engine (sing-box), downloaded automatically on first run\n- AK47-like - simple and reliable\n\n## What it does\n\n- Starts `sing-box.exe` on `127.0.0.1:1084`\n- Enables system-wide proxy on `127.0.0.1:1084`\n- Keeps the proxy active while the `cmd` window is open. As long as you see the window, the proxy is active.\n- On key press, disables proxy and terminates `sing-box.exe`\n\n\n## Requirements\n\n- Windows 10 or newer\n- Internet connection\n\n## Required folder structure\n\n```\ninternet-enabler/\n├── prepare-and-start.bat\n├── config.json (your version based on config-filled-fake.json)\n└── sing-box.exe\n```\n\n## How to use\n\nI. Download *this repository* or `files-as-archive.zip` or just files separately: `config-filled-fake.json` and `prepare-and-start.bat`\n\nII. Rename `config-filled-fake.json` to `config.json`\n\n---\nIII. Fill `config.json` with your server details:\n\nGet your VLESS key. \nUsually you have VLESS subscription link starting with `https://`. Open it in browser.\nThere you will have your VLESS key starting with (`vless://...`):\n\n```example\nvless://e6179c4d-e162-42ea-a71c-7jc96114f238@maskyshow.online:443?security=reality\u0026type=tcp\u0026headerType=\u0026flow=xtls-rprx-vision\u0026path=\u0026host=\u0026sni=whitelist.com\u0026fp=random\u0026pbk=Vdbpg8ljhhgzgx4g4uNJklXzlrMCd9L1igJSWrRUvLp\u0026sid=8k222b3475800923\n```\n\nParamenters for config are inside of key. You need to move them accordingly to config. \nUse the table:\n     \n| in link   | value                                       | in config              | value                                       |\n| --------- | ------------------------------------------- | ---------------------- | ------------------------------------------- |\n| uuid      | e6179c4d-e162-42ea-a71c-7jc96114f238        | uuid                   | e6179c4d-e162-42ea-a71c-7jc96114f238        |\n| server    | maskyshow.online                            | server                 | maskyshow.online                            |\n| port      | 443                                         | server_port            | 443                                         |\n| flow      | xtls-rprx-vision                            | flow                   | xtls-rprx-vision                            |\n| sni       | whitelist.com                               | server_name            | whitelist.com                               |\n| pbk       | Vdbpg8ljhhgzgx4g4uNJklXzlrMCd9L1igJSWrRUvLp | public_key             | Vdbpg8ljhhgzgx4g4uNJklXzlrMCd9L1igJSWrRUvLp |\n| sid       | 8k222b3475800923                            | short_id               | 8k222b3475800923                            |\n| fp        | random                                      | fingerprint            | random                                      |\n\n---\n\nOr using Nekoray:\n1. Download: https://github.com/MatsuriDayo/nekoray/releases/download/4.0.1/nekoray-4.0.1-2024-12-12-windows64.zip\n2. Import your VLESS subscription/key into Nekoray\n3. Export ready VLESS config from it: `Share` \u003e `Export sing-box config (Ctrl+E)`\n   You will get config.json too, but not so manually.\n\n---\n\nIV. When config.json is in place and filled, run `prepare-and-start.bat`, Admin rights should be unneeded. \n\nYou must see non-red lines of log:\n```\nINFO[0000] inbound/mixed[mixed-in]: tcp server started at 127.0.0.1:1084\nINFO[0000] sing-box started (0.11s)\n\u003crunning lines\u003e\n```\n\n**Do NOT close the window**\n\nV. To stop proxy, **press any button in console window**, so it can make necessary quit routines for proper closure. Otherwise you will lose Internet connection till you fix it (see below). \n\n**If you have already lost Internet connection:**\n- A-way. Run the `.bat` again. Press any key. Close the window. \n- B-way. Go to system settings, find `proxy` (system proxy), disable it.\n\nAfter you disabled proxy, it can take some time to reset to your default network mode (0-60 sec usually). If it does not, go to system settings, find `proxy` (system proxy), just look at it and close the window. Windows-magic!\n\n## How to check if proxy works\n\n1. Open https://whoer.net in browser\n2. Check if your IP/country location changed\n\n## Known issues\n- System proxy settings window must not be open during toggling proxy on and off. Otherwide changes will not be accepted by Windows for unknown reason. \n- If you ran `.bat` and system proxy settings window shows that proxy is active but actually this is not so, you need to press `Save` in that window. It will solve the problem, for unknown reason. \n\n## Security Warning\n\n- Never share your `config.json` file - it contains your credentials\n- Keep this folder private\n- Use only trusted VLESS servers\n\n---\n\nPage Views:\n\n![Views](https://komarev.com/ghpvc/?username=hopsayer\u0026repo=vless-win-starter-simple\u0026color=green\u0026style=flat-square)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhopsayer%2Fvless-win-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhopsayer%2Fvless-win-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhopsayer%2Fvless-win-starter/lists"}