MistRoute app icon

MistRoute Support

See and understand every network request your device makes. MistRoute is a native iOS traffic inspector and rule-based router, powered by the open-source mihomo core.

Version 1.0.0·Requires iOS 15.0 or later·English

Key features

Most proxy clients show you a list of nodes. MistRoute starts from the traffic itself — what your device is talking to, which rule matched, and where it went. You change the routing once you can see it.

Traffic, first

The main screen is a live connection stream, not a node list. Group it by host, by matched rule or by outbound to see instantly where your bandwidth is going.

Route explanation

Tap any connection to see the full decision chain: the request, the rule it matched, each policy group it passed through, and the node it finally left from.

Rule playground

Type a domain or IP and see which rule would match and which node it would use — evaluated against your live rule set, without generating any real traffic.

Home Screen widget

Tunnel status, current outbound and total usage at a glance, in small and medium sizes — without opening the app.

Your own configuration

Add profiles by subscription URL, file import or QR code, edit the YAML in place, and switch between them live. MistRoute provides no servers of its own.

VPN only when you ask

The system VPN engages only when you turn it on. Everything runs on your device — no account, no telemetry, nothing sent to us.

Requirements & app information

Reference details for App Store review and user enquiries.

App nameMistRoute
Current version1.0.0
RequirementsiOS 15.0 or later
Supported devicesiPhone, iPad
LanguageEnglish
Core componentmihomo core (open-source, Meta branch)
Network capabilityNetwork Extension (Packet Tunnel), active only when enabled by the user
Data collectionNone. The app collects, transmits and analyses no personal or usage data
PricingFree. No subscriptions or in-app purchases. No network service is provided or sold
About configuration sources: MistRoute is a client and inspection tool. It does not provide, resell or bundle any proxy servers, nodes or subscriptions. Every configuration is supplied by you and parsed locally on your device. Please ensure your usage complies with the laws of your jurisdiction and the terms of your network service provider.

Frequently asked questions

Most day-to-day issues are answered below.

How do I add my configuration?

Open the Profiles screen and tap + in the top-right corner. Three options are available:

  1. Download from URL — paste your subscription link and tap download.
  2. Import from file — pick a .yaml / .yml file stored on your device.
  3. Scan QR code — use the camera to scan a configuration QR code.

Tap a profile to activate it. Changes apply live — no restart required.

What does "route explanation" actually show me?

Every connection the core opens carries the rule that matched it and the chain of policy groups it went through. MistRoute reconstructs that into a readable sequence:

Request → matched rule → policy group(s) → actual outbound.

Tap any row on the Traffic screen to see it. This is exactly the information you need to answer "why did this site go the wrong way", and it comes straight from the core — no extra requests are made.

How is the rule playground different from just browsing?

The playground evaluates a domain or IP against your live rule set without opening a connection. You get the matched rule, the policy it points to and the node it resolves to — immediately and repeatably.

Note: if you enter a domain, the app performs a DNS resolution, because GeoIP-type rules can only be evaluated once an IP is known. No traffic is proxied and nothing is stored.

iOS asks me to allow a VPN configuration. What should I do?

The first time you enable the VPN, iOS shows a system permission dialog. Tap Allow and confirm with Face ID, Touch ID or your passcode. This is the standard iOS flow for installing a VPN profile into system settings.

If you tapped "Don't Allow" by mistake, go to Settings → General → VPN & Device Management, remove any leftover profile, then enable the VPN again in the app.

The VPN is on, but I have no internet access

Work through these steps in order:

  1. On the Traffic screen, confirm the status reads "Tunneling traffic".
  2. On the Routing screen, run a latency test and confirm the selected node responds (not Timeout).
  3. Use the rule playground with the domain that fails — it will tell you which rule caught it and where it was sent.
  4. Make sure your profile hasn't expired — refresh the subscription on the Profiles screen.
  5. Switch the outbound mode (Rule / Global) to check whether a routing rule is the cause.
  6. Under Settings → Logs, set the level to info or debug and look for errors.
  7. If the problem persists, turn the VPN off and run Settings → VPN Diagnostics.
The VPN disconnects on its own after a while

iOS enforces a hard memory ceiling of roughly 50 MB on network extension processes and terminates any process that exceeds it. The app includes several layers of memory control, but very high concurrency can still trigger the limit. We recommend:

  • Enable the low-memory Geo loader (memconservative) under Settings → General.
  • Set the log level to warning or silent.
  • Turn off TCP concurrency and IPv6 if you don't need them.
  • Trim your rule sets — prefer GeoIP over large GEOSITE rule providers.

You can watch the extension's live memory usage under Settings → Status.

How do I update Geo data (GeoIP / GeoSite)?

Open Settings → Resources to see each data file's download status and last update time, and tap to update manually. With auto-update enabled, the app refreshes them in the background at your chosen interval (in hours).

Does the app collect my data?

No. MistRoute collects, transmits and analyses no personal information or usage data, and contains no analytics, tracking, advertising or crash-reporting SDKs. Your profiles, connection records and logs are stored only on your device and can be cleared at any time from within the app.

One request is worth naming explicitly: the exit-IP lookup that shows your current exit address queries a public third-party IP-geolocation service, which necessarily sees the IP of that request. Full details are in the Privacy Policy.

How do I fully uninstall and remove my data?
  1. Turn off the VPN toggle inside the app.
  2. Touch and hold the Home Screen icon → Delete App.
  3. Go to Settings → General → VPN & Device Management and remove the MistRoute VPN configuration.

Deleting the app removes its sandbox, and with it all local profiles and logs.

What should I include when reporting an issue?

To help us diagnose quickly, please include:

  • Device model and iOS version (e.g. iPhone 14, iOS 17.5)
  • App version (shown under Settings → About)
  • What happens, and the steps to reproduce it
  • Relevant excerpts from Settings → Logs (please redact subscription links, server addresses and other sensitive details)

Email info@starhubinformation.com.