# Subscriber panel

> The self-serve page your users get at /sub/{key}, with usage, QR codes and one-tap import.

Source: https://joinnasnet.com/en/guides/nasnet-linux/subscriber-panel/
Last updated: 2026-08-14

---

## Overview

The subscriber panel is the public page served at `/sub/{key}`, and it is the
only part of Nasnet Linux your users ever see. It is the same URL as the
subscription link: when a VPN client fetches it the server returns a Base64
config feed, but when a browser opens it the request is redirected to this
page instead, provided `SUB_PANEL_URL` is configured. Point users here so they
can check their own usage and re-import their config without asking you.

## Before you start

- Set `SUB_PANEL_URL` (and `app_base_url`) in **Settings → Server**, or a
  browser hitting the link gets raw config text instead of the page.
- The page is public by key. Treat the link key as the credential it is.

## Steps

1. Copy a subscription's link from **Subscriptions** and give it to the user.
2. The user opens it in a browser and sees their subscription status, a **Copy
   Link** button, and their usage figures.
3. From the server list they can import a specific server into a client app, or
   scan its QR code.
4. Usage over time is shown as a heatmap and a trend chart, alongside a forecast
   of when the data will run out.
5. If WireGuard is in play, the user manages their devices from the same page.
6. A user can supply their Telegram chat ID from this page to connect their
   Telegram identity to the subscription.

## Reference

| Area | What the user gets |
| ---- | ------------------ |
| Header | Subscription status badges and a **Copy Link** button. |
| Stats grid | Data used, data remaining and time remaining. |
| Server list | The servers in the subscription, with QR codes and one-tap import to client apps. |
| WireGuard devices | Per-device WireGuard configuration for this subscription. |
| Data forecast | Projected exhaustion based on recent usage. |
| Usage heatmap and trend chart | Usage over time. |
| Telegram chat ID | Links the subscription to a Telegram identity. |

The panel ships icons for v2rayNG, v2rayN, V2Box, Shadowrocket, Streisand and
Quantumult X, and the subscription endpoint auto-detects the client from its
`User-Agent`, so one link works across v2rayNG, v2rayN, Clash-family clients,
sing-box and Shadowrocket without the user choosing a format.

## Troubleshooting

**Opening the link in a browser downloads a blob of text.** `SUB_PANEL_URL` is
not set, so the server has nowhere to redirect a browser to. Set it in
**Settings → Server**.

**The page reports the subscription was not found.** The link key is wrong, or
the subscription was deleted. Re-copy the link from **Subscriptions**; link keys
are rotated rather than reused.

## Related

- [Subscriptions](/en/guides/nasnet-linux/subscriptions/)
- [Settings](/en/guides/nasnet-linux/settings/)
- [Telegram bot](/en/guides/nasnet-linux/telegram-bot/)