Profiles are files, and files get replaced
A Clash-family client stores each profile as a file and points the core at the active one. When the client switches profiles or applies an update, the file that the core reads can change — and if the new content is empty or does not parse, the result is an interface with a profile name and no nodes.
Two habits prevent most of these incidents:
- Keep an exported copy of the profile that worked.
- Confirm which profile is active before editing anything, because editing an inactive file changes nothing.
Decide which failure you have
| Symptom | Layer | First check |
|---|---|---|
| Profile file blank or unexpectedly short | Local file state | Whether a switch or update rewrote it; restore your copy |
| Profile present, list empty | Content or activation | Which profile is active, and what it contains |
| List populated, pages fail | Capture or forwarding | The four contrasts below |
| Import reports an error | Fetch or parse | Status code and whether the body is a configuration |
Importing
- Use the address or file the provider documents for Clash-family clients.
- After import, confirm the profile is selected and active.
- Check that the proxy list has entries and the group names are the provider's, not leftovers from a previous profile.
- Test one real request.
The four contrasts when pages fail
- Client off, ordinary site — base network.
- Another node — one node versus the subscription.
- Another network — current path versus the service.
- One app versus the browser — capture scope versus forwarding.
Capture modes
System proxy writes a local port into the system settings and covers applications that read them. TUN captures at the IP stack and covers more, at the cost of an adapter, routes, DNS handling and permissions. Start with the simpler one, and record the pre-change DNS and routing state before enabling TUN.
What to record
- Client version, platform, and the profile name in use.
- Whether the profile file was replaced, and by what action.
- Whether the list was empty, partial or complete.
- Mode used, and the result of each contrast.
- A copy of the profile that worked, stored outside the client's data directory.
Scope
This page describes profile handling and the order of checks. Interface wording follows the installed version. Nothing here evaluates a provider or guarantees that a profile from one client family behaves identically here.