Admin UI Manual
中文版本:管理系统用户手册
The management console runs on port 1816 (HTTP) and is built with React Admin. It is bilingual (中文 default, English via the app-bar language menu) and supports light/dark themes. This chapter walks through every page.
Logging in and accounts
Sign in at http://<server>:1816 with an operator account. The initial administrator is admin plus a one-time password in {workdir}/private/admin-bootstrap-password (or TOUGHRADIUS_ADMIN_PASSWORD). Change it immediately under Account Settings (top-right avatar), which also edits your profile info. Passwords must be at least 6 characters and must not be the historical default.
Operator roles (set under Operators):
super
Full access, including System Config and Operators
admin
Same menu visibility as super
operator
Day-to-day pages only — System Config and Operators are hidden
Dashboard
The landing page summarizes the deployment:
Stat cards — total users (with disabled/expired counts), online users, today's authentication and accounting request counts, today's upload/download traffic in GB.
IPv6 strip — online sessions with IPv6, IPv6 address/prefix/delegated prefix counts, users with static IPv6 configuration.
Charts — authentication trend, profile distribution pie, and a 24-hour upload/download traffic chart.
Counters are driven by in-memory metrics; see the Operations Guide.
Network Nodes
Logical groups (name, tags, remark) used to organize NAS devices. Create nodes first — each NAS belongs to one.
NAS Devices
Registry of network devices allowed to talk RADIUS to this server. Requests from unknown source addresses are dropped.
Name / Identifier
Free-form name; identifier matches the RADIUS NAS-Identifier
IP address / Hostname
The source address of RADIUS packets
Vendor
Decides vendor attribute behavior — Standard, Cisco, Huawei, MikroTik, H3C, ZTE, iKuai (see the Vendor Integration Guide)
Secret
RADIUS shared secret
CoA port
Where CoA/Disconnect are sent; default 3799
Node / Status / Tags / Remark
Organization and lifecycle
RADIUS Users
Subscriber accounts. List supports filtering by username, real name, email, mobile, and IP, plus CSV export and column sorting.
Key form fields: username/password, status (enabled/disabled), billing profile (required — rates, concurrency, pools, and Class inherit from it), expire time (drives Session-Timeout), static ip_addr / ipv6_addr, IPv6 prefix pools and delegated prefixes (edit view), radius_class (RFC 2865 Class, emitted as-is), contact info, remark.
Batch import: the list toolbar's import button accepts .xlsx, .csv, or .json files and reports created/failed counts. Export the current list as a template reference.
The show view groups everything including IPv6 details, MAC/VLAN binding values, and timestamps.
Billing Profiles
Reusable authorization templates:
active_num
Max concurrent sessions per user (0 = unlimited)
up_rate / down_rate
Bandwidth in Kbps; converted per vendor (list shows Mbps for values ≥ 1024)
addr_pool
Framed-Pool name the NAS allocates from
radius_class
RFC 2865 Class (Type 25), written into Access-Accept as-is; for ocserv groups use OU=group1;group2
ipv6_prefix / domain
IPv6 and Huawei domain authorization
bind_mac / bind_vlan
Lock users to first-seen MAC / VLANs
Online Sessions
Live sessions (radius_online). Columns include session ID, framed IP, NAS address/port, start time, duration, timeout, and traffic counters. Filters cover username, session ID, IPv4/IPv6 addresses and prefixes, NAS address, MAC, and start-time ranges.
Per-row actions (this is where RFC 5176 dynamic authorization lives):
修改授权 / CoA — send a
CoA-Requestwith a new session timeout and/orFilter-Id.强制下线 / Disconnect — send a
Disconnect-Requestto terminate the session (with confirmation).
Both target the NAS CoA port and report success/failure as a notification.
Accounting
Historical accounting records (radius_accounting), read-only: session ID, addresses, start/stop time, total input/output traffic. Same filter set as Online Sessions plus stop-time data; CSV export supported.
System Config
Visible to super/admin only. Settings are schema-driven, grouped into accordions (RADIUS group expanded by default), and live in the sys_config table — changes apply without restart. The 13 RADIUS settings:
EapMethod
eap-md5
Active EAP method: eap-md5, eap-mschapv2, eap-tls, eap-peap, eap-ttls
EapEnabledHandlers
*
Comma allow-list of permitted EAP handlers
EapTlsServerCert
empty
Name of the managed server certificate (import and select it on the Certificates page) presented for EAP-TLS/PEAP/TTLS; empty disables certificate-based EAP
EapTlsClientCa
empty
Name of the managed CA certificate used to validate client certificate chains (EAP-TLS only)
EapTlsMinVersion
1.2
Minimum TLS version (1.2/1.3)
EapTlsCipherProfile
modern
TLS 1.2 cipher policy: modern (ECDHE+AEAD), legacy-rsa-cbc (opt-in RSA+AES-CBC for hostapd internal TLS; needs an RSA server cert), or custom
EapTlsCipherSuites
empty
Custom TLS 1.2 suite list when the profile is custom
IgnorePassword
false
Skip password verification (testing only)
AccountingHistoryDays
90
Accounting retention days (@daily cleanup; 0 disables)
AcctInterimInterval
300
Seconds between NAS interim updates
SessionTimeout
3600
Default session timeout seconds
LogLevel
info
RADIUS log verbosity (debug/info/warn/error)
RejectDelayMaxRejects
7
Consecutive rejects before delaying responses
RejectDelayWindowSeconds
10
Window for the reject counter
Toolbar: Save, Refresh, Reset (restore defaults, confirmed), and Backup / Restore — export or re-import a JSON snapshot of nodes, NAS, profiles, users, settings, and operators (see the Operations Guide for what it does not include).
Operators
Management of console accounts (super/admin only): username, password, contact info, level, status. The operator action log is kept in the database (sys_opr_log) and purged automatically after one year.
UI conveniences
Language switcher (app bar) — 简体中文 / English, persisted per browser.
Theme toggle — light/dark.
CSV export on users, sessions, accounting, NAS, nodes, operators.
Server-side pagination and active-filter chips on all list pages.
Last updated