ZefiraZEFIRA Docs GitHub ↗

Users & Plans

Everything about selling and managing accounts.

Creating a user

  1. Open Users → New user.
  2. Pick a username (English letters, digits, _, 3–32 chars).
  3. Select one or more protocols — any mix of VLESS, REALITY, VMess, Trojan, Shadowsocks, Hysteria2, WireGuard, OpenVPN.
  4. Set volume (GB) and duration (days).
  5. Optional: note, device limit, start-on-first-use. Save.

The panel generates all secrets instantly (UUIDs, X25519 keys, OpenVPN certificates from its own CA) and shows the subscription link + QR.

Plan mechanics

OptionWhat it does
Volume (GB)Traffic quota. At 100% the subscription stops working until you add volume or reset usage.
Duration (days)Expiry date counted from creation — unless start-on-first-use is on.
Start on first useExpiry countdown begins at the user's first subscription fetch. Ideal for pre-sold codes.
Device limitInformational cap shown in Clash configs (# zefira-device-limit); enforced by compatible clients.
Active toggleInstantly disables every protocol without deleting the account.

Managing users

Templates

Save recurring plans (Templates) — name, protocols, volume, days, first-use and device limit — then create users from a template in one click. Template names allow letters, digits, spaces, _ and -.

Inbounds

Extra ports per protocol (Inbounds): give VLESS port 443 and 8443, each with its own host. Subscription links and Clash configs include every enabled inbound automatically, labeled with the inbound name.

Tunnels (BackPack)

Register Iran ⇄ Kharej tunnels: transport, both IPs, tunnel port, forwarded ports, UDP flag. Zefira stores an encrypted token per tunnel, generates a step-by-step setup guide for both servers, and can probe the Iran endpoint (Check now) with automatic online/offline status.

Anti-censorship settings

SettingEffect
REALITY keysGenerate an X25519 keypair; private key stays encrypted, reveal is audit-logged.
REALITY SNI listComma-separated SNIs, rotated across the generated links.
Obfuscated hostReplaces the real domain inside configs with a decoy host.
Per-user subdomainPrefixes a per-user hash (a1b2c3d4.domain) so links are not correlatable.
CDN SNI spoofingUses a separate CDN domain for TLS SNI.
Block direct IPReturns 403 for panel/API access via raw IP — domain only.

Site blocker

Append blocked domains to every Clash config (DOMAIN-SUFFIX,…,REJECT), plus a one-click porn preset (15 major domains). Max 500 custom entries.

Backup & restore

Backups contain password hashes and encrypted secrets — store them like passwords, never in a public place.