Subscriptions
Maintain provider profiles, node visibility, updates, usage, and expiry.
Updated
A subscription is a provider profile that can contain many nodes and optional profile information. Tunna fetches the profile, processes the nodes, and shows them in Outbound under that subscription. This is how Tunna keeps managed node lists usable without asking you to edit every server by hand.
Adding a subscription
What the subscription screen shows
General Settings
Use these fields to name the provider profile and control how Tunna fetches and displays it.
Name
The local label for the profile. Provider titles can fill it when the name is still blank or default.
Auto Update
Lets Tunna refresh the profile when the provider interval has elapsed and the app has a chance to check it. Use Update when you want the latest nodes, usage, expiry, or provider links immediately.
User Agent
Choose Tunna, Chrome, Firefox, Safari, iOS, Android, or Edge for the request identity. Keep Tunna unless the provider requires another choice.
Node Visibility
Choose All, Active, or Top 10 to decide which subscription nodes appear in Outbound.
Source
The remote URL is the provider address Tunna fetches. Paste in the Source field fills the URL for this subscription and starts a fetch after a valid URL is submitted and the network is available.
Status footer
A colored status line shows Ready to fetch, Fetching data, Processing data, Active, Failed, or Expired. Failed rows show the error message when Tunna has one.
Update
The Update button fetches the current remote URL again. It is disabled for new profiles, empty URLs, and fetches already in progress.
Profile and Support
These bottom buttons open provider links only when the fetched profile includes them.
Node Visibility
| Choice | What Outbound shows | Best for |
|---|---|---|
| All | Every selectable node from the subscription. | Browsing or manually choosing from the full list. |
| Active | Nodes with recent successful checks, with a fallback when none are active. | Hiding stale nodes without losing a safety fallback. |
| Top 10 | The ten best nodes by recent latency. | Large subscriptions where the fastest choices should be visible first. |
Subscription maintenance
Paste and import
Add Subscription opens a blank edit screen for a provider URL. Paste on the list is different: it handles Tunna import URLs and encoded subscription payloads. An ordinary provider URL belongs in the Source field of a subscription edit screen.
Refresh all
The toolbar Update button refreshes remote subscriptions together. It is unavailable while another refresh is running, while any subscription is fetching, when the list is empty, or when every subscription has no remote URL. A refresh-all saves changed subscriptions and nodes only when at least one fetch succeeds.
Manual Update
Refresh one profile from its row or edit screen when nodes, usage, expiry, or provider links look stale.
Provider details
Tunna can show upload, download, available quota, expiry, last update, profile link, support link, and profile update interval when the provider sends them.
What a fetch updates
During a fetch, Tunna sends the selected User Agent, downloads the provider profile, reads provider metadata when available, then parses node links from the response. If no usable nodes are found, the subscription is marked failed. When a provider sends metadata, Tunna can update usage, expiry, profile link, support link, profile title, and profile update interval.
Reading subscription rows
Rows use the saved name, provider host, or Untitled when there is no better label. A colored status dot and text show Ready to fetch, Fetching data, Processing data, Active, Failed, or Expired. Fetching and Processing rows show progress. Other rows show usage as used quota over total quota when the provider sends it, or No usage data when it does not. Expiry can read Expires, Outdated, Expired, or No expiry depending on provider metadata.
Edit controls change with the profile state
New subscription screens show New Item and Add. Saved profiles show Edit Item and Save. Delete is disabled until the profile has been saved once. Add or Save is disabled when the Source URL is empty or a fetch is in progress. Update is disabled for new profiles, empty URLs, and active fetches. Profile and Support buttons appear in the bottom toolbar and open only after the provider sends those links.
Deleting a subscription removes its nodes
Deleting a subscription removes the subscription entry and its subscription-managed nodes. Tunna also cleans routing and observability references that pointed at those nodes, so review affected rules after deletion.
Updates can change your node list
A provider can remove, rename, or expire nodes during a refresh. If a rule points to a removed subscription node, review the rule after updating.