internap/fake-switches

Fake-switches

镜像概述和主要用途

Fake-switches 是一个可插拔的交换机/路由器命令行模拟器，旨在无需实验室设备即可对网络设备进行集成测试。它帮助测试与设备的通信及其所有层级，以实现更健壮的高层测试。由于主要供其他系统而非人类使用，对不完整命令的错误处理和防故障设计已大部分省略，仅显示相关错误。

该库可轻松扩展，以响应模拟交换机配置的变化并控制实际工具集，使环境表现得像由交换机驱动的真实环境。例如，可挂钩到 VLAN 创建过程并使用 vconfig 在机器上创建实际 VLAN 以进行网络测试。

注意：此库不受任何厂商支持，是通过***网络设备构建的。

核心功能和特性

• 多厂商模型支持：支持 Cisco、Brocade、Juniper、Dell 等多种厂商的交换机/路由器模型
• 多协议支持：包括 SSH、Telnet、Netconf over SSH 等协议
• 可扩展性：可通过扩展 SwitchConfiguration 类实现自定义功能，响应配置变化
• 轻量级模拟：无需真实设备即可模拟网络设备命令行交互
• 灵活配置：支持通过环境变量或命令行参数自定义交换机参数

支持的命令

命令支持是根据测试需求添加的。有关可用命令及其支持行为，请参见各模型的测试部分：

使用场景和适用范围

• 网络设备集成测试环境搭建
• 网络管理工具开发中的功能验证
• 自动化测试流程中模拟网络设备交互
• 网络配置脚本的正确性验证
• 网络运维人员的命令行操作练习（非生产环境）

使用方法和配置说明

使用 Docker 运行

基本运行

shell
$ docker run -P -d internap/fake-switches
$ docker ps
CONTAINER ID        IMAGE                             COMMAND                  CREATED             STATUS              PORTS                     NAMES
6eec86849561        internap/fake-switches            "/bin/sh -c 'fake-swi"   35 seconds ago      Up 13 seconds       0.0.0.0:32776->22/tcp     boring_thompson

连接到模拟交换机

shell
$ ssh 127.0.0.1 -p 32776 -l root
root@127.0.0.1's password:  # 输入密码 root
my_switch>enable
Password:  # 按 <回车>
my_switch#show run
Building configuration...

Current configuration : 164 bytes
version 12.1
!
hostname my_switch
!
!
vlan 1
!
interface FastEthernet0/1
!
interface FastEthernet0/2
!
interface FastEthernet0/3
!
interface FastEthernet0/4
!
end

my_switch#

使用自定义参数启动

shell
$ docker run -P -d -e SWITCH_MODEL="another_model" internap/fake-switches

支持的参数

从源码构建镜像

shell
$ docker build -t fake-switches .
$ docker run -P -d fake-switches

扩展功能

可扩展 SwitchConfiguration 类并提供带有自定义类的对象工厂，以响应资源变化。例如：

python
from twisted.internet import reactor
from fake_switches.switch_configuration import SwitchConfiguration, Port
from fake_switches.transports.ssh_service import SwitchSshService
from fake_switches.cisco.cisco_core import CiscoSwitchCore

class MySwitchConfiguration(SwitchConfiguration):
    def __init__(self, *args, **kwargs):
        super(MySwitchConfiguration, self).__init__(objects_overrides={"Port": MyPort}, *args, **kwargs)

class MyPort(Port):
    def __init__(self, name):
        self._access_vlan = None
        super(MyPort, self).__init__(name)

    @property
    def access_vlan(self):
        return self._access_vlan

    @access_vlan.setter
    def access_vlan(self, value):
        if self._access_vlan != value:
            self._access_vlan = value
            print "This could add vlan to eth0"  # 可在此处添加实际VLAN创建逻辑

if __name__ == '__main__':
    ssh_service = SwitchSshService(
        ip="127.0.0.1",
        ssh_port=11001,
        switch_core=CiscoSwitchCore(MySwitchConfiguration("127.0.0.1", "my_switch", ports=[MyPort("FastEthernet0/1")])))
    ssh_service.hook_to_reactor(reactor)
    reactor.run()

连接到交换机并执行以下命令时，程序将输出 "This could add vlan to eth0"：

ssh root@127.0.0.1 -p 11001
password : root
> enable
password:
# configure terminal
# vlan 1000
# interface FastEthernet0/1
# switchport access vlan 1000

从命令行启动交换机

安装并运行

shell
pip install fake-switches
fake-switches

# 在另一个终端中执行：
ssh root@127.0.0.1 -p 22222

命令行帮助

使用 --help 标志查看帮助信息：

shell
fake-switches --help
usage: fake-switches [-h] [--model MODEL] [--hostname HOSTNAME]
                     [--username USERNAME] [--password PASSWORD]
                     [--listen-host LISTEN_HOST] [--listen-port LISTEN_PORT]

Fake-switch simulator launcher

optional arguments:
  -h, --help            show this help message and exit
  --model MODEL         Switch model, allowed values are
                        juniper_qfx_copper_generic, cisco_2960_24TT_L,
                        dell_generic, dell10g_generic, juniper_generic,
                        cisco_2960_48TT_L, cisco_generic, brocade_generic
                        (default: cisco_generic)
  --hostname HOSTNAME   Switch hostname (default: switch)
  --username USERNAME   Switch username (default: root)
  --password PASSWORD   Switch password (default: root)
  --listen-host LISTEN_HOST
                        Listen host (default: 0.0.0.0)
  --listen-port LISTEN_PORT
                        Listen port (default: 2222)

可用的交换机模型

目前可用的交换机模型包括：

• brocade_generic
• cisco_generic
• cisco_2960_24TT_L
• cisco_2960_48TT_L
• dell_generic
• dell10g_generic
• juniper_generic
• juniper_qfx_copper_generic

说明：通用模型（generic）主要用于测试，通常端口数量少于特定型号，但行为一致。一旦核心功能可用，可轻松添加更多特定型号。欢迎提交拉取请求！

贡献

欢迎提出问题和提交拉取请求，我们将乐意查看！