Reading tip
Identify the scenario first, then follow the checks in order. Jump to the linked download, subscription or configuration page when the issue becomes specific.
Before Turning It On
- The subscription updates successfully and nodes can connect.
- Rule or Global mode works through normal system proxy.
- No other VPN, proxy driver or network filter is running at the same time.
Recovery Order When Internet Breaks
- Disable TUN immediately and confirm normal network access returns.
- Restart the client and test only system proxy.
- Check administrator permission, virtual adapter, DNS hijack and route table changes.
- Disable other VPN, firewall enhancement or network acceleration tools temporarily.
- Enable auto-route, auto-detect-interface and dns-hijack options one at a time.
Symptoms and Direction
| Symptom | Look At | Next Step |
|---|---|---|
| No internet after enabling | Routing or DNS | Disable TUN, then read logs |
| Browser works, app does not | Whether the app follows system proxy | Use TUN or app-level proxy settings |
| Only LAN breaks | LAN bypass rules | Add direct rules for private networks |
| Stops after restart | Permission and autostart | Check login item and admin rights |
Minimal Example
tun:
enable: true
stack: system
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53Related Entries
- No internet after enabling TUN
- Why TUN needs administrator permission
- MetaCubeXD dashboard troubleshooting