Skip to content

Subscription Formats

Mole is a universal client that strives to support the most popular configuration distribution formats.

Supported Data Types

1. Clash YAML

Mole extracts objects from the proxies array. Standard Clash fields for VLESS, VMess, Trojan, Shadowsocks, and Hysteria2 are supported.

2. SIP008 JSON

The standard Shadowsocks format. Mole parses the array of objects and automatically adds them to the server list.

3. Base64 / Plain Text

A list of standard share links (vless://, ss://, etc.), separated by newlines. Mole correctly processes both raw text and Base64-encoded strings.

4. JSON subscription (full configs)

A JSON array of ready-made Xray configuration objects, each with its own outbounds and remarks. It is detected before SIP008 because both start with [. See Full configurations.

How the format is detected

Mole detects the format from the body, not from Content-Type:

  1. Body starts with [ → try a JSON subscription;
  2. starts with [ or { → try SIP008;
  3. contains proxies: → try Clash YAML;
  4. otherwise try base64-decoding it and parse the result as a share-link list;
  5. if base64 fails, parse the text as-is, line by line.

Recommendations for Providers

For the best user experience, we recommend using a Base64 link list or Clash YAML, as they allow for the most complete protocol settings (e.g., Reality or Fingerprints).