Happ Proxy: Proxy for Happ — How to Enable and Configure It
"Happ Proxy" means using the Happ app in proxy mode to route traffic through a server. It runs on the same Xray-core engine as a regular connection, and you get the access key in the service Telegram bot.
What Happ Proxy is
How it works
The Happ app connects to a server and routes your traffic through it — like a proxy client based on Xray-core.
Proxy and VPN
The idea is similar: in both cases traffic goes through a remote server with a key. Setup is the same in the app.
What you need
The Happ app, a key or subscription link from the Telegram bot, and a chosen server.
Set up in 3 steps
1. Install Happ
Download the app for your platform on the Download page.
2. Add the key
Copy the key from the bot and paste it into the app — see Setup.
3. Connect
Pick a server and turn the connection on. If something is off, see Not working.
What Happ Proxy Is and How Proxy Mode Works
Happ Proxy is the transport layer of the Happ client that wraps application traffic in an encrypted tunnel to a chosen server. Unlike the classic "all traffic through one VPN" scheme, the proxy for Happ works selectively: it brings up a local proxy endpoint on the device and, based on defined rules, decides which connection to send through the server and which to keep direct. It is precisely this selectivity that makes Happ a configuration tool rather than just a "connect" button.
Under the hood, Happ supports modern transports — VLESS, VMess, Trojan, and Shadowsocks — which are passed to the app via a subscription link. The client parses the subscription, extracts the node parameters (address, port, encryption method, TLS/Reality, SNI), and keeps them ready as profiles. You switch between profiles without reinstalling — only the active route changes.
The practical point of proxy mode is stability and control. You yourself determine whether a banking app bypasses the tunnel while streaming goes through a server in the desired region. On top of this logic are built the exclusion lists and split tunneling discussed below, as well as selecting servers for a specific task.
How to Enable the Proxy for Happ: Step-by-Step Setup
Step 1 — add a subscription. Open Happ, go to the section with profiles/configurations, and paste the subscription link (in happ://, vless://, or an https subscription link format). The client will pull in the list of available nodes. If there is one link but several nodes — that is normal: a subscription usually contains a pool of servers.
Step 2 — choose a node and protocol. For the first launch, take the geographically closest server on VLESS + Reality or Trojan: they hold the connection better on unstable networks. Tap the node to make it active and run a latency test (ping) — it will show the real response, not just a green checkmark.
Step 3 — activate the tunnel. Press the connect button. On Android, the system will request permission to create a VPN interface — this is the standard mechanism through which the proxy intercepts traffic. On Windows, full TUN mode uses the Happ Utility (see the /proxy-utility/ section), which brings up a system network adapter.
Step 4 — check the route. Open any IP-checking service and make sure the address has changed to the server's address. If the IP stayed the same — the traffic is going past the tunnel, and you should check the routing mode and the app's permissions.
Routing and Exclusion Lists (Split Tunneling)
Exclusion lists in Happ determine which domains and apps bypass the tunnel and which go through the server. This is the core of fine-tuning: a properly composed list reduces the load on the server, speeds up local services, and eliminates unnecessary switching. You can work with the lists using two logics — "through the proxy by default, exceptions direct" or the other way around.
Split tunneling by application is available on Android and in TUN mode on Windows: you mark specific apps for which the tunnel is turned on or off. A typical scenario is to keep the bank, local banking, and apps sensitive to a region change out of the tunnel, while leaving messengers and media on the server. A detailed breakdown of the modes is on the /split-tunneling/ page.
For domain routing, rules based on lists are used: geosite/geoip sets let you send an entire category (for example, local resources) direct with a single rule, and everything else through the server. Start with a ready-made set, then add pinpoint exclusions as needed — that way the list stays manageable and does not turn into a dump of hundreds of manual lines.
After each edit to the list, restart the connection and check the result on real domains. Rules are applied in priority order: a more specific rule must sit above a general one, otherwise the broad rule will intercept the traffic first.
Optimizing Connection Speed and Stability
The speed of the proxy for Happ is determined by three factors: the proximity and load of the server, the chosen transport, and the network parameters. Start with the servers — run a ping across several subscription nodes and choose not the "prettiest" one, but the one most stable in response. Selecting nodes for specific tasks is covered in the /servers/ section.
The transport affects resistance to packet loss. On mobile networks and Wi-Fi with interference, UDP-based solutions (for example, connections over QUIC/Reality) often give smoother speed, while on strict corporate networks TCP+TLS holds up better. If drops keep happening, switch the protocol in the profile and compare.
Fine-tuning at the network level helps with "floating" speed: reducing the MTU (to around 1400 on problematic lines) removes fragmentation, and enabling mux/multiplexing lowers the overhead on many short connections. Change one parameter at a time and measure — otherwise it is impossible to tell what actually helped.
On Windows, the Happ Utility is responsible for the stability of TUN mode and correct interception of system traffic. Keep it updated: conflicts with third-party network filters and old adapter drivers are a common cause of slowdowns. Encryption and connection-protection questions are moved into the /security/ section.
Diagnostics: If the Proxy Won't Connect
If the connection won't come up, move from simple to complex. First, update the subscription — the nodes in the pool may have changed, and the client is holding outdated addresses. A single tap on "update subscription" pulls in the current parameters without recreating the profile.
Check the system time and time zone. Transports with TLS/Reality are sensitive to a clock mismatch: a discrepancy of a few minutes breaks the handshake, and externally this looks like "the server is not responding." Enable automatic time synchronization.
Change the node and protocol. If one server is silent while a neighboring one from the same subscription works — the problem is on the node's side, not the client's. If all of them are silent, the issue is more often in the provider's network: try a different transport, changing the SNI, or connecting via mobile internet to check. A detailed troubleshooting checklist is gathered in the support section.
Finally, check the routing and exclusion lists. An error in a rule or too broad an exclusion can steer all the traffic past the tunnel, creating the illusion that "the proxy isn't working." Temporarily disable the custom rules, make sure the basic connection is alive, and add the rules back one at a time.
Frequently asked questions
How does Happ's proxy mode differ from a regular VPN?
A classic VPN wraps the device's entire traffic into a tunnel wholesale. Happ Proxy works selectively: it brings up a local proxy and, by your rules, decides what to send through the server and what to keep direct. This gives control over routing, exclusion lists, and split tunneling — the very things Happ is configured for.
How do I add a proxy for Happ if I only have a subscription link?
Open Happ, go to the profiles section, and paste the subscription link (happ://, vless://, or an https link). The client will parse it and show the list of available nodes. Choose the closest server, check the ping, and press connect. One subscription usually contains several nodes — you can switch between them without adding them again.
What should I do if the IP doesn't change after connecting?
That means the traffic is going past the tunnel. Check that the node is actually active, that the routing mode isn't sending the needed domains into exclusions, and that the app is allowed through the tunnel in split tunneling. On Windows, make sure the Happ Utility is running and the TUN adapter is up. After the changes, restart the connection and check the IP again.
How do I set up exclusion lists so that some apps go direct?
Use split tunneling by application (Android and TUN mode on Windows): mark the apps that should bypass the tunnel — for example, banking ones. For domains, apply rules based on geosite/geoip sets: route local resources direct and the rest through the server. Place more specific rules above general ones and check the result after each edit.
Why does the speed drop and how do I raise it?
Speed depends on the server load, the transport, and the network parameters. Run a ping across the subscription nodes and choose the most stable one. On unstable networks, try a transport over QUIC/Reality; on strict ones, TCP+TLS. In case of fragmentation, reduce the MTU to ~1400 and enable multiplexing. Change one parameter at a time and measure the result.
The connection drops or won't come up at all — where do I start?
First, update the subscription and synchronize the system time — a clock mismatch breaks the TLS/Reality handshake. Then change the node and protocol: if a neighboring server works, the problem is in the node; if all are silent, it's in the provider's network. As a last resort, disable the custom routing rules: an erroneous exclusion can steer all the traffic past the tunnel.