Skip to content

About

Desktop VPN client for Windows: Hysteria2, AmneziaWG and VLESS in one app, routes by site and by program, kill switch, network check. Works with Mistgate panels and plain subscription links

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Mistgate logo

Mistgate for Windows

A VPN app that finds a working way on its own and says honestly when something is blocked.
Hysteria2, AmneziaWG, VLESS and TrustTunnel in one window. For Mistgate panels and for plain subscription links.

Status: beta Version Licence: AGPL-3.0 CI Windows 10 and 11, x64 Go version Tauri 2

Download · Features · Protocols · Install · Build · Русский · 简体中文 · فارسی · Türkçe

Beta. Version 0.1, Windows only. Expect changes before 1.0.

The main window: connected, the server list on the right

The pictures on this page are the app's own screens filled with sample data.

What it does

You add a subscription once. The app keeps the server list up to date, connects with the protocol that works on the network you are on, and sends through the VPN only what you want there.

  • One switch, four protocols. Hysteria2, AmneziaWG, VLESS and TrustTunnel. Auto takes the server that answers quickest right now; you can also pick the server and the protocol yourself.
  • With a Mistgate panel, and without one. Paste a subscription link, hysteria2://, vless:// or tt:// links, a Mihomo profile or an AmneziaWG config. On a Mistgate panel the app enrols this PC with its own key, follows the panel's servers, and shows the plan, the data used and the devices.
  • Routes. Smart leaves local sites and the home network outside the VPN, Only selected sends through it just what you pick, Everything sends all of it. Rules by ready-made collections, your own lists, sites and programs.
  • Kill switch. While the tunnel is down nothing leaves the PC: while connected, or always.
  • Network check. One button shows which servers and which ways to them work from here.
  • Local proxy. SOCKS5 and HTTP for the programs and the home devices that cannot use the VPN directly.
  • Telegram proxies from the panel: one press hands a proxy to Telegram.
  • The rest. A quick panel in the tray, Windows notifications, dark and light themes, five languages: English, Russian, Chinese, Persian, Turkish.
  • Updates from this repository's releases. The app installs only an installer signed with the project's key.
Routes: three modes, collections, programs and sites Settings: kill switch, start with Windows, protocol
Routes: what goes through the VPN and what does not Settings

Protocols

Protocol In the app What it takes
Hysteria2 The official Hysteria2 core, linked in UDP (QUIC). Salamander obfuscation, port hopping.
AmneziaWG amneziawg-go, linked in Versions 2.0 and 3.1, a key per device from a Mistgate panel or a .conf file.
VLESS Xray-core, linked in REALITY or TLS; RAW with Vision, XHTTP and WebSocket.
TrustTunnel The app's own client HTTP/2 over TLS, TCP and UDP. The certificate is checked against the system's roots or the pin a panel sends.

All four run inside one Windows service and one wintun adapter. Not supported: VMess, Trojan, Shadowsocks, TUIC and plain WireGuard.

Install

The setup program

Windows 10 or 11, x64.

  1. Take MistgateSetup_<version>_x64.exe from the latest release and run it.
  2. Windows asks for administrator rights once: the app adds a background service that owns the tunnel.
  3. Paste your subscription link and press the big button.

The installer has no Windows code-signing certificate yet, so SmartScreen may warn about an unknown publisher. Updates are checked differently, by the project's own signature: how updates work.


How it is built

Part What it is
core/ The service, in Go (mistgate-clientd, runs as LocalSystem): the tunnel, the routes, the kill switch, the subscriptions, the network check.
ui/ The window, the tray panel and the setup program: Tauri 2 with a small React shell. It talks to the service over one named pipe that accepts only the installed app.
design/ The screens as designed. ui/src/screens is generated from them; the ui/src/live*.ts layers put the real state in.
docs/ Building, the pipe's protocol, the panel's client API.
cd ui
pnpm install
pnpm bundle

Needs Go, Rust (MSVC) and Node with pnpm. Details, and the Go versions that must not be used, are in docs/build.md.

Privacy

  • Device keys and server credentials live in a store that Windows encrypts for the service's own account.
  • The log holds no keys, links, server addresses, names of sites or of programs.
  • The app tells the panel nothing about what you open. A debug bundle leaves the PC only when you press send, and the app shows it line by line first.

The full list of what the app connects to, and when, is in PRIVACY.md.

Code signing policy

The Windows installer is not signed with a code-signing certificate yet. The project has applied for free code signing provided by SignPath.io, certificate by SignPath Foundation; until that is granted, check a download against the SHA-256 printed in its release notes.

  • Committers and reviewers: the members of the Mistgate organisation. Every change from outside the team is reviewed before it is merged.
  • Approvers: the owners of the Mistgate organisation. Every release is approved by an owner before it is signed.
  • Releases are built from this repository's source by its build scripts, with nothing added by hand.
  • The installer tells what it adds (a background service) before it starts, and the app is removed through Windows' "Installed apps", which also removes the service.
  • Privacy: PRIVACY.md.

Status

It is beta and young. Not there yet: a Windows code-signing certificate, an uninstall screen of its own, macOS and Linux builds. If something does not work, open an issue.

Licence

AGPL-3.0. The libraries it links keep their own licences, among them Xray-core (MPL-2.0), Hysteria, amneziawg-go, gVisor and wintun: the whole list is in THIRD_PARTY.md.

About

Desktop VPN client for Windows: Hysteria2, AmneziaWG and VLESS in one app, routes by site and by program, kill switch, network check. Works with Mistgate panels and plain subscription links

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages