Documentation
How to use FlowLock, and how a provider connects their subscriptions to it.
For providers
The provider cabinet, the ID in a subscription, domains, app management through headers, notifications, links and the API.
| 1 | Provider cabinet What the FlowLock provider cabinet gives you and how to connect your subscriptions to it in five steps. |
| 2 | ID in the subscription Three ways to pass your provider ID to the app: a response header, a line in the subscription body, or the link fragment. |
| 3 | Domains and ownership checks How to verify a subscription domain with a TXT record or a file, what the statuses mean, and why the exact name is what gets verified. |
| 4 | Subscription headers What FlowLock reads from any subscription's response (name, traffic and expiry, support, announcement, refresh interval) and what it sends to the panel itself. |
| 5 | App management Subscription parameters a provider uses to manage FlowLock: info block, renewal, moving, fallback address and app settings; what FlowLock doesn't read and why. |
| 6 | Subscription colour theme The flowlock-theme header: FlowLock interface colours for the people on your subscription, the value format and the readability rules. |
| 7 | Subscription routing rules How a provider sends rules for what goes through the VPN and what goes direct: a Happ profile in the routing header, Xray and sing-box JSON. |
| 8 | Limited and HWID links Subscription links with a device limit, or for a single device by HWID, where the user never sees the subscription address. |
| 9 | Notifications and commands Messages to users of verified subscriptions: notifications, a window on top and safe commands to the app, recipients, scheduling and limits. |
| 10 | Statistics How many devices use your subscriptions: in total, active in the last 30 days, by system and by month. |
| 11 | flowlock:// links Commands of the flowlock:// scheme: connect, disconnect, add a subscription, import, routing rules, limited links and themes. |
| 12 | FlowLock User-Agent Which User-Agent FlowLock sends when it downloads a subscription, how to recognise FlowLock in a panel, and what happens if the panel doesn't accept it. |
| 13 | API reference The provider cabinet API for panels and bots: keys, domains, limited links, messages, devices and statistics, with curl examples. |
| 14 | Limits and “Unlimited” How many domains, links, devices and messages the free cabinet allows, what “Unlimited” lifts for 1000 ₽ a month, and how to pay and renew. |
| 15 | Privacy: what the provider sees What data about users the provider sees in the cabinet, what nobody sees, how long everything is kept, and how a user turns check-ins off. |
For users
Installation, subscriptions, routing, themes, the account and connection modes.
| 1 | Installation How to install FlowLock on macOS, Windows and Linux, what to do about the “unidentified developer” warning, and how updates arrive. |
| 2 | Subscriptions How to add your provider's subscription to FlowLock, what the subscription card shows, HWID, and subscriptions from limited links. |
| 3 | Routes and custom databases Routing modes, your own via VPN, direct and block rules, subscription rules, separate servers for sites, and custom geosite and geoip databases. |
| 4 | Apps and torrents How to send a whole app through the VPN, directly or through a chosen server, and how to turn on “Torrents direct”. |
| 5 | Themes and sharing them Your own FlowLock colour theme: colours for the light and dark sides, how to share it as a link, QR code or file, and how to accept someone else's. |
| 6 | Account and sync Why you might want a FlowLock account, and how sync, sign-in with a code, encryption, shared subscriptions and traffic statistics work. |
| 7 | TUN, system proxy and kill switch How TUN and system proxy modes differ, why administrator rights are needed, how the kill switch works, and switching servers on the fly. |
| 8 | FAQ Answers to common questions about FlowLock: where the servers come from, why macOS won't open the app, and what to do if a subscription doesn't load. |
Every page is available as Markdown: add .md to its address without the trailing slash. The list is in llms.txt, everything at once in llms-full.txt. llms.txt · llms-full.txt