Deep Links ru

Deep-ссылки (URL-схема)

🌐 English · Русский · 中文

SlothClash умеет импортировать подписку прямо из ссылки. Открытие такой ссылки (в браузере, чате или через кнопку «Добавить в приложение» на панели) запускает SlothClash, показывает диалог согласия и импортирует подписку как именованный профиль.

Схема — slothclash://

slothclash://install-config?url=<URL-ENCODED URL подписки>&name=<необязательное имя>

• url (обязательно) — URL твоей подписки, percent-encoded.
• name (необязательно) — отображаемое имя импортированного профиля.

Также принимается форма с путём:

slothclash:///install-config?url=<encoded>&name=<name>

Пример

URL подписки:

https://panel.example.com/sub/abc123

Deep-ссылка (URL-encoded):

slothclash://install-config?url=https%3A%2F%2Fpanel.example.com%2Fsub%2Fabc123&name=SwiftVPN

Всегда кодируй значение url. Некодированные ?, &, =, / в URL подписки сломают разбор.

Поведение и безопасность

• Открытие ссылки никогда не импортирует молча — ты видишь диалог согласия с именем подписки, прежде чем что-то добавится, потому что deep-ссылку может инициировать любой сайт.
• Целевой URL валидируется (защита от SSRF) перед загрузкой — через него нельзя заставить SlothClash стучаться на внутренние/loopback-адреса.
• Импортированный профиль ведёт себя ровно как добавленный вручную (автообновление и т.д.).
• Если SlothClash не установлен — ссылка ничего не делает; размещай её за обычной веб-страницей с фолбэком на скачивание.

Для панелей / операторов

Формируй персональную ссылку установки с уже percent-encoded URL подписки:

slothclash://install-config?url=<ENCODED_URL_ПОДПИСКИ>&name=<USERNAME>

Связанное

• Начало работы — импорт подписок в приложении
• Зашифрованные подписки