Hiddify Setup, Subscription & Troubleshooting Guides
Browse Hiddify guides for Windows, macOS, Linux, Android, and iOS, plus subscription imports, routing, port changes, and Clash to sing-box conversion.
Getting Started
Hiddify NG vs Hiddify Next vs Hiddify: What's the Difference?
Learn the difference between the old Hiddify NG client and the current multi-platform Hiddify app, and avoid untrusted third-party APK sites.
How to Install and Configure Hiddify on iPhone & iPad
Detailed guide on how to install and configure Hiddify Next on iPhone and iPad, covering App Store installation, TestFlight beta, sideloading, and more. Supports iOS 15.0+.
How to Install and Configure Hiddify on Linux
Detailed guide on installing and configuring Hiddify Next on Linux. Supports AppImage (Recommended) and DEB/RPM packages.
How to Install and Configure Hiddify on Windows 10/11
Step-by-step guide to downloading, installing, and configuring Hiddify Next on Windows. Suitable for beginners, supports Windows 10/11.
How to Install and Configure Hiddify on Android
Detailed guide on how to install and configure Hiddify Next on Android, covering Google Play, GitHub APK, permissions, and battery optimization. Supports Android 7.0+.
How to Install and Configure Hiddify on macOS
Detailed guide on installing and configuring Hiddify Next on macOS. Supports DMG/PKG installation, compatible with Intel and Apple Silicon chips.
How to Import a Subscription into Hiddify Safely
Subscription links are key to using Hiddify Next. Learn how to securely and correctly import and manage them via clipboard, QR code, and more.
Advanced
How to Convert a Clash Subscription to sing-box
Learn how to use the integrated Clash to Singbox converter, including URL mode, advanced templates, and smart parsing.
Change Hiddify Proxy Ports to Fix Telegram Connections
Hiddify’s current Mixed Port is usually 12334, while existing Clash-based app settings may still point to 7890. Learn how to make the ports match.
Hiddify Routing Rules: Limits, Modes & Alternatives
Hiddify v4.1.1 includes a built-in route rules editor. This guide explains what the app exposes, how it differs from editing a full sing-box configuration, and when another workflow may be useful.
Troubleshooting
Hiddify Cannot Import a Subscription: Failed to Add Profile
Trace a Hiddify profile import failure through link integrity, response content, HTTPS certificates, client parsing, and server status.
Hiddify Connected but No Internet: Websites Do Not Open
A green connection button only indicates a client connection state; it does not prove that DNS, routing, and the remote node can all carry traffic.
Hiddify Is Slow or Frequently Disconnects: Node, Network, and DNS Checks
Use the same device and target while changing one variable at a time to distinguish node congestion, access network, client mode, DNS, and the remote route.
Hiddify Subscription Update Failed: URL, SSL, DNS, and Server Checks
Preserve the working local configuration, then determine whether an update request fails in the client, subscription URL, DNS/TLS, or server response.
Hiddify Troubleshooting Guide: Connection, Subscription, and TUN Issues
Use controlled tests to decide whether a problem belongs to the client, subscription, DNS/TLS, or server before opening the relevant guide or changing advanced settings.
Hiddify TUN Mode Will Not Start or Has No Internet on Windows, macOS, and Linux
Compare system proxy with TUN to identify a virtual-adapter path problem, then check privileges, conflicting software, routing, and logs.
Want to Contribute Tutorials?
If you have good usage experience or solutions, welcome to share with us! We will include quality tutorials on the website.
Learn How to Contribute