Документация Lacc
Для пользователя Windows: как добавить подписку и что делать при ошибке импорта. Справка по параметрам и API остаётся в разделах ниже.
Всё, что провайдер может задать через ссылки и кабинет Lacc, и что применяет клиент. Один источник для трёх слоёв: кабинет Premium Partner Access, приложение (Windows / Android / iOS) и check-server.
Стандартные параметры (трафик, срок, заголовок, объявления) применяются с любой подписки. Дополнительные настройки (автоподключение, оформление, kiosk, per-app) доступны при наличии валидного partnerkey, подтверждённого на check.lacc.ru. Набор доступных функций зависит от платформы и версии приложения. Параметры оформления относятся к партнёрскому доступу.
Разработчики подписок интегрируются под форматы Lacc: свои крипто-ссылки, схема lacc://, полная схема маршрутизации, наши параметры, наш check-server. Чужие форматы принимаются только на входе, бренд наружу не всплывает.
Как импортировать подписку в Lacc для Windows
Порядок ниже проверен по интерфейсу опубликованной Windows 0.12.8. Для Android и других платформ доступны отдельные статусы функций.
Подготовьте ссылку или конфигурацию
Получите у своего сервис-провайдера ссылку подписки либо конфигурацию для Lacc. Приложение принимает HTTP(S)-ссылки подписок, прокси-ссылки, например vless://, и поддерживаемые JSON-конфигурации. Lacc сам доступ не продаёт и не содержит готовых серверов.
Учебная схема адреса: https://subscription.example/sub/YOUR_TOKEN. Домен .example зарезервирован для примеров; для импорта используйте выданный вам полный адрес. Ссылка и QR-код могут содержать личный ключ доступа — сохраняйте их приватно.
Добавьте подписку
- Скопируйте полный адрес подписки или ключ. В пустом простом интерфейсе нажмите «Добавить подписку». В расширенном интерфейсе кнопка «Добавить профиль» находится в списке профилей.
- Откроется окно «Добавить подписку». Нажмите «Вставить из буфера»: распознанное содержимое может добавиться сразу. Чтобы проверить или исправить текст перед добавлением, выберите «Ввести вручную», вставьте свою ссылку и нажмите «Добавить».
- Для полученного файла выберите «Файл». В диалоге доступны
.json,.yaml,.yml,.txtи.conf; совместимость зависит от содержимого. Кнопка «QR-код» предлагает выбрать картинку или скриншот. Извлечённый текст можно проверить в редакторе перед кнопкой «Добавить». - После успешного импорта окно закрывается, а профиль появляется в списке. Откройте его и проверьте доступные серверы. Импорт подтверждает чтение конфигурации; реальное подключение и передачу трафика оценивайте отдельно по состоянию приложения.
Если приложение предлагает очистить все локальные профили и настройки, прочитайте предупреждение перед подтверждением. Обычное добавление своей подписки не требует соглашаться на незнакомый запрос сброса.
Если импорт не получился
- «Буфер пуст». Скопируйте ссылку заново. Если вставка из буфера недоступна, используйте «Ввести вручную» и вставьте текст в поле.
- «Уже добавляем». Дождитесь окончания текущей загрузки подписки перед повторным добавлением.
- «Ошибка импорта» или сообщение под полем. Проверьте полноту ссылки и содержимое выбранного файла. Используйте ссылку подписки, выданную для клиента: страница входа в кабинет или оплаты может содержать HTML вместо конфигурации. Если адрес или формат не принимается, попросите провайдера проверить ссылку и подготовить конфигурацию для Lacc.
- Профиль появился, но соединения нет. Выберите профиль и сервер, проверьте сообщение о подключении. Успешный импорт и доступность сервера — разные проверки; правила для приложений и сайтов описаны в конструкторе маршрутизации.
Для обращения используйте «Написать нам» в настройках приложения. Укажите версию, выбранный способ импорта и текст ошибки; перед отправкой снимка скройте ссылку подписки и ключ. Переходы из других приложений требуют отдельного подтверждения в окне «Импорт из внешней ссылки».
Официальная загрузка Lacc · Справка по ссылкам lacc:// · Параметры для провайдеров
Доставка параметров
Провайдер отдаёт настройки тремя каналами. Клиент читает все; при конфликте заголовок важнее тела.
| Канал | Формат | Пример |
|---|---|---|
| HTTP-заголовок | key: value в ответе на запрос подписки | routing: lacc://routing/onadd/<b64> |
| Тело | #key: value / #key {value} | #profile-title: Мой сервис |
| URL-фрагмент | ...#?key=value | sub_url#?partnerkey=ABC123 |
Значения могут иметь префикс base64:. Любой доп. ключ (Custom) хранится дословно. Формат единый на всех платформах.
Ссылки lacc://
Генерируем только свои. На импорт дополнительно принимаем чужие того же вида, но наружу отдаём только lacc://.
| Схема | Действие |
|---|---|
lacc://add/<b64> | импорт подписки или ключей |
lacc://crypt/<payload> | зашифрованная ссылка (X25519) |
lacc://hwid/<b64> | подписка, привязанная к устройству |
lacc://routing/add|onadd/<b64> | профиль маршрутизации (+ активировать) |
lacc://routing/off | отключить активный профиль |
?installid=<code> | limited-ссылка (лимит устройств) |
Стандартные параметры free
Применяются с любой подписки, включая чужие и без ключа.
| Параметр | Что делает | Win | And |
|---|---|---|---|
subscription-userinfo | трафик и срок | ✓ | ✓ |
profile-title | имя профиля (+base64) | ✓ | ✓ |
profile-update-interval | период обновления, ч | ✓ | планировщик |
support-url · profile-web-page-url | ссылки поддержки/кабинета | ✓ | частично |
announce · announce-url | объявление (баннер) | ✓ | только тело |
routing-enable | активировать профиль маршрутизации | ✓ | ✓ |
partnerkey · верификация
Идентификатор провайдера, привязанный к домену. Доставка тремя способами: URL #?partnerkey=<ID>, тело #partnerkey {ID}, заголовок partnerkey: <ID>.
GET check.lacc.ru/partner?id=<partnerkey>&domain=<sha256(host)>&hwid=<HWID>&os=<android|windows>&v=<ver>
→ { valid, tier, features[], expires, max_devices, reason }Не чаще раза в 24 ч, кэш с грейсом (сеть недоступна → последний валидный кэш). Применяемое множество = features ∩ тир. reason=device_limit → баннер. Брендинг — только при активном ключе.
HWID · limited-ссылки
HWID — SHA-256 от машинного ID с солью, первые 16 байт → 32 hex. Windows: MachineGuid. Android: ANDROID_ID. Один алгоритм везде; шлётся заголовками hwid+os при запросе подписки.
- HWID-ссылка — привязка к устройству, сверяется локально; чужой → «Ссылка привязана к другому устройству».
- Limited-ссылка (
?installid=) — лимит устройств;check.lacc.ru/install→ partnerkey + статус; сверх лимита → отказ.
Provider API · кабинет
Конверт: { "rc": 1 ok | 0 error | 2 conflict, "msg", ... }. Авторизация: provider_code + auth_key.
Ссылки и домены
add-install/update-install/list-install— limited-ссылки.list-hwid/delete-hwid— устройства по ссылке.add-domain/delete-domain/list-domain— домены (SHA-256, сырой URL не хранится).
Push и команды под auth
/remote/notification— пуш (локали RU/EN/CN/FA, force/optional, срок, расписание)./remote/command—import-data·update-subscription·set-settings·sub-change.
Маршрутизация
Профиль в едином JSON (одинаков на всех платформах): какие сайты через туннель, напрямую или в блок.
Name, GlobalProxy, RouteOrder, ProxySites/ProxyIp, DirectSites/DirectIp, BlockSites/BlockIp, Geositeurl/Geoipurl, DomainStrategy, FakeDNS, DnsHosts, RemoteDNS*, DomesticDNS*, UseChunkFiles.
{
"Name": "Рабочая сеть",
"GlobalProxy": false,
"RouteOrder": "block-proxy-direct",
"ProxySites": ["full:workspace.example"],
"DirectSites": ["geosite:category-ru"],
"DirectIp": ["geoip:ru"],
"BlockSites": ["geosite:category-ads-all"]
}Домены / full: / geosite: → доменные правила; IP / CIDR / geoip: → IP-правила; фазы в порядке RouteOrder; при GlobalProxy=false без proxy-правил — страховка от утечки. Гео-базы качаются с нашего сервера. Доставка: routing: / #routing: / lacc://routing/onadd/.
Крипто-ссылки
Наша схема (не чужой RSA). lacc://crypt/ = X25519 → HKDF-SHA256 (info lacc-crypt-v1) → XChaCha20-Poly1305; формат eph_pub32 ‖ nonce24 ‖ ct+tag, base64url. Sealed-box — шифруем и расшифровываем сами; пользователь не может вытащить исходный URL.
Статус по платформам
Что реально сделано, а что в планах.
Windows ~90%
Премиум-гейтинг заперт, полный набор параметров, маршрутизация с полной DNS-схемой, QR, LAN-share, крипто, HWID. Осталось: xray run-path для тонких транспорт-параметров.
Android ~35%
Готово: клиент, импорт (vless/vmess/trojan/ss/JSON), сервера с честным пингом и «Авто», DNS, mux/fragment/split локально, обновление из приложения, 5 языков, маршрутизация (профили + гео + редактор). По волнам: partnerkey/HWID/гейтинг → параметры → ссылки/крипто/QR → монитор → комфорт.
iOS план
После унификации Windows и Android — единый набор функций переносится на iOS.
Кабинет · check-server ~80%
Верификация ключей, лимиты устройств, домены, push/команды. Дорабатывается веб-интерфейс кабинета.