Руководство по использованию Prostor

1. Как добавить ключ или подписку

Prostor принимает одиночные ключи подключения и ссылки на HTTP/HTTPS-подписки. Ссылка подписки должна возвращать список ключей в Base64 либо совместимый JSON с массивом outbounds.

1. Скопируйте одиночный ключ или URL подписки целиком.
2. Откройте главный экран Prostor.
3. Нажмите «Из буфера» или «Добавить ключ». Приложение само определит, что было передано: ключ или подписка.
4. На Android и iOS можно нажать кнопку QR и отсканировать QR-код с тем же значением.
5. После импорта выберите сервер и запустите подключение.

2. Добавление через deep link

Единый формат для Windows, macOS, iOS и Android:

prostor://add/<URL-encoded ключ или URL подписки>

Пример со ссылкой подписки:

prostor://add/https%3A%2F%2Fsub.example.com%2Fs%2Fdemo

Формирование ссылки в JavaScript:

const source = 'https://sub.example.com/s/demo'
const deepLink = `prostor://add/${encodeURIComponent(source)}`

3. Как удалить ключ или подписку

1. Откройте главный экран со списком конфигураций.
2. Для одиночного ключа нажмите крестик справа от строки сервера.
3. Для подписки нажмите значок корзины в заголовке блока подписки и подтвердите удаление.

Удаление подписки удаляет из приложения саму ссылку и все полученные из неё серверы. Это локальная операция: она не отменяет тариф и не удаляет аккаунт у провайдера.

4. Интеграция сервера подписки

При добавлении или обновлении HTTP/HTTPS-подписки Prostor выполняет GET-запрос. Имена HTTP-заголовков регистронезависимы. Не кэшируйте персонализированный ответ только по URL: он может зависеть от X-Hwid и платформы.

4.1. Заголовки, которые отправляет приложение

GET /s/demo HTTP/1.1
Host: sub.example.com
User-Agent: Prostor/ios
X-Hwid: A1B2C3D4-…
X-Device-Model: iPhone
X-App-Version: 1.0.0.2
X-Ver-Os: 18.6
Cache-Control: no-cache, no-store, max-age=0
Pragma: no-cache

4.2. Заголовки ответа, которые обрабатывает Prostor

Основные параметры задают название, срок действия, объявление и ссылки подписки. Расширенные параметры Sub-Info-* и Sub-Expire-* управляют информационным баннером и предупреждением о продлении. Дополнительный Provider ID для этих функций Prostor не требует.

Звёздочка у Android означает, что значение распознаётся и сохраняется, но отдельное действие в текущем интерфейсе может отсутствовать. Для кроссплатформенной интеграции ориентируйтесь на строки, где перечислены все четыре платформы.

4.3. Формат HTTP-ответа

Prostor читает параметры подписки только из настоящих HTTP response headers. Формат одинаков для Windows, macOS, iOS и Android.

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: no-store
Profile-Title: base64:UHJvc3RvciBEZW1v
Subscription-Userinfo: upload=0; download=0; total=107374182400; expire=1798761600

dmxlc3M6Ly9leGFtcGxlLWtleS0x

4.4. Полный пример HTTP-ответа

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: no-store
Profile-Title: base64:UHJvc3RvciBEZW1v
Subscription-Userinfo: upload=0; download=0; total=107374182400; expire=1798761600
Profile-Update-Interval: 6
Support-Url: https://example.com/support
Sub-Info-Color: blue
Sub-Info-Text: base64:TmV3IHNlcnZlcnMgYXJlIGF2YWlsYWJsZS4=
Sub-Info-Button-Text: base64:0J/QvtC00YDQvtCx0L3QtdC1
Sub-Info-Button-Link: https://example.com/news
Sub-Expire: true
Sub-Expire-Button-Link: https://example.com/renew

dmxlc3M6Ly9leGFtcGxlLWtleS0xCnZsZXNzOi8vZXhhbXBsZS1rZXktMg==

4.5. Правила совместимости

• Для Profile-Title и Announce используйте base64: и Base64 от UTF-8 строки.
• Для ссылок используйте абсолютный https:// URL.
• expire передавайте как Unix timestamp в секундах.
• Информационный баннер появится, только если задан Sub-Info-Text.
• Кнопка информационного баннера появится, только если одновременно заданы её текст и ссылка.
• Предупреждение Sub-Expire требует корректного expire и показывается, когда осталось не более трёх дней.

5. Если импорт не сработал

• Проверьте, что ключ или URL скопирован полностью, без кавычек и пробелов по краям.
• Откройте URL подписки отдельно и убедитесь, что сервер возвращает непустое тело.
• Не возвращайте HTML-страницу авторизации вместо списка ключей.
• При ограничении устройств возвращайте X-Hwid-Limit: true и не отдавайте старую закэшированную подписку.
• Для deep link проверьте percent-encoding всего вложенного значения.