锐捷交换机 VSF 堆叠实战配置指南

锐捷交换机堆叠（VSF）实战配置指南 | 附完整命令+踩坑总结

作为一名常年跟园区网打交道的网工，堆叠配置可以说是日常运维的基础操作了。最近在项目上部署了锐捷交换机堆叠，踩了几个小坑，索性整理一份完整的配置文档，分享给刚入门的小伙伴，避免大家走弯路。本文以锐捷两台交换机堆叠为例，附上完整可直接复用的命令，以及实战中的注意事项。

一、堆叠前置说明

1. 堆叠的核心价值

简单说，交换机堆叠（锐捷称之为VSF，虚拟交换框架）就是把多台物理交换机整合成一台"逻辑交换机"，核心优势有三个：

• 提升链路带宽：通过VSL链路（堆叠专用链路）实现设备间高速转发

• 提高冗余性：主交换机故障时，备交换机会无缝接管，业务不中断

• 简化管理：只需登录逻辑设备即可管理所有物理交换机，无需分别配置

2. 配置前必备准备

1. 设备要求：两台交换机型号统一（推荐同系列，如S5750-E、S6000-C），固件版本一致（版本不一致可能导致堆叠失败，可提前通过upgrade升级）

2. 端口准备：预留专用端口作为VSL链路（本文使用40G端口FortyGigabitEthernet 1/0/53/54，也可使用10G端口，避免用业务端口）

3. 配置备份：两台交换机均提前通过wr保存原有配置，避免后续操作丢失关键配置

4. 物理连接：配置前先将两台交换机的VSL端口用高速光模块（或铜缆）直连，确保链路通畅

二、分步配置（主备模式，2台设备）

本次配置堆叠域ID为1，交换机1（优先级200，主设备）、交换机2（优先级100，备设备），步骤清晰，跟着敲命令即可。

步骤1：主交换机（Ruijie_1）配置

# 1. 进入全局配置模式
Ruijie>enable
Ruijie#configure terminal
Ruijie(config)#

# 2. 创建堆叠域，指定域ID为1（域ID范围1-4095，同一网络内堆叠域ID不可重复）
Ruijie(config)#switch virtual domain 1
Ruijie(config-vs-domain)#

# 3. 指定当前设备为堆叠内的交换机1
Ruijie(config-vs-domain)#switch 1

# 4. 设置优先级为200（优先级范围1-255，数值越高，成为主设备的优先级越高，默认100）
Ruijie(config-vs-domain)#switch 1 priority 200    # 优先级高的为主设备，确保主备角色稳定

# 5. 给交换机1添加描述信息，方便后续管理识别
Ruijie(config-vs-domain)#switch 1 description Sw1

# 6. 配置VSL端口（堆叠专用链路，绑定预留的40G端口）
Ruijie(config-vs-domain)#exit
Ruijie(config)#vsl-port
Ruijie(config-vsl-port)#port-member interface FortyGigabitEthernet 1/0/53
Ruijie(config-vsl-port)#port-member interface FortyGigabitEthernet 1/0/54

# 7. 关键步骤：保存配置（必须先保存，再转换堆叠模式，否则配置丢失）
Ruijie(config-vsl-port)#exit
Ruijie(config)#exit
Ruijie#wr    # 执行后会提示保存成功，确认即可

# 8. 转换为虚拟堆叠模式，设备会自动重启（重启过程中不要断电，耐心等待5-10分钟）
Ruijie#switch convert mode virtual

步骤2：备交换机（Ruijie_2）配置

备交换机配置有一个关键坑，先划重点：不能先配置优先级，必须先修改switch ID为2，否则会报错！ 下面是完整配置：

# 1. 进入全局配置模式
Ruijie>enable
Ruijie#configure terminal
Ruijie(config)#

# 2. 创建与主交换机相同的堆叠域ID（必须一致，否则无法加入同一堆叠）
Ruijie(config)#switch virtual domain 1
Ruijie(config-vs-domain)#

# 3. 先修改当前设备的switch ID为2（默认switch ID是1，两台设备ID不能重复）
Ruijie(config-vs-domain)#switch 2

# 4. 再设置优先级为100（备设备优先级低于主设备，无需太高，默认100也可，手动配置更清晰）
Ruijie(config-vs-domain)#switch 2 priority 100
# 补充：如果先配优先级，会出现如下报错，这是我踩过的坑：
# % Failed to configure device priority for the reason current configured switch is 1.

# 5. 给交换机2添加描述信息，方便管理识别
Ruijie(config-vs-domain)#switch 2 description Sw2

# 6. 配置VSL端口，与主交换机保持一致，绑定相同规格的40G端口
Ruijie(config-vs-domain)#exit
Ruijie(config)#vsl-port
Ruijie(config-vsl-port)#port-member interface FortyGigabitEthernet 1/0/53
Ruijie(config-vsl-port)#port-member interface FortyGigabitEthernet 1/0/54

# 7. 关键步骤：保存配置（同样必须先保存，再转换模式）
Ruijie(config-vsl-port)#exit
Ruijie(config)#exit
Ruijie#wr

# 8. 转换为虚拟堆叠模式，设备自动重启（重启后会自动加入主交换机的堆叠域）
Ruijie#switch convert mode virtual

补充：两台设备重启后的验证

两台设备都重启完成后，任意登录一台交换机（推荐登录原主交换机），先通过enable进入特权模式，后续可进行堆叠优化和状态检查。

三、堆叠优化配置（双活检测，二选一）

堆叠配置完成后，建议开启双活检测，避免主备交换机之间VSL链路故障时，出现两台设备同时作为主设备工作的"双活"问题，导致网络广播风暴。这里提供两种方案，任选其一即可，本文重点演示BFD双活检测（配置更简洁，适用性广）。

方案1：BFD双活检测（推荐）

# 1. 进入全局配置模式
Ruijie>enable
Ruijie#configure terminal
Ruijie(config)#

# 2. 进入堆叠域配置模式
Ruijie(config)#switch virtual domain 1
Ruijie(config-vs-domain)#

# 3. 启用BFD双活检测功能
Ruijie(config-vs-domain)#dual-active detection bfd

# 4. 绑定BFD检测端口（推荐使用10G业务端口，本文使用TenGigabitEthernet 1/0/48，需两台设备该端口直连）
Ruijie(config-vs-domain)#dual-active bfd interface TenGigabitEthernet 1/0/48

# 5. 启用双活自动恢复功能（故障恢复后，备设备自动恢复为备用状态，无需手动干预）
Ruijie(config-vs-domain)#dual-active auto-recovery enable

# 6. 保存优化配置
Ruijie(config-vs-domain)#exit
Ruijie(config)#exit
Ruijie#wr

方案2：聚合端口双活检测（备选）

如果没有多余的10G端口，可使用聚合端口（Eth-Trunk）进行双活检测，核心命令如下（仅作参考，需提前配置聚合端口）：

Ruijie(config)#switch virtual domain 1
Ruijie(config-vs-domain)#dual-active detection link-aggregation
Ruijie(config-vs-domain)#dual-active auto-recovery enable
Ruijie(config-vs-domain)#exit
Ruijie#wr

四、堆叠状态检查与主备切换

配置完成后，需要验证堆叠是否正常运行，以及掌握手动主备切换的命令，方便后续运维排障。

1. 常用堆叠状态检查命令

# 1. 查看堆叠整体配置信息（域ID、交换机ID、优先级、描述等）
Ruijie#show switch virtual config

# 2. 查看堆叠内设备的角色（主/备，确认主备角色是否符合预期）
Ruijie#show switch virtual role

# 3. 查看堆叠VSL链路状态（确认VSL端口是否UP，链路是否通畅）
Ruijie#show switch virtual link

# 4. 查看堆叠整体运行状态（最全面的命令，包含设备状态、VSL状态、双活检测状态等）
Ruijie#show switch virtual

2. 手动主备切换（应急使用）

如果需要进行主交换机升级、维护等操作，可手动触发主备切换，备交换机会无缝接管业务，核心命令：

# 进入全局配置模式，执行强制切换命令
Ruijie>enable
Ruijie#configure terminal
Ruijie(config)#redundancy forceswitch

# 切换完成后，通过show switch virtual role验证角色是否切换成功

五、实战踩坑总结（重点！）

1. 备交换机必须先改switch ID再配优先级，否则会报错Failed to configure device priority，这是最容易踩的坑，一定要记牢

2. 转换堆叠模式前，必须先执行 wr 保存配置，否则设备重启后所有配置会丢失，需要重新配置

3. VSL端口必须使用高速端口（10G/40G），且不能配置任何业务VLAN、IP等信息，仅作为堆叠专用链路

4. 两台交换机的固件版本必须一致，版本不一致会导致堆叠协商失败，重启后无法形成逻辑设备

5. 双活检测端口必须两台设备直连，且不能配置业务流量，避免检测链路被业务流量占用，影响检测精度

6. 堆叠形成后，所有配置都在"逻辑交换机"上进行，单独登录备设备无法修改配置，需通过主设备统一管理