Skip to content

Subscriptions and clients

Every node has a standard share link (vless://, hysteria2://, tuic://, …) and a QR code, shown when you view the node in the menu, or:

bash
psm node export xray reality hk-reality

Scan the QR code with a phone client, or paste the link into a desktop client.

Example node QR code

All nodes: a subscription

PSM exports every node at once in three formats:

FileFormatClients
sub.txtBase64 list of share links (generic subscription)v2rayN, v2rayNG, Shadowrocket, NekoBox, …
mihomo.yamlcomplete Clash Meta (mihomo) configClash Verge Rev, Mihomo Party, FlClash, …
singbox.jsoncomplete sing-box client configthe sing-box apps, Karing, Hiddify, …

Choose the local export in the Subscription menu; the files are saved on the server for you to download.

Online subscription

An online subscription lets clients refresh their nodes from a URL instead of being re-imported by hand:

  • The files are served under your HTTPS camouflage website, at https://your-domain/psm-sub/<48-character random token>/sub.txt.
  • It needs a domain pointing at the server and a certificate; PSM requests one if there is none.
  • It expires after 30 days by default and is then deleted; if the URL leaks, reset the token and the old URL stops working at once.
  • When Nginx owns port 443, PSM adds the subscription domain to the SNI routing table itself.

A subscription holds every credential

It contains the passwords and keys of all nodes: only give it to people you trust. For several people, use per-user accounts, each with a subscription of their own.

Per-user subscriptions

Every user gets their own subscription URL, holding only the nodes assigned to them, with their own credentials. When a user expires, runs out of quota or is disabled, their subscription stops working. See Per-user accounts.

Released under the AGPL-3.0 license · For lawful use only; follow the laws where you live