OpenPortal认证计费系统-用户手册 · Radius 管理

适用系统：OpenPortalServer V6 后台 — Radius 管理

手册说明：本文所有截图取自系统实际界面并按页面原样展示（未做任何遮挡），实际参数以生产环境为准。

一、模块概述

Radius 管理维护网络接入设备（NAS）的对接参数，并提供 Radius 侧的在线监控与历史连接记录。

• NAS 指 AC、BRAS、路由器等向上联认证服务器发起认证请求的设备。每台设备都需要在本模块登记，否则 Radius 认证不会生效。
• 在线列表反映当前通过 Radius 上线的用户，可在此强制下线。
• 连接记录保存历史上下线明细，可按条件查询与导出。
• 对接配置按设备登记信息生成带中文注释的配置范例，须核对型号、版本和实际业务目标后再手工使用；「应用到设备」提供登录、探测与分步下发向导（见 3.5）。

二、NAS 列表

2.1 查询与操作

2.2 列表字段

三、NAS 对接配置

设备登记完成后，点该行的「对接配置」，平台会生成一份带中文注释的二层 Portal 配置范例。范例同时列出交换机与无线 AC 的用法，不能整段一起粘贴；请先核对版本、对象占用和实际业务目标，只取用适用的那部分。「应用到设备」不执行这段范例文本，而是另行探测设备并生成分步计划。

3.1 入口与填写

在 NAS 列表操作列点「对接配置」，弹出「设备对接配置」窗口。标题下方提示「NAS：AC（RADIUS 的 NAS IP 与密钥取本记录）」，表示密钥、CoA 端口等直接取自该行登记内容，窗口中不需要重复填写。

点「生成对接配置」进入范例页；点「取消」关闭窗口，不产生任何改动。

3.2 参数来源核对

生成页第一部分把每条参数「取什么值、从哪儿来」列成一张表，建议先逐行核对再下发。

• 认证服务器 IP、放行 DNS、用户网关 IP：来自窗口输入；
• NAS 设备 IP、RADIUS 共享密钥、CoA 端口：来自 NAS 列表当前记录；
• Portal 密钥、Portal basip、Portal 版本、设备本地监听端口：来自「BAS 对接设置」记录（Portal 管理 → 多 BAS 对接设置），取值顺序为 ① NAS IP 精确匹配 → ② BAS 名称与 NAS 名称吻合（不分大小写）→ ③ 回落「基础对接设置」；
• Portal 端口（服务器监听）：来自「设备对接默认设置」的 BAS 端口；
• RADIUS 认证 / 计费端口：来自系统设置的 RADIUS 端口；
• 设备认证形态：只有华为设备才显示该行，其下方紧接三个档位按钮，见本节末。

表下方另有说明：网址参数取自「URL 参数设置」（Portal 管理 → Url 自定义参数携带设置）。静态配置范例只预置终端 IP 与终端 MAC 两项，其他候选以 # 注释列出，设备不一定支持。分步向导与静态范例不同：向导的 URL 步骤初始不带传参，只在「追加校验」通过后自动组装，操作见 3.6。

没匹配到本设备专用记录时（表格上方会出现提示条，务必先看一眼再看配置）：

• 红色提示条（没匹配到本设备专用记录，用了「基础对接设置」）：首句加粗「本次使用基础对接设置生成」，条内列出本次取到的 BAS IP、Portal 版本与内存中可用的对接设置；打开本页时还会弹出一次同标题同内容的提醒框，关掉即可继续。此时 Portal 密钥 / basip / 版本取自基础对接设置，可能与本设备实际不一致，生成出来的命令会跟着错；请先到「Portal管理 → BAS对接设置」按 NAS IP 或名称补录本设备，再重新生成。配置文本开头的注释区也会多一行 # 对接设置，写明本次取值出处（按 NAS IP 匹配到的正常情况没有这一行）。
• 同样是红色提示条（连基础对接设置都没有）：说明内存里没有任何可用对接设置，配置按展示页兜底值生成（Portal 密钥 portal、basip 形如 x.x.x.x），只是占位，照抄会认证不通；请先到「Portal管理 → BAS对接设置」保存基础对接设置并重启服务（内存配置只在启动与后台保存时刷新），再回来重新生成。此时配置文本在「端口」那一行下面会标 # 对接设置 : 未匹配BAS设置。

华为设备的三档认证形态：「设备认证形态」这一行下方是三个档位按钮 —— 模版模式[新]、统一模式[老]、传统模式[老]，当前档位为蓝底、另外两个为白底。点任一档位只按该形态重新生成下方的静态范例，其余入参原样带回，不会改动设备上的任何配置。

• 判据看设备提示而不是版本号：在设备上敲 ?，能补出哪条命令就按哪一档。档位选错时生成的命令会被设备拒绝，平台不会自动改用其他档位。
• 档位只影响本页静态范例。3.5 的分步向导不看这里的选择，始终按设备实际配置自动识别，两者不必手工对齐。

3.2.1 取消配置（Undo）

范例页「应用到设备」的右边有一个红色按钮「取消配置（Undo）」——与按钮组右侧的「关闭」同一颜色，表示它是「撤销」类入口（整个按钮组的作用见 3.3 末尾的表）。点开后是一个弹层，内容是平台按反向无依赖顺序预先排好的撤销命令；这一层只负责展示与复制，不连设备、不下发、不保存。

为什么顺序是反的：正向配置是「先建对象 → 再把对象挂到接口」，撤销必须倒着来 —— 先解绑（把接口上的认证引用去掉）→ 再删引用方（模板链、认证域、免认证模板这类引用别人的段落）→ 最后删被引用对象（RADIUS 模板、Portal 服务器、认证域本身）。顺序一旦颠倒，设备会直接拒绝「对象正在被引用」，撤销只能半途而废。弹层里的模块就是从正向配置的最后一步往前排的。

两个限制要知道：

1. 本层用的是静态范例里的固定值（对象名固定 portal、免认证规则编号取范例内写死的那几条），与真实设备上的对象名、规则编号不一定一致。要对真实设备撤销，请走向导里的「无条件回退配置（Undo All）」，它用计划里的真实对象名，免认证编号也按设备实际配置解析，见 3.5.1。
2. 撤销命令只改运行配置，不会自动保存；在设备上粘完要不要写入启动配置，仍需单独决定。

3.3 配置内容说明

第二部分是完整配置，深色代码区按编号分段，每段前都有中文注释。不同厂商生成的段落数量和名称不同：

代码区下方按钮（见上图底部；逐项作用见下表，向导行为以 3.5 的文字说明为准）：

各厂商段落差异速查：

锐捷的 MAC 无感知认证与华为 / H3C 不同，它走的是 802.1X MAB（MAC Authentication Bypass）——设备把终端 MAC 当作用户名直接送 RADIUS 认证，命中已绑定的账户即免弹窗上线。前提：①「Portal管理 → 无感知认证设置」已启用；② 终端已在后台绑定过 MAC（接入账户或 MAC 白名单）；③ 终端首次仍需走一次 Web 认证成功。如果只需要 Portal 弹窗认证而不需要无感知，可以不配这一段。

3.4 配置落地位置

第三部分说明这段命令在不同设备上的落点：

• 交换机做网关：在 VLAN 接口或物理接口上启用认证，两者选其一；网关在交换机上时，窗口里建议填写「用户网关 IP」，以便一并放行网关。
• AC 无线：在 WLAN 模块（无线模板）上启用，不要在物理口上启用；AC 不是网关时「用户网关 IP」留空。
• 本项目采用二层 Portal 对接；只有在 Portal 服务器与终端跨三层时，才改为三层对接。
• 两侧端口要对配：设备把 Portal 报文送到服务器的 50100，服务器把回包发到设备的 2000。

3.5 应用到设备：登录、探测与分步下发

能力：华为 VRP、H3C Comware、锐捷 RGOS 均可直接下发。点「应用本步」逐条发送该步命令；点「保存到设备并关闭」写入启动配置（华为用 save，H3C 用 save force，锐捷用 write）。任何一步不成功都不会中止整个任务：命令被拒、超时或断连时，页面在命令框上方回显原因，任务与连接保留，可以修改命令后重新应用，也可以直接跳到下一步。「追加校验」中普通参数不支持只记该项失败，仍可继续校验其他项。已发送的命令不会自动撤销，需要时到设备控制台手工恢复。

登录前核对：HTTP 与 HTTPS 均可使用本向导；HTTP 下设备账户与密码会明文经过网络，风险等同 Telnet，建议仅在隔离管理网使用，并为后台启用 HTTPS。连接由运行平台的服务器发起，设备地址固定为当前 NAS 登记的 IPv4 地址，不可另填目的地址；管理地址不同、登记域名或 IPv6 时继续采用手工配置。

权限：「生成对接配置」（静态范例）的入口权限不变；「应用到设备」向导需要 NAS 修改权限或管理员权限，没有权限时按钮不显示。

一次点击登录：填好账户与密码后点「登录 / 开始」即完成建连与登录，不再要求先核对指纹。SSH 首次连接自动信任设备主机公钥，公钥只在服务端用于本次任务内的重连一致性校验，页面不展示、也没有可点的确认项；如需严格校验，请在登录成功后到设备控制台自行比对。

Telnet 会在管理网络明文传输账户、密码和命令，仅建议隔离管理网使用。SSH 失败不会自动改用 Telnet。遇到登录失败不要反复尝试，以免触发设备锁号。

操作步骤（先按顺序走一遍；改命令、连续应用、只读核对、失败后怎么处置这些细节在后面逐项说明）：

1. 在范例页点击「应用到设备」，填写设备账户与密码后点「登录 / 开始」（默认 Telnet，会先弹出明文风险确认），一次点击即直接登录。
2. 查看设备厂商、型号、版本和已发现的认证对象；未解析到对象不等于设备上不存在。华为设备这里会同时给出识别到的认证形态，它是按设备配置判定的，与范例页上选的档位无关。H3C 设备读取运行配置时，读到 wlan ap-group default-group 块结尾即停止读取（其后的 AP、射频、服务模板绑定段落与本向导无关，不再读取），执行记录里会留一行截断说明。
3. 选定一个探测到的接口或 WLAN 服务，不默认勾选，也不沿用范例接口。页面会在「范围」列提示管理接口、已有认证绑定、聚合口与无线共享范围的风险，这些目标都可选；确认后再继续，命令被拒或效果不符时到设备上手工 undo。
4. 没有合适的现有无线服务时，可以选择「仅准备认证对象，不绑定」：只新建认证对象，不改接口与 WLAN。
5. 按需选择独立对象名、取消 MAC 无感知分支，再点「生成计划」。同名对象、非缺省端口等情况只在页面上提示，不再阻断。若本次 Portal 密钥 / basip / 版本取的是「基础对接设置」（向导顶部红色提示条会写明「本次使用基础对接设置生成」并列出 BAS IP 与版本，计划生成时还会弹一次同标题的提醒框），请先核对 BAS 对接设置再往下走 —— 参数不对时下发出来的命令也是错的。计划生成后的提示行一定会写「对接设置来源」：显示「按 NAS IP 精确匹配」或「按 NAS 名称「…」匹配」表示本次用的是本设备专用记录，不弹提醒框属正常；只有显示「基础对接设置」或「未查到对接设置」才是兜底，需要先补录。
6. 在「URL 传参能力校准」中，建议对终端 IP 与终端 MAC 各点一次「追加校验」并确认，等结果返回；无论成功或失败都计为尝试。通过项自动加入预备集合，其他项按需追加，详见 3.6。不校验也能直接应用或跳过 URL 步骤。
7. 逐步查看前置关系与执行命令，按顺序点「应用本步」。「跳过」不是成功，缺少必需对象会让后续依赖无法就绪；但跳过后仍可继续下一步，失败或跳过都不会终止任务。
8. 某一步报错时先看命令框上方的错误原因，按原因在命令框里改好、点「保存命令」、再重新点「应用本步」；实在改不通就点「跳过本步」继续。
9. 需要落盘时，先点「继续只读核对」做保存前最后一次整机核对（它会按回读重判各步状态与 URL 传参依据），确认无误后再点「保存到设备并关闭」；也可点「停止 / 不保存并关闭」放弃。两者的确认框点「确定」后都会关闭整个向导窗口；即使那一刻服务端已断开也要能退出，关闭后任务由租约超时（15 秒阻断下发、30 秒清理连接）收尾。命令用错时到设备控制台手工恢复，锐捷 fmt 类是整行覆盖，要把原行原样写回。需要整体撤掉本次下发的全部配置时，点最下方的红色按钮「无条件回退配置（Undo All）」，见 3.5.1。

选中一个目标并点「检查冲突 / 生成计划」后，页面给出本次的目标回显与步骤列表。步骤数随厂商、认证形态和是否启用 MAC 分支而不同（华为新架构最多 12 步，H3C 与锐捷在 8 步上下），下面的说法统一用「各步骤」，实际以页面为准：

步骤标题上的「前置缺行」角标：步骤名后面可能带一个灰色小角标「前置缺行」，鼠标停上去会列出「缺 N 行：…」。它表示生成计划时这一步要下发的配置，在设备当前回读里还找不到 —— 只是提示，不拦人：

• 空设备首次生成计划时，几乎每一步都会带这个角标，属正常现象：设备上确实还没有，下发就是新增；
• 步骤应用成功、或回读确认设备上已经存在之后，角标会自动消失，不需要再点一次「继续只读核对」；
• 还没执行的步骤（待处理 / 部分应用 / 失败）会一直显示，用来提醒「这一步在设备上还缺东西」；
• 它不限制操作：带着角标也能点「应用本步」，真被设备拒绝时按命令框上方的错误原因处理。

应用与保存：一次只处理一个步骤，最终绑定单独确认。「应用本步」发送当前步骤的全部命令，任一条被拒绝就停在本步并回显原因，已发送的命令保留在运行配置里，平台不会自动撤销。保存写入整台设备的启动配置，可能包含其他管理员的未保存修改；保存成功后任务自动结束连接，页面弹出「保存成功」结论，点其中的按钮即关闭向导。不保存不等于撤销，运行配置可能已经生效。

命令框可编辑：右侧各步骤的命令框是文本框，可当场修改。改动后点「保存命令」只更新计划（不下发、不推进步骤），确认后再点「应用本步」按新命令执行；点「还原」丢弃未保存的修改、取回服务端当前命令。保存后该步骤标题会带「· 已编辑」标记。已应用、已复用或已跳过的步骤不能再编辑，需新建任务重新生成计划。

连续应用剩余步骤：不想一步步点时，点「连续应用剩余步骤」按计划顺序一次下发全部待处理步骤，失败即停；每完成一步就地刷新该步状态（不必等整批跑完），结束时只做一次整机回读，不再逐步回读。全部跑完（成功或中途停）都会弹一次结论，写明停在哪一步、下一步做什么。

只读核对（继续只读核对）：向导最下方的「继续只读核对」会重新读取一次设备的整台运行配置，并按这次读取的结果重判现场 —— 刷新计划基线、各步骤的状态、URL 传参表每一行的「依据」，以及无条件回退报告的现状复核。它不发任何配置、不保存、不下线，终端认证与计费无感知；但它只是让平台判定追上设备现场，不能代替人工验收。

四个必用时点：

两点要注意：

• 回读后设备上已经存在的步骤会显示「回读已存在」并退出「连续应用剩余步骤」的队列（与断线重连同一口径）；确需覆盖同名对象时，先编辑该步命令或重新探测再应用。
• 只读核对不会把已经通过的 URL 传参项打回未通过：状态仍是「通过，已加入」，设备关键字与最终 URL 都不会被清掉，只有「依据」的说明文字可能随最新配置变化。

失败之后能做什么：页面不会因为一步失败而结束任务，连接也保留。可选三条路：① 按错误原因改命令后重新应用；② 直接「跳过本步」进入下一步（跳过后该步仍算未成功，依赖它的后续步骤可能不生效）；③ 确认无法继续时点「停止 / 不保存并关闭」，确认即关闭向导。三种操作都不会自动重发、回滚或保存。

断开与超时：页面每 5 秒向服务端报到一次以保持任务有效；超过 15 秒没报到就阻断后续下发，后台每 30 秒检查并关闭已失效的连接。关闭页面、休眠或浏览器后台限流均可能导致失效，已发送的命令不能撤回。心跳与状态轮询不延长人工操作空闲时间：空闲 10 分钟或任务总时长 60 分钟断开，不自动保存、回滚或重启。结果未知时先核对记录，不盲目重发。服务端本身断开时，点「停止 / 不保存并关闭」或右上角关闭按钮仍会关闭向导窗口，只是提示「未能通知服务端停止」——服务端任务会在租约超时后自行断开设备连接。

3.5.1 无条件回退配置（Undo All）

向导最下面「停止 / 不保存并关闭」的右边还有一个红色按钮「无条件回退配置（Undo All）」。它不看设备现在有什么：只要本次生成过计划，就把计划里的全部步骤按反向顺序逐个撤掉（顺序同 3.2.1：先解绑 → 再删引用方 → 最后删被引用对象）。

什么时候点得动：只有「已生成计划 + 连接正常 + 当前没有别的请求在跑」时才可点；其余情况按钮是灰的，把鼠标停上去或点一下会说明原因（没有计划 / 连接中断 / 状态未同步 / 有操作进行中等），不会出现「点了没反应」。

确认框五条（点「确定」才开始，点取消一条命令都不发）：

1. 不看设备现有配置，按计划反向全部撤销；
2. 单条命令被设备拒绝不会中断，继续撤下一条；
3. 断线会立即中止，并写明「中断于第 N 模块（模块名）」；
4. 重连后再点一次即可继续，已经撤掉的模块会自动判为「无需撤销」，不会重复报错；
5. 结束时会追加一次整机只读回读（只用于展示与报告佐证，不发配置、不保存、不下线），全过程不自动保存。

执行时的几个口径：

• 每个模块开始前都会重新进入配置视图，避免上一个模块失败把提示符留在别的子视图里；
• 免认证规则按计划里的实际编号逐条撤销；本次只有探测结果、没有计划时，从登录时读到的那份运行配置里取 free-rule 行的编号；两者都拿不到就整段跳过，并在报告里写「无法确定编号」，不猜；
• 三条风险命令按固定口径处理：锐捷的关闭 AAA 新模型命令（no aaa new-model）与 H3C 的会话控制关闭命令（undo radius session-control enable）会连带影响设备上其它认证业务，只出提示、不真正下发，报告标「有风险已跳过」；华为的 undo radius-server authorization <服务器IP> 直接执行；
• 回退完成后，全部步骤回到待处理，每步说明改成「已执行无条件回退：本步配置可能已在设备上撤销，需要时重新应用」。计划仍然保留，不需要重新生成；下一次应用前平台会重新整机回读、对齐基线。

报告怎么读：执行记录下方出现「无条件回退报告（Undo All）」，分两层看：

• 「无需撤销」不是出错：设备上本来没有这个对象，撤销自然没意义，计入成功 —— 这也是断线后重连再点一次不会重复报错的原因。
• 「可能未撤销」才需要人工：多数是这个对象还被别的配置引用（例如认证域还在用这个 RADIUS 模板），按建议先撤引用方、再点一次即可。
• 报告只描述本次实际发送了什么、设备回了什么，不代表设备的最终状态；要让撤销长期生效，仍需在设备上另外保存。
• 断线中断的报告里没有整机回读结果（回读要等全部下发结束才做），重连后再点一次即可补齐。

回退后再核对一次（只读核对复核）：报告出来之后，再点一次「继续只读核对」，页面会按最新一次整机回读，逐个模块补一句「现在还在不在」。展开报告即可看到：

复核只补现状，不改执行结论：上方汇总行的「全部成功 / 局部成功」、每个模块的执行状态、中断位置都保持原样。想知道「这次发了什么、设备回了什么」看上方的报告，想知道「现在还在不在」看下面这条复核。点完复核不会重发任何命令、也不会自动保存。

全部成功时还会弹一次结论提示，文字与页内汇总行一致，点「确定」关闭；报告与提示都只描述本次发送了什么、设备回了什么。

3.6 URL 传参能力校准

计划生成后，URL 步骤初始只有 url http://<认证服务器地址> 等对象基础配置，不预置任何传参。在「URL 传参能力校准」表中逐项点「追加校验」，通过后自动加入「预备 URL 传参属性」，并组装成「最终 URL 传参结果」写入 URL 步骤。

状态与「依据」都随操作即时刷新；点「继续只读核对」会按最新一次整机回读把整张表重算一遍，已通过的项仍是「通过，已加入」，设备关键字与最终 URL 结果都不会变，只有「依据」的说明文字可能随设备现状改写（见 3.5）。

校准表上方还有一个「校验追加所有参数」按钮：点它按同一顺序一次跑完所有未通过项 —— 已通过的不重复下发、单项被设备拒绝不中断其余、断线立即停止；每项结束就地刷新该行的状态与依据，不必等整批跑完。表格下方「预备 URL 传参属性」与「最终 URL 传参结果」随通过项同步更新。

URL 步骤何时可应用：不要求先做校验。不尝试、只尝试一项、通过或失败，都可以直接应用或跳过（华为流程 5、H3C 第 4 步、锐捷第 3 步）。校验只决定「预备集合里有哪些参数」，不是按钮开关；仍须等当前操作结束且不能越序。

去重与最终结果：同一项通过后再次点击只复用结果，不重复下发、不重复加入；失败项可重试。最终结果始终按终端 IP、终端 MAC、BAS 地址、设备名、AP 的 MAC、AP 的 IP、SSID、终端 VLAN 的顺序组装，只包含本轮通过项。全部未通过时，URL 步骤仍只有地址等基础配置。URL 步骤应用或跳过后，本计划不能再追加；新任务重新开始。

其他项建议按 ① BAS 地址 → ② 设备名 → ③ AP 的 MAC → ④ AP 的 IP → ⑤ SSID → ⑥ 终端 VLAN 逐项尝试。普通参数不支持可继续下一项，不要求上一项成功；校验的通信中断或超时也只记在本项与执行记录里，不会停止任务。

认证后跳转地址（重定向地址）不在本次范围，校准表不会出现这一行。

BAS 地址不随终端变化，不代表终端身份信息。华为追加校验按 device-ip → ac-ip 依次尝试，只有明确拒绝才换下一种写法；接受但回读不匹配时停止本项。华为还会下发并核对配套的固定地址配置。

终端 VLAN 的候选写法：华为为 user-vlan；H3C 为 vlan（url-parameter vlan vlan，参数名与类型同名）；锐捷先试 user-vid，明确拒绝后再试 user-vlan。服务器侧固定按 vlan 接收，无需在后台另配，设备端参数名也统一写 vlan。

追加校验怎么操作：

1. 查看当前 URL 对象并保留原配置，尤其是华为多组参数行与锐捷整行配置；
2. 点该项「追加校验」，核对写入提示后确认；取消不会发命令；
3. 等待写入和回读结束，查看状态、执行记录及预备集合；失败时先看原因，普通不支持可继续其他项；
4. 核对最终结果与 URL 步骤中的命令，再按顺序应用；命令和实际设备语法不一致时，直接在命令框里改好、保存后再应用；
5. 只有需要写入启动配置时，才另点「保存到设备并关闭」。

校验会真实修改当前 URL 对象，不会另建临时对象，也不会自动保存或撤销。 即使某项失败，也可能已写入部分配置。需要恢复时按执行记录在设备侧手工处理；锐捷整行覆盖须写回原行，华为多组参数也须保留完整原文。试写会合并原有参数，但最终步骤只组装本轮通过项，不保证自动清除设备上所有旧参数或失败残留。

什么时候才能说「支持」：设备接受该参数只是中间结果。还要用一台测试终端走完整认证，再到平台侧确认这个参数真的带着值到达；两项都通过才算支持。只看到命令没报错、或只看到认证页能打开，都不能作为结论。

参数名对但值为空、值到了但 MAC 少了冒号或变大写，是两类不同的问题：前者是设备在该场景本来就不产出这个值（例如有线场景没有 SSID），后者是缺了 MAC 格式配套行（华为与锐捷各有一行，删掉会导致平台识别不到 MAC）。

边界：仅浏览表格不写设备，确认「追加校验」后才真实下发。校验通过只证明命令被接受且目标对象回读匹配，不代表终端已实收；终端实收核对不作为应用或保存的前置限制，追加校验失败也不阻断应用与跳过。

四、NAS 添加 / 修改

添加与修改使用同一个表单，页面标题分别为「Radius nas添加」「Radius nas修改」。

4.1 字段说明

4.2 操作步骤

1. 在 NAS 列表点「添加」。
2. 填写名称与 IP 地址。
3. 选择设备类型，填写与设备一致的密钥。
4. 填写 COA IP 与 CoA 端口（决定能否远程踢用户下线）。
5. 按需设置空闲时长、计费间隔、检测周期；不确定时填 0 表示不启用该项。
6. 按现场方案设置各扩展开关。
7. 点「保存」，回到列表确认新设备已出现。

4.3 注意事项

• 密钥不一致是最常见的失败原因：设备端与平台端必须逐字符一致，注意不要带入空格。
• 修改设备参数时，CoA 信息必须与设备实际配置一致，否则「下线」操作不会生效。
• 新增设备后，建议先让一台终端上线验证，再批量登记其他设备。

五、Radius 连接记录

记录每次 Radius 认证产生的上下线明细，用于计费核对与故障排查。

5.1 查询条件

「下线年月」是查询历史记录的关键条件。记录按月存放，跨月查询时务必同时指定年月与日期范围，否则可能查不到。

5.2 操作按钮

5.3 列表字段

5.4 典型用途

「终端厂商 / 终端型号」由系统根据终端上网时上报的信息自动识别累积。只对识别上线之后产生的记录有值，改造前的老记录会一直显示为空，属正常现象；要按厂商 / 型号回溯查历史，只能从识别上线之后的时间开始查。

六、Radius 在线列表

展示当前正在线的 Radius 用户，支持强制下线。

6.1 查询条件

NasName、帐号模糊、用户名、用户组、用户 IP、用户 IPv6、Mac 地址、终端厂商、终端型号、主机名、上线开始、上线结束。

6.2 操作按钮

「全部下线」与「全部清空」不同：前者真正通知设备断开用户，后者只清理平台记录。若只是记录残留，用「全部清空」；要让用户立即断网，用「全部下线」。

6.3 列表字段

序号、标识 ID、NAS 类型、NAS 名称、nasIP、nasIPv6、sourceIP、用户 IP、用户 IPv6、MAC 地址、登录名、用户组、可用时长、可用流量、下行流量、上行流量、使用流量、上线时间、在线时长、更新时间、客户端、终端型号、主机名、操作。

七、常见问题