Prostor user guide

1. Adding a key or a subscription

Prostor accepts single connection keys and HTTP/HTTPS subscription links. A subscription link must return a list of keys in Base64 or compatible JSON with an outbounds array.

1. Copy the single key or the whole subscription URL.
2. Open the Prostor home screen.
3. Press "From clipboard" or "Add key". The app works out on its own whether it received a key or a subscription.
4. On Android and iOS you can press the QR button and scan a QR code with the same value.
5. After the import, pick a server and start the connection.

2. Adding through a deep link

One format for Windows, macOS, iOS and Android:

prostor://add/<URL-encoded key or subscription URL>

Example with a subscription link:

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

Building the link in JavaScript:

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

3. Removing a key or a subscription

1. Open the home screen with the list of configurations.
2. For a single key, press the cross to the right of the server row.
3. For a subscription, press the bin icon in the subscription block header and confirm.

Removing a subscription deletes the link itself and every server it delivered from the app. It is a local operation: it does not cancel anything or delete your account with the provider.

4. Subscription server integration

When a HTTP/HTTPS subscription is added or refreshed, Prostor sends a GET request. HTTP header names are case-insensitive. Do not cache a personalised response by URL alone: it may depend on X-Hwid and on the platform.

4.1. Headers the app sends

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. Response headers Prostor understands

The core parameters set the name, expiry, announcement and links of the subscription. The extended Sub-Info-* and Sub-Expire-* parameters drive the info banner and the renewal warning. Prostor needs no additional Provider ID for these features.

An asterisk next to Android means the value is recognised and stored, but a separate action may be missing from the current interface. For cross-platform integration, rely on the rows that list all four platforms.

4.3. HTTP response format

Prostor reads subscription parameters from real HTTP response headers only. The format is the same for Windows, macOS, iOS and 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. Full HTTP response example

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. Compatibility rules

• For Profile-Title and Announce use base64: followed by Base64 of the UTF-8 string.
• For links use an absolute https:// URL.
• Send expire as a Unix timestamp in seconds.
• The info banner only appears when Sub-Info-Text is set.
• The info banner button only appears when both its text and its link are set.
• The Sub-Expire warning needs a valid expire and shows when three days or fewer remain.

5. If the import did not work

• Check that the key or URL was copied in full, with no quotes or stray spaces.
• Open the subscription URL on its own and make sure the server returns a non-empty body.
• Do not return an HTML login page instead of the list of keys.
• When a device limit is hit, return X-Hwid-Limit: true and do not serve a stale cached subscription.
• For deep links, check the percent-encoding of the whole nested value.