On first open you'll see the admin login page. Enter the password set by the ADMIN_PASSWORD environment variable. Successful login grants a 2-hour session token stored in localStorage. Closing and reopening the browser will auto-restore the session.
More than 10 wrong attempts from the same IP triggers a 15-minute rate limit, returning 429.
The Logout button in the topbar ends the current session.
After login, the page has the following sections, top to bottom:
| Section | Visible by default | Description |
|---|---|---|
| Stats bar | Yes | Next to title: green dot + Nodes / Env / Stored counts |
| Topbar buttons | Yes | Toggle visibility of cards and subsections |
| Subscription URL | Yes (toggle with Sub) | Subscription link + config export + node upload |
| Client Export | No (expand with Client) | Full config.json export — Kernel / Windows / Android (SFA) / Momo |
| Node Upload | No (expand with Upload) | Node push API URL |
| Upstream Sources | No (expand with Upstream) | External subscription import |
| Access Tokens | Yes (toggle with Tokens) | Primary + scoped token management |
| Nodes | Yes (toggle with Nodes) | Node CRUD |
| Audit Log | No (expand with Log) | Operation audit trail |
Toggled-on buttons are highlighted (accent border + color). Sub, Tokens, and Nodes cards default to visible; click their buttons to hide.
The first card after login, showing the main subscription URL.
Format: https://your-domain.com/sub?token=<32-char-hex>
Operations:
- 🎲 Rotate — generate a new token; old one invalidates immediately. All clients must update
- ⎘ Copy — copy subscription URL to clipboard
- ▦ QR Code — show QR code for phone scanning
Paste this URL into your client's subscription field (husi, sing-box, NekoBox, Clash Meta, etc.).
The topbar Hide button masks sensitive content: node names become •••••••, subscription/config URLs show Hidden for screenshot. Useful for sharing screenshots without exposing private data.
Select OpenWrt-momo in the Client platform dropdown. Generates a complete sing-box config.json for luci-app-momo on OpenWrt routers.
Dropdown with 4 options:
| Preset | IPv6 | DNS | TUN Interface |
|---|---|---|---|
IPv4 + RealIP |
No | Real DNS | momo |
IPv4 + FakeIP |
No | FakeIP (198.18.0.0/15) | momo |
IPv4+6 + RealIP |
Yes | Real DNS | momo |
IPv4+6 + FakeIP |
Yes | FakeIP + v6 range | momo |
- Select a preset
- Press ⎘ to copy the URL
- Paste into momo's "Subscription" or "File" profile
Momo auto-syncs upstream sources on each request (when upstream sources exist), deduplicated by a 60s minimum interval. Add ?refresh=0 to skip. Failed sources are served from cache with an X-Upstream-Warning header.
URL format:
https://your-domain.com/api/export/momo?token=<sub_token>&preset=ipv4only_realip
log: info level with timestampsdns: real DNS (local UDP → ali DoH → Google DoH); FakeIP presets add FakeIP server + A/AAAA rewritentp: time sync (time.apple.com)inbounds: dns-in (1053), redirect-in (7890), tproxy-in (7891), tun-in (momo device)outbounds: all nodes + GLOBAL selector + directroute: sniff → hijack-dns → private-ip → geosite-cn → geoip-cn → selectorexperimental: cache_file + clash_api (Yacd-meta dashboard, port 9095)
Select Kernel (HPC/Linux) in the Client platform dropdown. Generates config for the sing-box kernel on Linux desktop / HPC (/etc/sing-box/config.json).
Same 4 presets as Momo. Key differences:
| Feature | Momo | Kernel |
|---|---|---|
| redirect-in | Yes | No |
| tproxy-in | Yes | No |
| mixed inbound | No | Yes (7890, HTTP/SOCKS) |
| TUN auto_route | No | Yes |
| TUN interface | momo |
stun |
| TUN IPv4 | 172.31.0.1/30 | 172.19.0.1/30 |
| NTP | Yes | No |
| auto_detect_interface | No | Yes |
| Clash API port | 9095 | 9191 |
URL format:
https://your-domain.com/api/export/kernel?token=<sub_token>&preset=ipv4only_realip
Select Windows in the Client platform dropdown. Generates a complete config.json for sing-box on Windows desktop.
Same 4 presets as Kernel. Differences from Kernel: set_system_proxy: true on the mixed inbound, strict_route: true, Clash API on port 9090, and a relative cache.db.
URL format:
https://your-domain.com/api/export/windows?token=<sub_token>&preset=ipv4only_realip
Select Android (SFA) in the Client platform dropdown. Generates a complete config.json for the official sing-box for Android app.
Same 4 presets as the other platforms. Key differences from Windows:
| Feature | Windows | Android (SFA) |
|---|---|---|
| TUN interface name | stun |
omitted (Android VpnService owns the device) |
| Mixed inbound system proxy | set_system_proxy: true |
not set — TUN handles routing |
| Route rule order | sniff last | sniff first (domain rules need the sniffed host) |
| Per-app proxy | — | include_package / exclude_package |
| Clash API port | 9090 | 9090 |
URL format:
https://your-domain.com/api/export/android?token=<sub_token>&preset=ipv4only_realip
| Param | Description |
|---|---|
includePackage |
Comma-separated package names to proxy (e.g. com.android.chrome,com.termux) |
excludePackage |
Comma-separated package names to bypass |
overrideAndroidVpn |
1 to accept another VPN as upstream (route.override_android_vpn) |
Per-app proxy can also be overridden from SFA's own "Overrides" settings.
log,dns,outbounds,http_clients: same as Windowsinbounds: dns-in (1053), tun-in (VpnService,auto_route+strict_route), mixed (7890)route: sniff → hijack-dns → private-ip → geosite-cn → geoip-cn → selectorexperimental: cache_file (cache.db) + clash_api (Yacd-meta dashboard, port 9090)
Click the Upload button to expand. Shows the API endpoint and token for pushing nodes.
Controlled by the UPLOAD_TOKEN environment variable. Unset → shows "— (UPLOAD_TOKEN not set)" and the upload API returns 403.
When set, displays the full URL with token:
POST https://your-domain.com/api/upload?token=<upload_token>
- 🎲 Rotate — generate new upload token; old one invalidates
- ⎘ Copy — copy upload URL
curl -X POST "https://your-domain.com/api/upload?token=<upload_token>" \
-H "Content-Type: application/json" \
-d '{"nodes":["vless://uuid@server:port?params#Name"]}'Returns: {"ok": true, "added": 3, "dupes": 1}
- Only valid-scheme URIs are accepted
- Existing nodes are skipped and counted as dupes
- Same
#namegets-2,-3suffixes - Each upload is recorded in the audit log as
upload - Token is independent from session and subscription; upload-only, cannot view nodes
Click the Upstream button to expand. Import external subscription URLs as upstream sources.
You have nodes from another subscription provider and want them included in subhatch's Momo / Kernel exports. Add their subscription URL as an upstream source — each export will automatically pull and merge those nodes into the GLOBAL selector.
Upstream nodes are invisible to scoped tokens — only the primary token (momo/kernel exports) sees them.
Click + Add:
- Enter the subscription URL (e.g.
https://provider.com/sub?token=xxx) - Enter a name (optional; falls back to URL hostname)
- Initial sync runs automatically on creation
Supports both base64 and plain text formats.
Each source shows: name, URL, last sync time, node count / error message.
| Button | Action |
|---|---|
| Sync | Sync a single source. Success: update cache. Failure: keep last-good cache |
| Sync All | Sync all sources at once |
| ✕ | Delete source and its cached nodes |
- Each sync replaces entirely, not appends
- Failed syncs retain the previous cache
- Sync results written to audit log (
upstream-sync): success → INFO, failure → ERROR - Momo / Kernel exports auto-sync upstream by default (60s min interval per source; add
?refresh=0to skip)
Manage subscription access tokens. One card showing all tokens.
Initialized from the SUB_TOKEN environment variable. Can be rotated in the UI. Access to all nodes (env + stored + upstream). Rotation invalidates the old token immediately.
Scoped tokens restrict access to a specific subset of nodes. Share different node sets with different people.
Operations:
- + Create Token — create a new scoped token, opens node assignment immediately
- Assign nodes — check/uncheck nodes; the token can only access those checked
- Rename — click the token name to edit
- ⎘ Copy — copy the token's subscription URL
- ▦ QR Code — show QR code for this token
- 🎲 Rotate — generate new key; old one invalidates
- ✎ Edit nodes — reassign which nodes this token can access
- ✕ Delete — remove the token
Scoped tokens can only access stored nodes + env nodes. Upstream source nodes are excluded from scoped token filtering.
Node management card. All node operations happen here.
Paste a node URI (vless://...) into the input, press Enter or click + Add. Auto-saves; status bar shows Saving... → Saved.
Click Bulk Import to open the import modal. Supports:
- Multi-line paste, one URI per line
- Pipe
|or newline-separated - Base64-encoded subscription content (auto-detected and decoded)
Click Import; duplicates are skipped automatically.
Click Export JSON to download all nodes as a sing-box outbounds JSON file. Invalid URIs are recorded as errors but don't block the export of valid ones.
Each row displays:
- Scheme badge (vless, vmess, trojan, etc.)
- Node name (extracted from
#fragment, or hostname:port) - Source label: ⚙ env (injected via environment variable) / ✎ stored (added manually)
- ✕ Delete button (stored nodes only; env nodes can't be deleted)
Click a node row to copy its full URI to clipboard.
The list is sorted by scheme type, then by name. Stats in the header update automatically.
vless:// vmess:// trojan:// ss:// ssr:// hysteria2:// hy2:// tuic:// anytls:// naive://
Click the Log button to expand. Records all administrative actions.
Each entry contains:
| Field | Description |
|---|---|
| Timestamp | To-second precision |
| Level | INFO / WARN / ERROR (color-coded) |
| Action | Operation type |
| IP | Source IP address |
| Detail | Extra info (node count, token name, etc.) |
| Level | Color | Meaning |
|---|---|---|
| ERROR | Red | Upstream sync failure |
| WARN | Amber | Wrong password, rate-limit triggered |
| INFO | Muted | All normal operations |
| Action | Level | Trigger |
|---|---|---|
login |
INFO | Successful login |
login-failed |
WARN | Wrong password |
blocked |
WARN | Rate limit triggered (429) |
logout |
INFO | Session ended |
sub |
INFO | Subscription accessed |
nodes-save |
INFO | Nodes updated |
token-create |
INFO | Scoped token created |
token-update |
INFO | Scoped token modified |
token-rotate |
INFO | Token rotated |
token-delete |
INFO | Scoped token deleted |
export-momo |
INFO | Momo config exported |
export-kernel |
INFO | Kernel config exported |
export-json |
INFO | Sing-box JSON exported |
upload |
INFO | Node uploaded via API |
upstream-add |
INFO | Upstream source added |
upstream-sync |
INFO/ERROR | Upstream sync (ERROR if any source failed) |
upstream-delete |
INFO | Upstream source deleted |
Max 500 entries retained. Operations:
- ↻ — Refresh log
- ✕ Clear — Clear all entries