REFERENCEFind help by symptom

VPNTroubleshooting Guide

First identify where the problem occurs, then adjust the relevant settings. This page is for users who have imported a subscription but are having connection or access issues. If you haven't installed the client or imported a subscription yet, follow the setup guide first, then return to the relevant symptom.

Can't Connect at All: Set a Baseline

Make sure your regular internet connection works

“Can't connect” can mean the client can't establish a tunnel, or simply that a website isn't responding. Disconnect from VPNFlat, open a site you can normally access directly, and check whether your current network requires a web-based sign-in. Hotel, campus and public networks may show as connected while still waiting for you to accept their terms. Complete the network sign-in before reconnecting; don't mistake an inaccessible sign-in page for a route failure. If ordinary websites still won't load when disconnected, troubleshoot your local network first.

Note whether you're on Wi-Fi, Ethernet or mobile data, and try another connection if possible. Keep the client and selected route unchanged so the comparison is meaningful. If switching networks fixes the issue, the cause is more likely to be the original network, its equipment or its egress policies. If it fails across networks, continue by checking your account and client. Avoid changing the network and route while reinstalling the app at the same time; if the issue clears, you won't know which change helped.

Check account status separately from connection status

In the user panel, check that your plan is active, you have data remaining and the subscription is imported into the client you're using. Being able to sign in to the panel confirms account authentication; it doesn't mean a tunnel is established. Monthly subscription data resets each month on your activation date, not on the first of the calendar month. Data packs remain valid until used and never expire. If the panel shows that your allowance is exhausted, resolve the plan status before testing routes; reconnecting repeatedly won't restore available data.

Check where the failure occurs in the client. If it stops immediately after you press Connect, start by checking permissions, configuration parsing and local service messages. If it stays on “Connecting,” use the logs to see whether it stalls during DNS resolution, remote connection or handshake. An error is a clue, not a diagnosis: a timeout could mean the network is unreachable, or that the device clock is wrong. Enable automatic time syncing, then test a route that actually appears in your current subscription. Don't guess server addresses or ports.

Check permissions, then switch routes methodically

When the system first asks to add a VPN configuration, network extension or virtual network interface, you need to approve it. If you previously denied permission, authorize it again through system settings or the client's help menu. Menu names vary by system, so follow what you see on your device. Desktop clients that rely on a local background service also need that service running. Grant administrator access only when the client explicitly requires it. Don't disable system protections permanently or run repair tools from unknown sources.

Once permissions are in place, choose another available route in the same region, then compare different route types. This helps distinguish a problem with one entry point from a client-wide issue. IEPL, relayed and direct routes describe how traffic is carried; none guarantees a connection in every environment. Check the routes page for route details, and make sure you haven't confused routes for accessing mainland China with routes for international destinations. Disconnect the old route before switching, wait for the client status to update, then reconnect and record each result.

If the issue occurs only on one network, ask its administrator about VPN access policies. If it fails on every network, quit other proxy or tunnel apps and restart the VPNFlat client. Quit means stopping background services too, not just closing the app window. In your support ticket, describe exactly which step fails and the conditions under which it works. That's more useful than a screenshot showing only “Connecting.”

Connected but Pages Won't Load: Check DNS and Access

A successful connection doesn't guarantee the destination is reachable

When the client says Connected, it means the connection process appears complete. Website access also depends on DNS resolution, traffic routing, the destination's response and your browser. Try a site you can access directly, one that should use the selected route, and the site that originally failed. If all sites fail, check the local proxy and DNS first. If only one site fails, save its error page and avoid changing network settings for the whole system. Different symptoms call for different checks.

Check whether the error occurs before or after the site starts loading. “Server not found” or “Name could not be resolved” usually points to DNS. If a site loads but shows a region, permission or account error, the request may have reached the service. Clearing the DNS cache won't fix that. Sign-in status, the service's regional rules or a temporary outage can also prevent access; not every access denial means the VPNFlat route is down.

Find out which path DNS requests take

DNS translates domain names into network addresses. The system, browser and client may each keep their own cache or use different resolvers. If your browser uses encrypted DNS while the client also handles system DNS, requests may take a different path than expected. Note your original settings, then temporarily set the browser to use the system configuration for comparison. If your device is managed by your organization, don't remove its policies; ask your administrator which DNS options are approved.

If the client offers DNS modes, start by restoring its recommended setting rather than copying a long list of resolvers from the internet. Some configurations resolve domains through the tunnel; others route local and remote requests separately. Either way, DNS must match the traffic-routing rules, and the resulting address must be reachable over the current route. Don't make permanent changes to your hosts file to pin a site to an address: service addresses can change, and a bad entry can turn a temporary issue into a persistent one.

Use system tools as evidence, not as a verdict

On desktop systems, run the read-only query below in a terminal to see whether the system can resolve a domain. The example domain illustrates the command format; replace it with the domain of the site you're troubleshooting. Don't paste a full URL that contains sign-in credentials. Output varies by system. Keep the resolver, whether an address was returned and the exact error. A successful query confirms only that this lookup returned a result; it doesn't prove the browser used the same path or that the site will load.

nslookup example.com

If the system query succeeds but the browser fails, quit and reopen the browser, then compare with a private window to rule out stale cache or extension interference. Some extensions may still run in private windows. If the client logs keep showing DNS failures, try another network, restore the client's default DNS settings and compare again. A network probe that gets no response doesn't by itself prove a route is unavailable; the destination may not answer that kind of probe.

If websites still won't load after disconnecting the client, check whether a local address remains in the system proxy settings. First quit the client normally and let it restore the proxy. If it doesn't, check the system's manual proxy and automatic configuration script settings, noting their original values first. Don't remove a proxy required by your organization. If a DNS issue occurs on only one route, save the route name and lookup result for your ticket. If only one site is affected, provide its domain and error type; you don't need to share your browsing history.

Slow Speeds and Peak-Time Lag: Compare Each Link

Pinpoint where the slowdown occurs

A slow first page load, a sluggish download, buffering video and laggy gameplay are different performance issues. A slow page may be held up by DNS or connection setup; downloads depend more on sustained throughput; video also depends on buffering, content delivery and the player. Note which app and action are slow, and whether the problem is persistent. One download doesn't represent your whole connection, and a destination's own speed limit doesn't prove the route lacks bandwidth.

For a useful comparison, keep the device, client mode and destination the same. Test at different times, on different networks and over different routes, changing one condition at a time. If your local network is slow too, start with Wi-Fi signal, router equipment or background transfers. If regular browsing is fine but content is slow on one route, check the region and route type. Speed tests use data, so avoid running them repeatedly and then treating the lower remaining balance as evidence of abnormal usage.

Compare sustained performance during peak hours

Peak-hour lag can originate in home Wi-Fi, your internet provider, an international route or the destination platform. Pause syncing, system downloads and large transfers, then move closer to the access point or use Ethernet if available. If other devices at home are also lagging, start by addressing local network congestion. If only routed traffic slows at certain times, compare the same route during normal and peak hours, keeping conditions consistent and reproducible.

Don't choose a route based only on its region name or one probe result. A closer destination may mean a shorter path, but routing, access quality and content delivery also matter. For mainland China services, check the route's purpose and egress region; for international services, choose a region supported by the destination. Route type is useful for comparison, but actual performance matters more. For help choosing, see the guide to choosing a VPN route for your needs.

Route typeWhat to checkHow to compare
IEPL dedicated routeCurrent entry point, access network and destination regionSwitch routes in the same region while keeping the destination unchanged
RelayedAccess segment and onward forwarding pathCompare different access networks and peak-hour conditions
DirectThe actual route from your network to the remote destinationCompare with other route types in the same region

Separate playback issues from route issues

If streaming stutters, compare other content on the same platform, then try its website and app. If only one title is affected, the issue may involve content delivery or the playback source. If lowering the quality helps, that only shows the current connection can't sustain the original setting; it doesn't tell you which part of the path is responsible. Handle regional access errors separately from playback issues: check the service's rules and egress region for the former, and compare network conditions and route quality for the latter.

When developer tools or AI API requests are slow, check whether the error comes from server queues, usage limits or the request itself—not just the network. Save the request stage and timeout type, but never share API keys, request bodies or project materials. If a website works but a command-line tool fails, the developer tool may not be using the system proxy. For context, see route and client tips for AI API calls, then check the actual path in the app-routing section.

If slow performance reliably occurs on one route at certain times, tell support what you tested and how the results compared; there's no need to speculate about “server load.” VPNFlat covers 90+ countries / 180+ routes. That's the range of available options, not a promise of identical paths to every destination. Don't switch to a larger data plan just to troubleshoot: data allowance and connection speed are different things. Check the plans page for plan details.

Frequent disconnects and mobile background dropouts

Check whether the tunnel drops or just the app reconnects

An app saying it's reconnecting doesn't necessarily mean the VPN tunnel disconnected. Locking the screen, switching Wi-Fi networks, device sleep or an expired session can all make an app reconnect. Check whether the client still shows Connected, and look for tunnel stops, network changes or permission errors in the logs around the time of the dropout. If the client stays connected and only one app signs in again, investigate that app's session and routing rather than repeatedly deleting the VPN configuration.

Note what triggers the problem: switching to another app, locking the screen, changing Wi-Fi networks, moving out of range or waking the device. Clearer triggers make issues easier to reproduce. Keep the same route and compare time spent in the foreground with time spent in the background. Don't change battery settings and switch routes during the same test, or you won't know whether the cause was a system restriction or a route change. After waking from sleep, the network interface and client service may need time to restore their state; check the result once they do.

Android: check background activity and battery settings

Android settings and manufacturer-specific management tools may both control background activity. Find the client's battery settings and check whether background use is restricted. If the device also offers auto-start or background-running controls, check those too. Change only settings that apply directly to the client; you don't need to disable the device's overall power-saving features. After allowing background activity, reconnect and repeat the same screen-lock test. Confirm that it works rather than relying on the setting showing “Allowed.”

Some systems support Always-on VPN or blocking connections that don't use a VPN. These settings affect what happens if the tunnel stops: apps may lose all network access, making the whole device seem offline. Note the original setting and decide whether to use it based on your needs; don't mistake a protective block for a broken local network. Work and personal profiles may also have separate network settings. On a managed device, follow its policies rather than removing management configurations to troubleshoot.

iOS and desktop sleep: check system events

iOS VPN connections are managed by system network extensions, so Android background allowlists don't apply. Check that the correct VPN configuration is still installed and whether another app has created an on-demand connection rule. If another configuration takes over every time you connect, check who manages it and what it's for. Don't remove configuration profiles in bulk: school or work profiles may include essential network and certificate settings. Ask the administrator first.

When Windows, macOS or Linux resumes from sleep, the network interface, address or default route may change. First confirm your regular network is back, then disconnect and reconnect the client. Check whether the issue occurs only after waking. If Ethernet works but Wi-Fi doesn't, look into power management for the network adapter. Use settings supported by the operating system; don't blindly change advanced driver options or run unfamiliar scripts to reset the network.

If disconnects happen at random both in the foreground and background, keep the device still and compare networks and other routes in the same region. If it happens only on one network, the cause may be the connection itself or network switching. If it happens across networks after similar system events, check the client service, permissions and other tunnel apps. Interpret network-change logs in context: one interface change doesn't prove the root cause, and a normal system reconnect isn't necessarily a fault.

For this type of support ticket, say whether the screen was locked, whether the client was in the foreground, whether the network changed and whether reopening the app was needed to restore service. Include relevant log excerpts from around the time of the issue, with account and subscription details redacted. Android setup can miss background permissions; compare with the Android client installation and verification guide. If device policies prevent changes, check with the administrator first.

Failed Subscription Updates and Missing Servers

Check subscription retrieval separately from route connections

A subscription provides routes and related settings to the client. Updating it and connecting to a route are separate network requests. If old routes still connect but the update fails, the subscription retrieval path may be the issue. If the update succeeds but no routes connect, check account status and how the configuration is being used. Note the exact error shown by the client, then check the current subscription entry in the panel. Don't assume the subscription updated just because old route names appear, and don't keep creating duplicate configurations in the hope one works.

To retrieve your subscription from the user panel, use the current copy or import option. Don't look for it in old chats, bookmarks or another device's clipboard. A subscription URL may contain account access credentials, so keep it as secure as a password. When sharing a screenshot, check the address bar, QR code, clipboard preview and configuration text. Hiding visible text while leaving a QR code exposed can reveal the same information. If you suspect a leak, change the subscription credentials through the panel if that option is available, then update your own devices.

Use the error type to guide checks; don't alter the URL at random

If the address format is invalid, check that you copied it in full and that it contains no extra spaces, line breaks or non-ASCII punctuation. For authentication failures or access denials, check your account status and the current entry in the panel instead of changing URL parameters. For timeouts, first check whether your regular network can reach the panel, then see whether the current proxy settings affect the update request. For resolution failures, return to the DNS section. For configuration parsing errors, check that the client supports the imported format; repeatedly refreshing won't fix an incompatible format.

Some clients let you update a subscription through a proxy. If the proxy itself isn't working, it may send the update request down an unusable path, creating a loop: you need the update to connect, but need a connection to update. Note the original setting. If your regular network can reach the subscription entry, try updating directly as a temporary comparison. If it can't, don't keep toggling settings; save the error and contact support to check the retrieval path rather than using a third-party conversion site.

After a successful update, check which configuration is active

A client may keep several configurations at once. If you update a new one but continue using an older one, it can look as though the update did nothing. Check the active configuration, latest update result and route list before connecting. If the configuration manager shows error details or an update time, use them to confirm that the process completed. Don't share the entire configuration file just to verify it; route name, error type and active configuration are usually enough for an initial check.

If the route list suddenly shrinks after an update, check for region, favorites or search filters, then verify your account status. Configuration templates and client compatibility can also affect what's displayed, so don't infer a change in service coverage from the number of rows alone. VPNFlat's coverage is 90+ countries / 180+ routes; for troubleshooting, use the panel and your current subscription as the source of truth. If a route you previously used is missing, provide its original name and ask support—don't invent a remote address.

For configuration parsing failures, you can share the name of the field where the error occurs, but don't submit a full configuration containing credentials. Back up the configuration before editing it manually and make sure you can restore it from the panel. A subscription update may overwrite local edits, so temporary fixes shouldn't be written into automatically generated content. If you need custom rules, use the client's supported override mechanism and keep custom settings separate from the original subscription so you can identify the source of any post-update issue.

You don't need to create a new account to troubleshoot. VPNFlat requires no email address; your username and password are enough. Being able to access the account doesn't mean you should create another one to work around a configuration issue. If you need to import again, get the current subscription from the user panel overview, then verify it against the setup guide. If the panel and account are working but the client still can't update, provide the exact error, client name and results from comparing access networks.

An App Won't Use the Proxy: Check Its Routing

First check whether the app uses the system proxy

A browser works but other apps don't—a common routing issue. The system proxy usually affects only programs that read its settings; it doesn't automatically route all device traffic. Command-line tools, games, download managers and some desktop apps may use their own networking libraries. Check whether the client uses the system proxy or a virtual network interface, then see whether the app supports proxy settings. A working browser doesn't mean every app uses the same route.

If the client supports routing through a virtual network interface, it may cover more traffic, but it also needs additional permissions and correct routing. Follow the client's instructions to enable it, then restart the app you're testing; existing connections may keep using their original path. Enterprise apps, local network devices and remote desktop may be affected by route changes. Save your work before enabling the option and make sure you know how to restore the original settings. Don't permanently enable every traffic-capture option just to get one app working.

In rule mode, check what matched

Rule mode selects a path based on domains, addresses, apps or other conditions. One app may use several domains for sign-in, content, updates and payments. A rule for the main domain may not cover the whole process. If the client shows connection details, check which domains and rules were involved when the problem occurred before changing anything. Record domain and rule names; don't collect full request URLs, which may contain account identifiers or temporary credentials.

You can temporarily compare rule mode with the client's global proxy mode to check for routing differences. “Global” is the name of a client routing policy; it doesn't guarantee that every app is routed or that the destination will allow access. If global mode works but rule mode doesn't, focus on rule matching and DNS. If both fail, check the app's proxy settings, destination region and account status. Restore your original mode after testing.

Check developer tools and background processes separately

Terminal tools often read proxy settings from environment variables, tool configuration or startup arguments. A graphical app working doesn't mean a program launched from the terminal will work, and terminal variables may not affect a graphical app that's already running. Check whether the proxy address still points to a local app you've quit and whether the port matches what's currently shown in the client. Don't copy a local port from another device or mistake an example address for a fixed VPNFlat setting.

Containers, virtual machines and remote development environments have their own network contexts. A loopback address inside one of them points to that environment, not necessarily the host device. If the host browser works but a request from a container fails, its proxy may be unreachable or its DNS settings may differ. Follow the development environment's documentation for connecting to the host, and check the scope of the connection. Don't expose a local proxy on every network interface just to test; that changes your device's exposure without necessarily fixing the app.

An app may cache an egress region, DNS result or old connection. After switching routes, quit and reopen the app normally before checking again. If only one account fails while other access works, don't immediately clear all app data; you could lose local content. Save the error first and make sure you can sign in again before following the app's official cache-clearing steps. For streaming region issues, see the streaming access guide; availability still depends on the selected region.

If the app uses a transport method the client or network can't handle, save the protocol or connection error from the logs for support. Don't broaden security exceptions on your own. In your ticket, include the app name, action that failed, client mode and results from comparing rules. AI websites and developer APIs require different checks; see the ChatGPT performance guide. For any app, there's no need to include your account password or developer key in a support ticket.

Device Limit Warning Conflicts with Platform: Check Local Settings

What “unlimited devices” means

VPNFlat supports unlimited devices connected at the same time. If a client shows “device limit exceeded” or a similar warning, don't assume your plan allows only a fixed number of devices. The message may come from another service, the client's own account system, a device management policy or a configuration that isn't your VPNFlat subscription. Check which window displayed the warning and which service the active configuration belongs to, then verify your status in the panel. Don't sign out of every device or change plans based on a vague warning.

Unlimited devices doesn't mean every device has identical settings. Devices may use different subscription copies, rules or networks, so they can behave differently. Use a device that connects normally as a reference; note its route, mode and network, then compare them one by one with the affected device. Don't publish a full configuration exported from a working device or copy private platform-specific paths directly to another one. When switching platforms, import the appropriate configuration from the panel.

On each platform, check where the system routes traffic

PlatformCheck firstCommonly confused with
WindowsSystem proxy, background service, virtual network interfaceWindow is closed but an old service is still running
macOSNetwork extension permission, VPN configuration, system proxyAnother network extension continues to handle traffic
iOSCurrent VPN configuration, on-demand connection, management policyConnection is replaced by another configuration
AndroidVPN permission, background restrictions, work profileClient activity restricted after screen lock
LinuxService permissions, routing, DNS management and environment variablesDesktop proxy and terminal proxy settings differ

On Windows, distinguish the client window from its background service. After closing the window, system proxy settings may remain in place, and another service may still be using a local listening address. End the test through the client's own quit and restore options, then check that the system proxy matches your original network requirements. If security software reports a block, check the specific program path and event instead of disabling all protection. Only follow system permission prompts after confirming the file came from the official download entry in the panel.

On macOS, check whether the system approved the network extension and whether another VPN or filtering extension is enabled. After changing permissions, follow the system prompts to reopen the client or reconnect; repeatedly clicking the menu bar icon isn't enough. An issue with Apple services shouldn't automatically be blamed on the device's chip. Compare proxy mode, DNS settings and network extensions first. For more on compatibility, see the guide to macOS network extensions and compatibility.

Keep existing policies on Linux and managed devices

Linux desktop environments, network management services and DNS management differ. First check how the client handles traffic, then confirm the relevant service is running. Don't overwrite system resolver files without understanding how DNS is managed: network services may generate them automatically, and manual changes may disappear after reconnecting. Check terminal proxy variables separately from desktop settings. Processes run with elevated privileges may not inherit the original environment, so follow the tool's documentation instead of repeatedly adding permissions.

On devices managed by your workplace or school, certificates, proxy, DNS and VPN settings may be controlled by central policies. If settings can't be changed, revert automatically or get replaced after connecting, ask the administrator first. Don't remove management components to take control of network traffic. If the device is running a work tunnel, remote assistance or secure access app, confirm whether it can be paused before testing; stopping a process directly could interrupt work or violate policy.

When checking for software conflicts, follow this order: save your work, disconnect, quit the other app, test again, then restore the original state. Test one possible cause at a time and record the result. If several network tools must run together, coordinate them using a routing and proxy setup that explicitly supports this. Don't let multiple apps repeatedly overwrite system settings. Automatic repair tools often make many changes and aren't a good first step without evidence; they don't replace restore points or configuration backups.

Download clients only through the user panel download page. After signing in, you can get clients for Windows, macOS, Android and Linux. The iOS option depends on eligibility shown in the panel; subscriptions are available after signing in. If the issue occurs during installation or authorization, include your operating system, client name, source of the error and whether the device is managed. For a device limit warning, provide its exact text with personal information redacted so support can check it rather than treating a local message as a plan restriction.

Submit a Support Ticket, Restore Settings and Verify

Submit one clear report once you can reproduce the issue

Once your regular network works, your account is active, and the subscription and permissions are confirmed, submit a ticket through the user panel if you can still reproduce the issue under clear conditions. You don't need to try every advanced setting first. Stop making changes if account status conflicts with what you see, the panel looks wrong, subscription authentication fails or the same route repeatedly errors. Support can check server-side status; reinstalling repeatedly won't provide more useful evidence.

A useful ticket starts with the symptom, then describes the scope and the comparisons you've already made. Say whether the client connects, which sites or apps fail, and whether the problem occurs only on a particular network or at a particular time. Then list the results of switching networks or routes and restoring default settings. Don't just write “doesn't work” or paste unfiltered logs, and don't present guesses as facts. You can say “another route in the same region works” without claiming “a server is broken.”

Include relevant details and leave out sensitive information

Include the date, local time and time zone so support can match events. Give the operating system and client name; if the panel or client explicitly shows a build, provide it as shown rather than guessing. Use the full route name shown in the client, and describe the network as home Wi-Fi, Ethernet, mobile data or a managed network. Give the destination domain and what failed. Don't share browsing history, account passwords, full payment credentials or personal information unrelated to the issue.

Symptom: The client shows Connected, but the website reports a DNS resolution failure
Time: Enter the actual time and time zone
Device: Enter the operating system and client name
Network: Enter the network type and say whether you compared another connection
Selected route: Enter the route name shown in the client
Comparison: Enter the conditions that worked and those that failed
Exact error: Copy the relevant excerpt and redact account and subscription details
Steps taken: Enter what you changed and whether settings have been restored

Include log excerpts from around the issue and preserve the exact error. Before sending, search for subscription URLs, tokens, passwords, keys and personal file paths. Check screenshots for QR codes, notification previews and other open windows. If you're unsure whether a field is sensitive, don't share it publicly; ask support which details they need in your ticket. Don't upload a full diagnostic package to a public file-sharing site and circulate the link. Use an appropriate support channel and share only what's necessary.

After each change, retest under the original conditions

A website opening again doesn't mean everything is fixed. Repeat the original action: if the problem was a disconnect when the screen locked, test again with the screen locked; if a subscription update failed, confirm the update completed and the active configuration is current; if one app failed, repeat the same action in the same mode. Keep the destination and network conditions unchanged, then check direct access, local network devices and other commonly used apps. This helps catch a routing problem introduced while fixing another one.

After recovery, undo temporary diagnostic changes one at a time, including global proxy mode, custom DNS, app-specific proxy overrides and background-setting tests. Note the combination that worked before reverting, then test each change as you go. Keep only settings you genuinely need. Don't leave certificate verification disabled, proxy listeners exposed to more networks or system protections turned off. If a change needs to remain, understand its impact and document how to reverse it. If you're unsure, ask support rather than treating a temporary workaround as the default configuration.

Check plan and billing questions separately so they don't get mixed up with connection troubleshooting. Monthly plans are ¥9.9/month for 60GB, ¥18/month for 250GB and ¥28/month for 500GB. Data resets monthly on the activation date; mid-cycle upgrades prorate the difference for the remaining days. Data packs are ¥158/300GB, ¥358/1000GB and ¥658/3000GB; they remain valid until used and never expire. Payment methods are Alipay / WeChat Pay / USDT. Check the order details in the panel rather than guessing whether a payment has cleared.

VPNFlat offers a 60-day no-questions-asked refund. For details and how to request one, see the refund policy. For other account questions, visit the help center. Troubleshooting isn't about expecting users to solve every issue on their own; it's about narrowing the problem down to something that can be verified. Preserve the original settings, change one thing at a time, retest the same scenario and share the relevant evidence with support. That's usually more effective than repeatedly reinstalling or changing settings at random.