Skip to main content
0%

Happ: VPN for Selected Sites and Apps

11 min readUpdated

Description

In Happ, sites are assigned to Proxy for proxy connections or Direct for direct connections. To use the VPN only for selected sites, turn off the global proxy and add the required rules to Proxy. For individual exceptions, leave the global proxy on and use Direct. App settings are covered separately.

The documentation was read on 24 October 2026. The Windows interface illustrations below have been retained; their build number has not been established. They do not confirm button locations in the current release. Menu availability depends on the version and subscription. Routing on readers’ devices was not tested.

Connection testHow fast is your internet right now?
Test your internet?Press to start — takes 30 seconds and up to 50 MB of data
—mspingmax—avg—min——Mbpsdownloadmax—avg—min——Mbpsuploadmax—avg—min—
Jitter—Ping under load—
Last speed test
MetricResultmaxavgmin
Ping—ms———
Download—Mbps———
Upload—Mbps———

Configuration for specific applications

Happ’s Desktop documentation describes two modes: direct connections for selected apps and proxy connections only for selected apps. Choose the mode for your task: exclude an app from the tunnel or send only selected apps through the client.

In the Desktop 4.5.4 release notes, the developer explains that selected apps follow your routing profile. Check app mode together with site rules. The mode does not mean that every connection from a selected app will necessarily use the proxy.

The process list in the illustrations is for Windows. Do not treat these steps as identical menus on other operating systems. Happ documents app settings separately for Android and Desktop; macOS Desktop means the DMG version, not Mac Catalyst from the App Store.

On iPhone, do not look for the Windows process list shown here. Apple describes per-app VPN for apps managed by a device management service. This does not confirm that the same switch is available in a regular Happ installation on iPhone; check the client documentation for support in your build.

For the Windows interface shown in the illustrations:

  1. Open Happ.
  2. Open Settings.

Opening Happ settings for app configuration

  1. Select Per-App Proxy Settings.

Per-App Proxy Settings option

  1. Select Add → Add running app.

Adding an app from the Windows process list

  1. Select the app that should connect directly.

Selecting the chrome.exe process in Happ

  1. Turn on Selected applications go through Direct.

Selected app with direct access enabled

  1. Restart the connection. Check the selected app and one app outside the list.

This procedure excludes an app from the tunnel. For the opposite task, use the mode for proxying only selected apps if your build supports it. Check it against the subscription settings and routing profile.

VPN for selected websites only

First, check which subscription the profile belongs to. According to Happ’s current documentation, subscriptions have separate rule sets. For a JSON subscription, manual profile creation, copying and import may be blocked: the profile is supplied by the provider.

If a required option is missing or unavailable, check the subscription’s format and restrictions. Do not delete the subscription to make a button appear: its associated routing profiles are deleted with it.

  1. Launch Happ.
  2. Open Settings.

Happ settings in the illustrated Windows interface

  1. Open Routing rules.

Routing rules option in Happ settings

  1. Select ···.

Happ routing profile menu

  1. If the subscription allows manual creation, create a separate profile for testing.

New profile option in Happ

  1. Give it a name, for example “VPN for selected websites only”.

Naming a new routing profile

  1. Turn on Use routing.

Use routing switch

  1. Open the settings of the created profile.

Opening the created profile’s settings

  1. Select Edit rules.

Edit rules option and geo file sources

  1. Turn off Global proxy. For connections handled by this profile, the direction without a matching rule will be direct; add the required sites to Proxy. Account for other rules and the selected app mode.

Global proxy turned off in Happ rules

  1. Open Proxy.

Proxy section in Happ’s rule editor

  1. Review the settings in Proxy.

Proxy rules field and illustrative tags

A domain is a resource’s name. In Xray syntax, domain:example.com matches example.com and its subdomains, while full:example.com matches only the exact name. Enter rules in a format supported by the selected client field.

GeoIP contains lists of IP addresses or subnets. For example, geoip:ru matches the destination address against the RU list in the selected geoip.dat file. It is not a list of Russian domains or a way to identify a site’s language. Similarly, geoip:by refers to the BY address list.

GeoSite contains named lists of domain rules in the selected geosite.dat file. For example, geosite:youtube refers to that file’s youtube list. Its contents depend on the file’s source and version; a tag does not guarantee coverage of an entire service.

Examples of company and service lists include geosite:microsoft, geosite:tiktok and geosite:google. For a group of video services, geosite:category-video may be used if the selected file contains it.

Check the order of Block, Direct and Proxy. Xray uses the first matching rule. If a domain appears in several lists, their order affects its route.

For the first example, use one domain without overlapping rules. Compare the result after the change. The order in the illustration is not presented as the same default for every profile.

In the profile, check the source addresses for geoip.dat and geosite.dat and their download dates. The domain-list-community catalogue helps you examine v2fly’s source lists, but your profile may use a build with additions.

In the interface shown, the tag buttons open lists from the selected file. Find the required tag and add it to the appropriate list. If a tag is missing, do not guess a similar name. An update to the source project does not confirm that this file has already been downloaded by the client.

youtube source list in GitHub’s English interface

The illustration shows GitHub’s English interface and the youtube source list; list contents change over time.

  1. Find the geosite and geoip tags in the app.

Buttons for viewing geosite and geoip tags

  1. Select the required tag to add it to the appropriate list.

Selecting the geosite:YOUTUBE tag in Happ

  1. Select the created profile in the required subscription. Wait for its geo files to download. Restart the connection and check the required site and a site outside the list.

Selected sites without VPN

  1. Create a separate profile if the subscription format allows it.
  2. Open its rule editor.
  3. Turn on Global proxy for the main direction through the proxy.

Global proxy turned on in Happ rules

  1. Open Direct.

Direct section in Happ’s rule editor

  1. Review the existing local-network rules. Add the required domain, for example domain:wikipedia.org. Select the profile, restart the connection, and check the exception site and a site outside the list.

Country-specific Direct rules in the illustration

The illustration shows a country-specific example: Russia in the Russian image and Iran in the English image. This is not a mandatory rule set. Do not add every tag with a country code “for reliability”: this may send extra connections directly and still fail to cover the required site.

Examples of geosite for configuring routing rules

The following examples come from v2fly’s source lists, checked on 24 October 2026. Names and contents may differ in your profile’s build. Before adding a tag, find it in the client and check the required resource. The table is not a ready-to-import profile.

For an individual domain, you can start with domain:youtube.com or another required name. This does not guarantee coverage of every supporting connection a service uses.

Popular services

geositeExample domainsCategory
geosite:googlegoogle.com, youtube.com, gstatic.comSearch, video, CDN
geosite:youtubeyoutube.com, ytimg.com, googlevideo.comVideo hosting
geosite:whatsappwhatsapp.com, whatsapp.netMessenger
geosite:tiktoktiktok.com, tiktokcdn.comVideo, social network
geosite:telegramtelegram.org, t.me, telegra.phMessenger
geosite:netflixnetflix.com, nflxvideo.netVideo streaming
geosite:spotifyspotify.com, scdn.coMusic
geosite:steamsteampowered.com, steamcommunity.comGames
geosite:epicgamesepicgames.com, unrealengine.comGames
geosite:discorddiscord.com, discord.ggChats, communities
geosite:redditreddit.com, redd.itForums
geosite:githubgithub.com, githubusercontent.comDevelopment, Git
geosite:cloudflarecloudflare.com, workers.devCDN / DNS / Security
geosite:openaiopenai.com, chatgpt.comAI services

Other services

geositeExample domainsCategory / Purpose
geosite:facebookfacebook.com, fbcdn.netSocial network
geosite:twittertwitter.com, t.co, x.comSocial network
geosite:amazonamazon.com, aws.amazon.comE-commerce / Cloud
geosite:microsoftmicrosoft.com, live.com, bing.comIT services
geosite:appleapple.com, icloud.comApple ecosystem
geosite:wikimediawikipedia.org, wikimedia.orgEncyclopedia and Wikimedia projects
geosite:paypalpaypal.com, paypalobjects.comPayments
geosite:stripestripe.com, stripe.networkPayment systems
geosite:zoomzoom.us, zoom.comVideo conferencing
geosite:dropboxdropbox.com, dropboxusercontent.comCloud storage
geosite:onedriveonedrive.live.comCloud storage
geosite:adobeadobe.com, adobe.ioCreative services
geosite:slackslack.com, slack-edge.comCorporate chats
geosite:atlassianatlassian.com, jira.com, bitbucket.orgDevOps / Management
geosite:stackexchangestackoverflow.com, stackexchange.comDeveloper Q&A
geosite:mediummedium.comPublishing platform
geosite:yahooyahoo.comPortal / Mail
geosite:bingbing.comSearch engine
geosite:megamega.nzCloud storage
geosite:eaea.com, origin.comGames
geosite:ubisoftubisoft.com, uplay.comGames
geosite:quoraquora.comQ&A
geosite:bookingbooking.comTravel
geosite:airbnbairbnb.comAccommodation rental
geosite:cnncnn.comNews
geosite:bbcbbc.comNews
geosite:category-medianytimes.com, theguardian.comNews and media resources
geosite:category-ads-alldoubleclick.net, googlesyndication.comAdvertising and tracking
geosite:category-adsads.mopub.com, adservice.google.comAd networks
geosite:cnbaidu.com, qq.com, wechat.comChinese services
geosite:privatelocal, localhostLocal resources

The geosite:private list contains special domain names, such as local and localhost. Do not confuse it with geoip:private, a list of private IP addresses.

How to Check the Result

  1. Record the client version, subscription and selected profile without disclosing the subscription link or keys.
  2. Restart the connection after changing rules.
  3. Check one required action on a site or in an app from the list.
  4. Repeat the check for a resource outside the list. If you check the external IP, the result applies to that connection, not every process on the device.
  5. If the result differs from what you expect, check app mode, the selected profile, rule order and geo file downloads. Change one setting at a time.

If options shown in the illustrations are missing, check the version and subscription restrictions against Happ’s documentation. Do not publish your subscription link or secret data when contacting support.

FAQ

How do I configure Happ for specific apps only?

Use the mode for proxying only selected apps if your build supports it. In Desktop 4.5.4, selected apps follow the routing profile; site rules also affect the result.

How do I add a site to Happ’s exceptions?

For a direct connection, add the site rule to Direct with the global proxy on. Check for overlaps with other lists and restart the connection.

What should I do if Happ cannot download geo files?

Check the file source in the profile and whether it can be downloaded. Happ’s documentation describes stopping an unfinished download after three minutes; the message clears after a successful download. Do not delete the subscription to reset the error.

Author: