Skip to content
macos-setup-from-scratch.md

How to use a VPN on Mac: macOS setup, installation, and permissions

A step-by-step guide to installing a client, granting macOS network extension permissions, importing a subscription, and checking your connection, plus tips for common permission prompts.

When using a VPN on a Mac, the key is not just finding the Connect button. The client, system permissions, and route configuration all need to work together. Download a client for your Mac from a trusted source, grant permissions when prompted, load the configuration, then check that the apps you care about are using the intended route. A system-wide “Connected” status does not mean every app is going through the proxy.

This guide covers what people commonly call VPNs and proxy clients in one setup workflow, without treating them as technically identical. macOS's built-in VPN settings cannot import arbitrary proxy subscriptions. Whether to use a system proxy or virtual network interface depends on the client's capabilities and which apps need to be routed.

First, understand the difference between a client, a subscription, and system settings

A client is an app that runs on your Mac. A subscription is usually an address the client uses to retrieve routes and configuration. It is not an installer, and pasting it into a browser will not configure macOS's system VPN. Some services sync configuration after you sign in, so there's no need to import it manually. Follow the instructions for your service and client.

The VPN settings in macOS are for connection types the system supports. Shadowsocks, VMess, Trojan, VLESS, Hysteria2, and TUIC are associated with third-party proxy clients; seeing a protocol name alone does not mean your client supports it. The protocol, subscription format, and configuration fields all need to match. Matching file extensions do not make configurations interchangeable.

Method What it affects What to check during setup
macOS system VPN Creates a tunnel using a supported connection type and service configuration Check whether the service provides the required connection details; this is not a direct replacement for importing a proxy subscription
Client system proxy Primarily affects apps that follow the system proxy settings Check the proxy toggle and routing rules; apps that manage their own connections may ignore the settings
Virtual interface / tunnel mode Routes traffic through a virtual network interface; coverage depends on the configuration Check network permissions, route exclusions, DNS settings, and compatibility with other network tools

You don't need to enable every feature for the setup to feel “complete.” If your browser already reaches the sites you need under the current rules, keep the configuration simple. If an app ignores the system proxy, check whether the client offers a suitable tunnel mode rather than repeatedly changing subscriptions.

Download from a trusted source and install

USRVPN supports macOS. Sign in to the user panel and visit the client download page to get the USRVPN client. You must also sign in to access your subscription. No email address is required to create an account; just use a username and password. Don't mistake a similarly named app in search results for a download provided by this service.

  1. Check your Mac's processor. Open About This Mac from the Apple menu to see its chip or processor. If the download page offers separate versions for Apple silicon and Intel, choose the right one. If there's a universal version, follow the page's instructions.
  2. Install the app normally. For a disk image, open it and drag the app to Applications. For an installer, follow the on-screen steps. The first time you launch the app, open it from Applications rather than running it from Downloads or a mounted disk image.
  3. Review the first-launch prompt. macOS may warn that the app was downloaded from the internet. Check the file's source, app name, and publisher details before opening it through the standard system flow.
  4. Review the app before granting permissions. Locate the account, configuration, connection, and settings controls. If a prompt comes from an unfamiliar app, cancel it. Don't approve every request simply because you're installing a network tool.

Respond to network permission prompts based on what they say

Network extensions, VPN configurations, and background helper apps are different things. Implementations and macOS prompts vary: some clients add a VPN configuration, some use Network Extension, and others use a helper to set up a proxy or routes. Not seeing a particular prompt does not mean installation failed.

When you first enable a connection or tunnel feature, macOS may ask to add a VPN configuration. Make sure the requesting app is the client you just installed, then allow it. If macOS says a network extension was blocked, follow the prompt to the relevant approval setting. It may be under Privacy & Security or among the extension settings in General; names and locations vary by macOS version.

After granting permission, return to the client and try connecting again. Quit and reopen the app or restart your Mac only if the prompt specifically asks you to. Repeatedly clicking Connect can stack up authorization prompts. Authenticate as an administrator only in a trusted macOS dialog; never send your Mac login password to support or paste it into a web form.

A standard proxy connection usually doesn't require a root certificate to decrypt web traffic. If a setup asks you to trust an additional root certificate, find out what it does and what the implications are; this is not the same as adding a VPN configuration. Don't turn off your browser's certificate checks to troubleshoot connection issues.

Load your subscription and choose a connection method

If your client syncs routes through an account, sign in and check that the configuration has loaded. For manual setup, copy the subscription address for your client from the user panel, then paste it into the app's Subscription, Configuration, or Import section and refresh it. Menu names vary, so screenshots from one app shouldn't be treated as universal instructions.

A subscription address may contain credentials that grant access to your configuration, so protect it like a password. Don't share the full address, its QR code, or screenshots that reveal it, and don't paste it into an unfamiliar online converter. If the format isn't supported, look for a compatible format from the service or contact support.

After a successful update, make sure the route list isn't empty, then select a route and routing mode. Rule-based mode uses conditions such as domains and addresses to decide what goes direct and what goes through the proxy. Global proxy mode generally routes requests within the client's scope through the selected route, but it still may not cover all traffic from every app.

For your first test, use the client's recommended default rules and avoid layering on remote rule sets or complex overrides. If you need access to local network devices, check that your local subnet is set to bypass the proxy. IEPL, relay, and direct connections describe how routes are organized; they are not Mac permission types and don't replace testing the apps and sites you actually use.

Check your exit location, routing, and DNS after connecting

Verify your connection in stages. First, check that an ordinary website loads. Then test the site you actually need. Finally, use a trusted IP lookup page to see whether your exit region matches expectations. Don't rely only on a changed menu bar icon, or assume that one working website means every app is covered.

If a browser works in system proxy mode but a desktop app doesn't, the app may ignore the system proxy, use its own network stack, or miss the relevant routing rule. Check the client for connection logs and rule-match details before deciding whether to enable a supported tunnel mode. Don't assume every issue is caused by the route; app account permissions, regional policies, or problems with the service itself may also be involved.

DNS translates domain names into addresses. A DNS leak generally means DNS requests are taking a path other than the one you intended. This is different from your web traffic's exit IP, so an IP lookup alone can't detect it. Check the client's DNS settings alongside a trusted DNS test. The location shown for a resolver may not be its physical location and cannot, by itself, prove that the entire connection is private.

Encrypted DNS in your browser, the system resolver, and DNS handling by the client can all be active at once. If results don't match expectations, note your current settings and adjust them one at a time using the client's documentation. Entering a public DNS address at random may not fix the issue and could make your routing behavior inconsistent.

Keep verification results specific to each app

A site that loads, an expected exit region, sensible rule matches, and a DNS path check together provide a more complete picture. Passing a test in one browser only shows how that browser behaves with its current settings; it does not guarantee that all traffic is covered.

Troubleshoot common issues in order

Subscription update fails or the route list is empty

First, check that the address was copied in full and contains no extra spaces or line breaks. Then check the service status and data allowance in the user panel, along with the client's format requirements. A failed update doesn't necessarily mean the account is inactive; the request may simply not have reached the configuration service. If you can reproduce the error, send support the error text and app version, but not your full subscription credentials.

The client says it's connected, but websites won't load

Disconnect the client and check that your local network can reach ordinary websites. Then reconnect and review the selected route and mode. If ordinary sites work but the site you need doesn't, check the routing rules and the target service's status. If no sites work, investigate DNS, routes, and leftover proxy settings; don't delete all your system network configurations as a first step.

Can't connect to the internet after quitting the client

An unexpected exit may leave system proxy settings behind. Check the proxy options in the details for your current Wi-Fi or Ethernet connection and see whether they're still pointing to a local proxy that's no longer running. Turn off settings enabled by the client through the client itself when possible. Don't remove an unfamiliar corporate proxy without checking first. Also check whether another VPN or network filter is still active.

Connection drops after waking from sleep, or permission prompts keep reappearing

Network changes and sleep can interrupt a connection. Wait for your local network to recover, then reconnect. If permission prompts keep appearing, check whether multiple copies of the app are running from different locations and whether an update requires you to approve the extension again. Avoid running several tools that change routes or DNS at once; it makes problems harder to diagnose.

Keep your setup simple, then choose a plan that fits your usage

Once setup is complete, keep a record of your settings without sensitive credentials: where you got the client, its connection mode, how it handles DNS, and which network components you've approved. Read release notes before updating. If you switch clients, test your setup again rather than assuming the old app's routing behavior will carry over.

USRVPN allows unlimited simultaneous connections, but device count and data allowance are separate. Monthly plans include ¥9.9/month for 60GB, ¥18/month for 250GB, and ¥28/month for 500GB. Data resets monthly on the activation date. Data packages remain available until used and never expire. Before choosing, consider whether your usage is continuous and how often you download large files or stream video. See the plans page for full pricing.

This service uses bank-grade encryption, but encryption doesn't replace checking your download source, keeping your system updated, and protecting your credentials. You can request a full refund for any reason within 14 days of your first payment. For permission prompts not covered here, visit the Help page and share a redacted error message. Don't expose your account details or subscription address while troubleshooting.

Try It Free