# Ссылки flowlock://

> Команды схемы flowlock:// — подключить, отключить, добавить подписку, импорт, правила маршрутизации, ограниченные ссылки и темы.

FlowLock регистрирует в системе схему `flowlock://`. Ссылку можно поставить на сайт, в бота или в ярлык. Браузер
сам спрашивает человека, открыть ли программу.

## Команды

| Ссылка                              | Что делает                                                                    | Подтверждение |
| ----------------------------------- | ----------------------------------------------------------------------------- | ------------- |
| `flowlock://connect`                | подключиться                                                                  | нет           |
| `flowlock://disconnect`             | отключиться                                                                   | нет           |
| `flowlock://toggle`                 | подключиться или отключиться                                                  | нет           |
| `flowlock://open`, `flowlock://`    | показать окно                                                                 | нет           |
| `flowlock://quit`                   | выйти из программы                                                            | нет           |
| `flowlock://add/<адрес>`            | добавить подписку по адресу                                                   | **да**        |
| `flowlock://import/<base64>`        | импорт: подписка, серверы, профиль или правила маршрутизации — по содержимому | **да**        |
| `flowlock://routing/add/<base64>`   | добавить правила маршрутизации (профиль Happ) к правилам человека             | **да**        |
| `flowlock://routing/onadd/<base64>` | то же и предложить режим «Выборочно», если в профиле `GlobalProxy: false`     | **да**        |
| `flowlock://install/<код>`          | подписка по [ограниченной ссылке](https://flowlock.cc/docs/install-links.md)                       | **да**        |
| `flowlock://theme/<данные>`         | [тема оформления](https://flowlock.cc/docs/user-themes.md), которой поделились                     | **да**        |

Схема и команда — без учёта регистра, косые черты после `:` необязательны (`flowlock:connect`). Команды с
подтверждением всегда показывают, что именно добавится, и ждут «Добавить» / «Отмена»: ссылку из браузера
FlowLock никогда не выполняет молча. Худшее, что может сделать чужая страница командой без подтверждения, — отключить
VPN.

## Аргументы

- `add/…` — адрес подписки как есть (`flowlock://add/https://sub.example.com/abc`) или процентно закодированный
  (`flowlock://add/https%3A%2F%2Fsub.example.com%2Fabc`). Только `http://` и `https://`.
- `import/…` и `routing/…` — base64 (обычный или URL-safe, `=` в конце необязательны). Внутри `import`:
  - адрес `http(s)://` — подписка;
  - ссылки серверов, `.conf` WireGuard/AmneziaWG, `.ovpn` — серверы;
  - `happ://routing/add|onadd/…` — правила маршрутизации;
  - профиль FlowLock (JSON) — импорт профиля с выбором разделов.

Пример — кнопка «Добавить в FlowLock» на странице подписки:

```html
<a href="flowlock://add/https%3A%2F%2Fsub.example.com%2Fabc123">Добавить в FlowLock</a>
```

## Веб-ссылки

Некоторые мессенджеры не делают `flowlock://` кликабельной. Для них есть страницы сайта:

- `https://flowlock.cc/i/<код>` — ограниченная ссылка: кнопка «Открыть в FlowLock» и загрузка приложения;
- `https://flowlock.cc/theme#<данные>` — тема оформления с предпросмотром;
- `https://flowlock.cc/add/#url=<адрес>&name=<имя>` — добавить подписку в аккаунт FlowLock на сайте.