https://github.com/hopsayer/vless-win-starter
Double-click tool to start VLESS proxy (VPN) on your Windows computer.
https://github.com/hopsayer/vless-win-starter
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
Last synced: 6 months ago
JSON representation
Double-click tool to start VLESS proxy (VPN) on your Windows computer.
- Host: GitHub
- URL: https://github.com/hopsayer/vless-win-starter
- Owner: hopsayer
- License: gpl-3.0
- Created: 2025-11-16T03:10:48.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-11-16T11:34:40.000Z (7 months ago)
- Last Synced: 2025-11-16T13:15:14.782Z (7 months ago)
- 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
- Language: Batchfile
- Homepage:
- Size: 85.9 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VLESS Windows Starter
Simple one-click VLESS proxy starter for Windows using sing-box.
\+ VLESS link parsing explained simply
## Features
- Extremely simple: one-button proxy enable/disable.
- Minimal configuration
- Auto dependency pulling
- Most compatible version (1.9.7) of most modern proxy engine (sing-box), downloaded automatically on first run
- AK47-like - simple and reliable
## What it does
- Starts `sing-box.exe` on `127.0.0.1:1084`
- Enables system-wide proxy on `127.0.0.1:1084`
- Keeps the proxy active while the `cmd` window is open. As long as you see the window, the proxy is active.
- On key press, disables proxy and terminates `sing-box.exe`
## Requirements
- Windows 10 or newer
- Internet connection
## Required folder structure
```
internet-enabler/
├── prepare-and-start.bat
├── config.json (your version based on config-filled-fake.json)
└── sing-box.exe
```
## How to use
I. Download *this repository* or `files-as-archive.zip` or just files separately: `config-filled-fake.json` and `prepare-and-start.bat`
II. Rename `config-filled-fake.json` to `config.json`
---
III. Fill `config.json` with your server details:
Get your VLESS key.
Usually you have VLESS subscription link starting with `https://`. Open it in browser.
There you will have your VLESS key starting with (`vless://...`):
```example
vless://e6179c4d-e162-42ea-a71c-7jc96114f238@maskyshow.online:443?security=reality&type=tcp&headerType=&flow=xtls-rprx-vision&path=&host=&sni=whitelist.com&fp=random&pbk=Vdbpg8ljhhgzgx4g4uNJklXzlrMCd9L1igJSWrRUvLp&sid=8k222b3475800923
```
Paramenters for config are inside of key. You need to move them accordingly to config.
Use the table:
| in link | value | in config | value |
| --------- | ------------------------------------------- | ---------------------- | ------------------------------------------- |
| uuid | e6179c4d-e162-42ea-a71c-7jc96114f238 | uuid | e6179c4d-e162-42ea-a71c-7jc96114f238 |
| server | maskyshow.online | server | maskyshow.online |
| port | 443 | server_port | 443 |
| flow | xtls-rprx-vision | flow | xtls-rprx-vision |
| sni | whitelist.com | server_name | whitelist.com |
| pbk | Vdbpg8ljhhgzgx4g4uNJklXzlrMCd9L1igJSWrRUvLp | public_key | Vdbpg8ljhhgzgx4g4uNJklXzlrMCd9L1igJSWrRUvLp |
| sid | 8k222b3475800923 | short_id | 8k222b3475800923 |
| fp | random | fingerprint | random |
---
Or using Nekoray:
1. Download: https://github.com/MatsuriDayo/nekoray/releases/download/4.0.1/nekoray-4.0.1-2024-12-12-windows64.zip
2. Import your VLESS subscription/key into Nekoray
3. Export ready VLESS config from it: `Share` > `Export sing-box config (Ctrl+E)`
You will get config.json too, but not so manually.
---
IV. When config.json is in place and filled, run `prepare-and-start.bat`, Admin rights should be unneeded.
You must see non-red lines of log:
```
INFO[0000] inbound/mixed[mixed-in]: tcp server started at 127.0.0.1:1084
INFO[0000] sing-box started (0.11s)
```
**Do NOT close the window**
V. 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).
**If you have already lost Internet connection:**
- A-way. Run the `.bat` again. Press any key. Close the window.
- B-way. Go to system settings, find `proxy` (system proxy), disable it.
After 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!
## How to check if proxy works
1. Open https://whoer.net in browser
2. Check if your IP/country location changed
## Known issues
- 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.
- 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.
## Security Warning
- Never share your `config.json` file - it contains your credentials
- Keep this folder private
- Use only trusted VLESS servers
---
Page Views:
