ManyProxy is a Windows desktop app for a personal library of proxy/VPN
configurations. It stores the configs, imports share links, files and
subscriptions, and serves each config on its own loopback endpoint —
socks5://127.0.0.1:<port> and http://127.0.0.1:<port> — so individual apps
can be pointed at the proxy they need. Health testing (URL test, TCP ping) shows
which endpoints actually work.
It is local-only by design: no system proxy, no TUN interface, no DNS rewrite, no elevation. Nothing outside the app folder and its own data folder is changed.
- Windows 10/11, x64 (windows-amd64) — the only supported target today.
windows-arm64is drafted behind a gated release row (see.github/workflows/release.yml); it is not supported yet.- Linux and macOS are tracked as an aspiration only (issue #6), not supported.
There is no web, mobile, or CLI edition — only the native desktop app.
- Download
manyproxy-v<tag>-windows-amd64.zipfrom GitHub Releases and unzip it anywhere you like (a normal folder, another drive, a USB stick). Each release also publishesSHA256SUMS.txt. - Keep the unzipped files together in one folder:
manyproxy.exe,sing-box.exe,sing-box-awg.exe,xray.exe, plusREADME.md,THIRD-PARTY-NOTICES.mdandlicenses/. - Run
manyproxy.exe. No installer, no administrator rights, no AppData or Program Files writes — the defaults bind to loopback only.
The beta has no code-signing story; the published SHA-256 hashes are the honesty floor, so compare them if you want to verify a download.
Engines must sit next to the exe. sing-box.exe (standard rows),
sing-box-awg.exe (AmneziaWG/Noise/XHTTP rows) and xray.exe (Xray-only VLESS
rows) are resolved from the app directory only — PATH is never consulted and
the app never downloads binaries. At most one extra, user-supplied core
executable can live in the same folder; reference its plain file name in the row
that uses it.
ManyProxy checks for a newer release once a week at launch and shows
Update available - Tools > Check for updates in the status bar; clicking it
opens the update dialog. Turn the weekly check off in Settings → Updates.
There is no auto-update. Replace the folder by hand with the new release (keep
or move data\ if you want to keep the old library).
Everything the app writes lives in data\ beside manyproxy.exe:
| Path | Contents |
|---|---|
data\library.db |
SQLite library: configurations, subscriptions, presets, health snapshots, usage totals |
data\manyproxy-export.json |
Default export path; written only after you confirm the plaintext-secret warning |
data\manyproxy-logs.txt |
Visible session logs |
data\library.db.bak-*, data\library.db.corrupt-* |
Automatic backups and quarantine copies |
Secrets at rest are sealed with Windows DPAPI (user scope, dpapi1: prefix);
logs, URLs and labels are redacted, and copied URLs carry bind + port only, never
credentials.
Uninstall = delete the folder. There is no installer, no uninstaller, and no
registry state beyond the opt-in HKCU Run autostart entry. Data outside the app
folder is never read or migrated. The MANYPROXY_DB, MANYPROXY_EXPORT and
MANYPROXY_LOGS environment variables override the paths above for testing.
- Add (
Ctrl-N) a configuration, or Import (Ctrl-O) share links, a file dropped on the window, clipboard text, or a WireGuard.conf. - Leave Port blank to auto-assign from the primary range
10801–10999(spillover18081–18380), or type a port. - Select the row and press Start (
F5), or Start all to start every row. Starting regenerates one combined engine config, runs the engine's owncheck, then (re)starts the sidecar. Stop with Stop (Shift-F5) or Stop all; stopping clears the row's restore-on-launch flag. That flag (row menu → Restore on launch) decides which rows the next launch reopens — Start all ignores it and starts every row. - Copy URLs (
Ctrl-U) copies both forms for the row:socks5://127.0.0.1:<port>andhttp://127.0.0.1:<port>. Point one app at one endpoint — apps with separate SOCKS5/HTTP fields take the matching line. - Test (
Ctrl-T) runs a URL test againsthttp://www.gstatic.com/generate_204; Ping does a TCP ping. Results stay on the row (87ms/dead) and inhealth: N live · M deadon the status bar.
Closing the window while endpoints run opens a confirm naming every running row: OK stops all and closes, Cancel keeps them running. The tray icon offers Start all / Stop all / Show / Quit.
| Action | Keys |
|---|---|
| Add config | Ctrl-N |
| Import configs | Ctrl-O |
| Paste clipboard into Import | Ctrl-V |
| Start selected | F5 |
| Stop selected | Shift-F5 |
| Test selected | Ctrl-T |
| Stop Testing | Ctrl-. |
| Edit endpoint | Ctrl-E |
| Edit config | Ctrl-Shift-E |
| Delete selected | Delete |
| Extend selection up / down | Shift-Up / Shift-Down |
| Move focus up / down | Up / Down |
| Move focus to first / last row | Home / End |
| Toggle focused row | Space |
| Select all visible | Ctrl-A |
| Focus search | Ctrl-F |
| Toggle inspector | Ctrl-I |
| Toggle console | Ctrl-` |
| Clear selection | Esc |
| Copy URLs | Ctrl-U |
| Command palette | Ctrl-K |
| Update the current scope | Ctrl-R |
The same list appears in the About dialog and Settings → Shortcuts, and these
key-bound actions also have action-bar or nav entries and Ctrl-K palette
twins.
No system proxy switching, no TUN / virtual interface, no OS DNS rewrite, no
routing-rule editor, no admin/elevation path, no auto-update that replaces
binaries, no telemetry, and no silent binary downloads. The network traffic the
app originates is a subscription fetch, the GitHub release feed (once a week at
launch, or when you press Check for updates; Settings → Updates can turn the
weekly read off), explicit throne://remoteroute/ fetches, and probes through
your own endpoints to the visible test URL. These are durable constraints,
covered by the assert_no_system_mutation test family.
- Engine binary not found. Start fails with an error naming the affected
rows, the expected file name, and every directory searched, ending with
ManyProxy never downloads executables silently. Put the named exe (sing-box.exe,sing-box-awg.exe,xray.exe, or your extra-core exe) next tomanyproxy.exeand start again. A file quarantined by antivirus surfaces the same way — never a silent fallback. - Port already in use. The second start fails naming both configs; the first one keeps serving. Edit the row's Port (blank = a fresh auto port) or stop the other endpoint, then start again.
- Non-loopback bind. Any non-loopback bind (
0.0.0.0,::, a LAN address) stops at an explicit confirm naming the config and bind before anything starts; dismissing changes nothing. A firewall prompt for such a bind is Windows' own and expected. - The library looks empty. A read failure shows
Cannot load library: …instead of an empty list; if the list saysNo proxy configurations yet, the store really has no rows. - Subscription refresh failed. The row keeps its last-good members and shows the error. Common causes: unreachable URL, non-2xx response, a body over 8 MiB, or a non-UTF-8 body.
- SmartScreen / antivirus warning. Unsigned fresh binaries that spawn
sidecars and listen on loopback routinely trip heuristics. Verify the file
against
SHA256SUMS.txt; never disable antivirus.
Accepted: vless://, vmess:// (URI and legacy base64 JSON), trojan://,
ss:// / shadowsocks:// (all three grammars), hysteria2:// / hy2:// /
hysteria2+realm://, hysteria://, tuic://, wireguard://, awg:// /
amneziawg:// / amnezia-wg://, socks:// / socks5://, http:// /
https://, anytls://, naive://, throne://add/..., sing-box outbound JSON
(single object, array, or full config), Xray protocol-shaped objects, SIP008
servers[], limited Clash proxies[] YAML, and WireGuard .conf (one config
per [Peer]).
Malformed items are listed per item as item N (label): reason; valid items
still land as disabled rows, and import never starts anything. Identical
re-imports add nothing. throne://addsub/... lines create a subscription and
refresh it once; throne://route/... links import into routing presets and
throne://remoteroute/... URLs fetch explicitly without auto-refresh.
Toolbar Subscriptions opens the manager: label, subscription URL, group and an auto-refresh checkbox (default on, 24 h interval). Each row shows the redacted URL, group, member count, auto flag, last error, and per-item failures, with Refresh / Auto on|off / Remove buttons. Refresh fetches with an 8 MiB cap, a 20 s timeout and UTF-8 required; errors never echo the URL. Merges keep your renames, add no duplicates, un-own upstream removals but leave hand rows untouched, and keep the last-good set on failure. A background 5-minute tick picks up due subscriptions (at most one coalesced toast).
Toolbar Export opens a confirm that shows the plaintext warning verbatim
("Export carries private keys, tokens, and passwords in plaintext. Anyone with
this file can use your proxies — store it somewhere safe.") plus a preview
N config(s) → <path>. Confirm writes JSON (configs + subscriptions) to the
default export path; cancel writes nothing. The payload round-trips through the
import grammar, so re-import adds 0 new rows and reports duplicates.
A row's Share action copies a manyproxy://add/... link that carries the
endpoint's credentials. To open such links from a browser, chat, or Windows Run,
turn on Settings → General → Handle manyproxy:// links. ManyProxy registers
itself as the manyproxy:// handler for your Windows account; opening a link
then launches ManyProxy and shows the same Add preview a pasted link would.
The switch's help line says whether the registration points at this exe, and
turning it off removes it. manyproxy://addsub/... links open the subscription
intake.
Each row shows persisted health samples and data-plane usage (↓rx ↑tx, from
the engine's own metering); probe-only bytes stay labeled probe: so the two
never mix. Logs opens the sidecar log for the selected config (or the global
session log) with a filter field; secrets are redacted at ingest. Health state
survives restarts; the health and usage counters can be cleared from Settings →
Maintenance.
cargo run # dev run (no admin needed for loopback defaults)
cargo fmt --check
cargo clippy --all-targets --locked -- -D warnings
cargo test --locked # live proofs are opt-in and skipped by default
Live proofs need a local sing-box.exe plus MANYPROXY_SINGBOX_BIN,
MANYPROXY_LIVE_CHECK=1 and (for traffic) MANYPROXY_LIVE_TRAFFIC=1; CI runs
them from .github/workflows/live.yml only.
| README claim | Proved by |
|---|---|
| Toolbar buttons + dialogs + footers | Button::new("add-config"/"import-config"/"import-clipboard"/"export-library"/"subscriptions"/"engine-start-all"/"engine-stop-all"/"health-test-all"/"about-dialog"/"edit-config"/"delete-config"/"copy-urls"/"engine-start"/"engine-stop"/"health-test"/"health-ping"/"logs-open") keys live in the control's tooltip and in Settings → Shortcuts, never inside the label (toolbar_*_tooltip tests, ticket 33), open_add_dialog / open_edit_dialog / open_import_dialog / open_export_dialog / open_logs_dialog / open_about_dialog / subscription_row, dialog_footer; dialog_footers_audit_every_plain_dialog (ticket 18) |
| Defaults + auto port | DEFAULT_BIND/PROTOCOL/GROUP and AUTO_PORT_START/END = 10801–10999 + spillover AUTO_PORT_SPILL_START/END = 18081–18380 (crates/core/src/store.rs), parse_port_field("") = auto, auto_ports_are_unique |
| Accepted formats | crates/core/src/import.rs parsers + tickets 03/07/08/15 tests (239+ passing incl. paste_and_drop_agree, conf_file_holding_json_or_links_is_sniffed, pasted_clash_yaml_imports, bom_prefixed_json_parses) |
| Toasts honest | row_action_message("Added"/"Updated"), removed_message, start_all_message / stop_all_message / already_stopped_message, export_count_message, coalesced_refresh_message (crates/ui/src/text.rs); ticket 17 UI tests |
| Subscriptions/auto-refresh | fetch_subscription_body, redact_subscription_url, due_for_refresh + DEFAULT_AUTO_REFRESH_SECS, DUE_SUBSCRIPTION_TICK_SECS, refresh_with_body tests |
| Endpoints/copy URLs | proxy_urls (crates/core/src/store.rs), copy_selected_urls + copy_urls_carry_binds_not_secrets |
| Health/search | DEFAULT_TEST_URL, test_all_health / test_selected_health / ping_row, library_row_matches, health_status_text |
| Export | export_warning_text verbatim + export_warning_names_secret_classes, default_export_path, commit_export, export_preview_description |
| Missing binaries / LAN / no-mutation | EngineError::MissingBinary + missing_binaries_state_never_downloads, requires_lan_confirm + LAN_CONFIRM_TITLE + lan_hint_for_bind, assert_no_system_mutation + session_fingerprint_roundtrip_proves_no_residue |