Skip to content
SharX Connect

Troubleshooting

Subscription does not load or the server list is empty

  • HTTP 200 with empty body — common panel issues: wrong template for this User-Agent, HWID/device limits, empty fallback. Coordinate with the panel admin; the app sends x-hwid, x-device-os, … (see subscription HTTP).
  • HTML instead of subscription — the subscription endpoint returns a web page for Accept: */*. The panel must serve a raw list (base64 / newline links), not an SPA.
  • “No vless/vmess/…” links — ensure the body actually contains share links, not an HTML page.

VPN does not start

  • Check VPN permission and the profile under Settings → VPN.
  • Make sure the node uses a supported protocol (see protocols); after changing LibXray/Xray, some outbounds may require rebuilding the bundled core.
  • If App Group identifiers changed in the Xcode project, reinstall the app and tunnel extension so Keychain and shared storage match the new group (see any AppGroupError hint in the client).

Routing / DNS oddities

Review the active profile, DNS fields, and for geosite: / geoip: rules ensure .dat files were downloaded (see routing.md).

Terms of use and liability limitations are available in-app under Terms & conditions.

Версия на русском