适用场景:园区网接入层改造,华为 S5720 与 H3C S5120V2 交换机批量开启 802.1X 认证 + MAC 旁路(MAB),实现办公终端 Portal/802.1X 认证、打印机摄像头等 IoT 设备无感知入网。

适用规模:约 200 台接入层交换机。


一、前置准备

1.1 收集现网信息

信息项 说明 填写
深澜 RADIUS IP 认证服务器地址 ____________
RADIUS 认证端口 默认 1812 ____________
RADIUS 计费端口 默认 1813 ____________
RADIUS 共享密钥 Shared Secret ____________
办公网 VLAN ID 例如 VLAN 10 ____________
IoT 网 VLAN ID 如规划独立网段,例如 VLAN 20 ____________
打印机/摄像头 MAC 需要录入深澜 MAB 白名单 见后续清单

1.2 确认设备清单

  • 华为 S5720:共计 ____ 台
  • H3C S5120V2:共计 ____ 台
  • 记录每台交换机的管理 IP、登录账号、密码/密钥

1.3 Termius 版本要求

  • 建议使用 Termius 桌面版(Windows/macOS/Linux),支持 Snippets、Host Groups、SFTP。
  • 手机版可用于应急查看,但不建议用于批量推送。

二、Termius 基础配置

2.1 导入交换机清单

  1. 打开 Termius → Hosts → 右上角 「+」New Host
  2. 依次录入交换机信息:
    • Label:便于识别,如 A栋-3层-S5720-01
    • Address:交换机管理 IP
    • Usernameadmin 或你的运维账号
    • Password / Private Key:选择对应认证方式
  3. 建议按楼栋/楼层/品牌创建 Group(分组)
    • Test-Huawei(试点华为设备)
    • Test-H3C(试点 H3C 设备)
    • Prod-Huawei-A栋
    • Prod-H3C-B栋

2.2 配置身份(Identity)复用

如果多台交换机使用同一套账号密码:

  1. Termius → Identities → New Identity
  2. 填入用户名、密码(或上传私钥)
  3. 在 Host 设置中选择该 Identity,避免重复输入

三、创建 Snippets(代码片段)

路径:Termius → SnippetsNew Snippet

Snippets 是批量推送的核心,建议按功能创建,不要在一个 Snippet 里塞太多命令。

3.1 Snippet 1:配置备份(必做!)

名称backup-config

华为 S5720

display current-configuration | save backup.cfg

H3C S5120V2

save force

操作:推送正式配置前,先对所有目标交换机执行此 Snippet。


3.2 Snippet 2:华为 S5720 — 单端口开启 802.1X + MAB

名称huawei-port-dot1x-mab

system-view
interface GigabitEthernet0/0/{{PORT}}
 port link-type access
 port default vlan {{VLAN}}
 dot1x enable
 dot1x mac-bypass
 dot1x authentication-method eap
 authentication critical-event action authorize vlan {{VLAN}}
return
save

变量说明

  • {{PORT}}:端口号,如 123
  • {{VLAN}}:接入 VLAN ID,如 10

Termius Snippet 暂不支持自动变量替换(部分版本支持),实际操作时建议:

  • 先复制 Snippet 到文本编辑器
  • 批量替换 {{PORT}}{{VLAN}}
  • 再粘贴到 Termius 的多标签页中执行

3.3 Snippet 3:华为 S5720 — 批量端口开启(range 方式)

名称huawei-batch-dot1x

system-view
interface range GigabitEthernet0/0/1 to GigabitEthernet0/0/24
 port link-type access
 port default vlan {{VLAN}}
 dot1x enable
 dot1x mac-bypass
 dot1x authentication-method eap
 authentication critical-event action authorize vlan {{VLAN}}
quit
return
save

注意interface range 语法在 VRP 中部分版本支持。如果不支持,请使用单端口循环或 Python 脚本生成命令。


3.4 Snippet 4:华为 S5720 — RADIUS 服务器配置

名称huawei-radius-config

system-view
radius-server template ShenLan
 radius-server authentication {{RADIUS_IP}} {{AUTH_PORT}}
 radius-server accounting {{RADIUS_IP}} {{ACCT_PORT}}
 radius-server shared-key cipher {{SECRET}}
quit
aaa
 authentication-scheme dot1x
  authentication-mode radius
 accounting-scheme dot1x
  accounting-mode radius
 domain default
  authentication-scheme dot1x
  accounting-scheme dot1x
  radius-server ShenLan
quit
return
save

3.5 Snippet 5:H3C S5120V2 — 全局 802.1X + MAB 配置

名称h3c-global-dot1x

system-view
radius scheme shenlan
 primary authentication {{RADIUS_IP}} {{AUTH_PORT}}
 primary accounting {{RADIUS_IP}} {{ACCT_PORT}}
 key authentication cipher {{SECRET}}
 key accounting cipher {{SECRET}}
 user-name-format without-domain
quit
domain default
 authentication lan-access radius-scheme shenlan
 accounting lan-access radius-scheme shenlan
quit
dot1x
mac-authentication
return
save

3.6 Snippet 6:H3C S5120V2 — 单端口开启 802.1X + MAB

名称h3c-port-dot1x-mab

system-view
interface GigabitEthernet1/0/{{PORT}}
 port link-type access
 port access vlan {{VLAN}}
 dot1x
 dot1x mandatory-domain default
 mac-authentication
 authentication priority dot1x mac-auth
 authentication mode multi-auth
 authentication critical vlan {{VLAN}}
quit
return
save

3.7 Snippet 7:紧急回退 — 关闭 802.1X(华为)

名称huawei-undo-dot1x

system-view
interface GigabitEthernet0/0/{{PORT}}
 undo dot1x enable
 undo dot1x mac-bypass
quit
return
save

3.8 Snippet 8:紧急回退 — 关闭 802.1X(H3C)

名称h3c-undo-dot1x

system-view
interface GigabitEthernet1/0/{{PORT}}
 undo dot1x
 undo mac-authentication
quit
return
save

四、批量操作流程

Phase 1:试点验证(1-2 天)

  1. 选设备

    • 华为 S5720:选 2 台(一台接打印机,一台接办公电脑)
    • H3C S5120V2:选 2-3 台(同理)
  2. 备份配置

    • Termius 中选中试点交换机 → 右键 → Connect
    • 打开多个标签页
    • 运行 Snippet backup-config
  3. 配置 RADIUS(全局只需一次)

    • 试点交换机运行 huawei-radius-configh3c-global-dot1x
  4. 开启单端口测试

    • 选一个已知接打印机的端口(如 G0/0/10)
    • 运行单端口 Snippet,替换 {{PORT}}{{VLAN}}
    • 观察打印机是否能获取 IP、正常打印
    • 拔掉打印机,插办公电脑,测试 802.1X 认证流程
  5. 深澜后台核对

    • 登录深澜管理后台 → RADIUS 日志 / 在线用户
    • 确认能看到打印机的 MAC 认证记录
    • 确认办公电脑的 802.1X 认证记录

Phase 2:小批量推广(3-5 天)

  1. 按分组推送

    • 每次选择一个 Termius Group(如 Prod-Huawei-A栋-3层
    • 同时打开该组内所有交换机的 SSH 会话(Termius 支持 Group 批量连接)
  2. 执行顺序

    ① 备份配置(backup-config)
    ② 配置 RADIUS(如未配过)
    ③ 开启目标端口 802.1X + MAB
    ④ 抽查 2-3 个端口下的终端是否正常
    
  3. 观察指标

    • 是否有终端无法入网
    • 深澜 RADIUS 是否有大量 Reject 日志
    • 交换机 CPU/内存是否异常(display cpu-usagedisplay memory

Phase 3:全网推广(1-2 周)

  1. 按楼栋/楼层逐批推送,避免一次性全量变更导致故障面广。
  2. 夜间操作:建议在下班后进行,减少对用户的影响。
  3. 保留值班通道:至少保留一个未改造的网络区域或紧急 SSID,用于故障时临时接入。

五、验证清单

每完成一批交换机配置,按以下清单检查:

检查项 命令(华为) 命令(H3C) 预期结果
802.1X 是否开启 display dot1x interface GigabitEthernet0/0/X display dot1x interface GigabitEthernet1/0/X Status: Enabled
MAB 是否开启 display dot1x interface GigabitEthernet0/0/X display mac-authentication interface GigabitEthernet1/0/X MAC Bypass: Enabled / MAC-auth: Enabled
端口认证状态 display dot1x sessions display connection 能看到终端的 MAC 和认证状态
RADIUS 连通性 test-aaa user password radius-template ShenLan test-aaa user password radius-scheme shenlan Success
打印机是否正常 实际打印测试页 实际打印测试页 能正常打印
深澜日志 登录深澜后台查看 登录深澜后台查看 有该设备的 Accept 记录

六、应急与回退

6.1 单端口故障回退

如果某个端口下的终端无法入网:

  1. Termius 连接该交换机
  2. 运行对应品牌的 undo-dot1x Snippet
  3. 替换 {{PORT}} 为故障端口号
  4. 终端应立即恢复网络

6.2 RADIUS 服务器宕机逃生

如果深澜 RADIUS 服务不可用,交换机端口应保持放行(已通过 authentication critical-eventauthentication critical vlan 配置)。

手动验证逃生是否生效

  • 临时阻断交换机到 RADIUS 的 1812/1813 端口(如在防火墙上 drop)
  • 新终端接入测试端口
  • 观察是否能在超时后自动放行

6.3 批量回退脚本(极端情况)

如果大面积故障,需要快速关闭所有端口的 802.1X:

华为批量回退

system-view
interface range GigabitEthernet0/0/1 to GigabitEthernet0/0/24
 undo dot1x enable
 undo dot1x mac-bypass
quit
return
save

H3C 批量回退

system-view
interface range GigabitEthernet1/0/1 to GigabitEthernet1/0/24
 undo dot1x
 undo mac-authentication
quit
return
save

在 Termius 中选中所有故障交换机标签页 → 粘贴上述命令 → 批量执行。


七、深澜后台配合事项

7.1 开启 RADIUS 服务

  1. 登录深澜管理后台
  2. 进入 「系统管理」→「RADIUS 服务」(路径可能因版本不同)
  3. 确认认证端口(1812)、计费端口(1813)已监听
  4. 记录共享密钥

7.2 录入 MAB 白名单

对于打印机、摄像头等 IoT 设备:

  1. 「用户管理」→「批量导入」

  2. 准备 CSV 文件:

    用户名,密码,认证类型,绑定VLAN,描述
    aabbccddeeff,aabbccddeeff,MAB,20,3层打印机
    112233445566,112233445566,MAB,20,4层摄像头01
    
  3. 导入后逐条核对

  4. 确认用户名格式与交换机发送的一致(华为/H3C 通常为无冒号的 aabbccddeeff

7.3 配置 802.1X 用户

为办公人员创建账号,或对接 AD/LDAP:

  • 建议统一使用 学工号/工号 作为用户名
  • 设置合理的密码策略和账号有效期
  • 可配置「同时在线数限制」(如每人最多 3 台设备)

八、常见问题排查

Q1:打印机插入后无法获取 IP

排查步骤

  1. 交换机执行 display dot1x interface G0/0/X(华为)或 display mac-authentication interface G1/0/X(H3C)
  2. 确认端口状态为 AuthenticatedMAC-authenticated
  3. 如果是 Unauthenticated,检查深澜 RADIUS 日志:
    • 是否收到该 MAC 的认证请求?
    • 返回的是 Accept 还是 Reject?
  4. 如果深澜没收到请求,检查交换机 RADIUS 配置(IP、端口、密钥是否正确)

Q2:办公电脑插上网线后很久才能上网

原因:802.1X 超时等待时间较长。

优化

# 华为
system-view
dot1x timer tx-period 10
dot1x retry 2

# H3C
system-view
dot1x timer tx-period 10
dot1x retry 2

Q3:Windows 电脑无法弹出 802.1X 认证窗口

解决

  1. 确保 Windows 服务 Wired AutoConfig 已启动
  2. 网卡属性 → 身份验证 → 勾选 IEEE 802.1X 身份验证
  3. 选择正确的 EAP 类型(通常为企业版 PEAP-MSCHAPv2)

Q4:深澜收到 MAC 认证请求但用户名格式不对

现象:深澜日志中用户名带域名,如 aabbccddeeff@default

解决:在 H3C 的 RADIUS scheme 中配置:

user-name-format without-domain

华为 VRP 默认不带域名,一般无需额外配置。

Q5:如何快速收集所有打印机的 MAC 地址?

方法 A(交换机 LLDP)

# 华为/H3C 通用
lldp enable
# 等待 1-2 分钟后
display lldp neighbor brief

部分打印机会在 LLDP 信息中显示设备类型。

方法 B(DHCP 服务器)
登录 DHCP 服务器,导出地址租约表,筛选打印机厂商的 OUI(如前 6 位 MAC)。

方法 C(打印机面板)
在打印机设置菜单中查看网络信息页,记录 MAC。


九、附录:命令速查表

华为 S5720 常用命令

功能 命令
查看 802.1X 配置 display dot1x
查看端口认证会话 display dot1x sessions
查看 MAC 旁路状态 display dot1x interface GigabitEthernet0/0/X
查看 RADIUS 统计 display radius statistics
测试 RADIUS 认证 test-aaa user password radius-template ShenLan
查看 CPU/内存 display cpu-usagedisplay memory-usage

H3C S5120V2 常用命令

功能 命令
查看 802.1X 配置 display dot1x
查看 MAC 认证配置 display mac-authentication
查看端口认证状态 display connection
查看 RADIUS 统计 display radius statistics
测试 RADIUS 认证 test-aaa user password radius-scheme shenlan
查看 CPU/内存 display cpu-usagedisplay memory

十、操作时间建议

阶段 建议时间 备注
试点测试 工作日白天 便于随时观察、及时调整
小批量推广 下班后 18:00-21:00 影响面小,有问题可及时回退
全网推广 周末或节假日 200 台建议分 2-3 次完成
配置备份 每次推送前必做 Snippet backup-config

最后提醒

  • 200 台交换机不要一次性全改,分批次、分区域进行。
  • 每次变更前务必备份配置。
  • 保留至少一个未改造的应急网络通道。
  • 遇到不明问题先回退,再排查,不要在线上反复试错。
Logo

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目,面向数字基础设施四大核心场景(服务器、云计算、边缘计算、嵌入式),全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐