{"id":19567578,"url":"https://github.com/jjm2473/virtual-network-laboratory","last_synced_at":"2026-07-31T05:30:23.257Z","repository":{"id":41287091,"uuid":"202893764","full_name":"jjm2473/virtual-network-laboratory","owner":"jjm2473","description":"Virtual Network Laboratory based on linux network namespace (基于Linux网络命名空间的虚拟网络实验室)","archived":false,"fork":false,"pushed_at":"2024-10-03T18:48:06.000Z","size":38,"stargazers_count":11,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-09T01:07:12.107Z","etag":null,"topics":["linux-network-namespace","network-namespace","network-virtualization","networking","virtualization"],"latest_commit_sha":null,"homepage":"https://jjm2473.github.io/virtual-network-laboratory/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jjm2473.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-17T14:54:12.000Z","updated_at":"2025-01-02T06:02:19.000Z","dependencies_parsed_at":"2024-11-11T05:40:14.092Z","dependency_job_id":"5d730e48-ab3c-4162-8ec0-f75f040db7fa","html_url":"https://github.com/jjm2473/virtual-network-laboratory","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjm2473%2Fvirtual-network-laboratory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjm2473%2Fvirtual-network-laboratory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjm2473%2Fvirtual-network-laboratory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jjm2473%2Fvirtual-network-laboratory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jjm2473","download_url":"https://codeload.github.com/jjm2473/virtual-network-laboratory/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240831380,"owners_count":19864718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux-network-namespace","network-namespace","network-virtualization","networking","virtualization"],"created_at":"2024-11-11T05:40:00.944Z","updated_at":"2026-07-31T05:30:23.063Z","avatar_url":"https://github.com/jjm2473.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Virtual Network Laboratory\n\n\u003e **基于Linux网络命名空间的虚拟网络实验室**\n\n这个项目包含一个[图形编辑器](https://jjm2473.github.io/virtual-network-laboratory/), 以及教程, 案例;\n图形编辑器可编译出一个Shell脚本, 这个脚本可以创建或者销毁虚拟网络. \n项目已经用JavaScript重写, 可直接[在线编辑编译](https://jjm2473.github.io/virtual-network-laboratory/), 不需要再用到Java环境.\n\n### 常规工作流\n1. 首先根据需求在[图形编辑器](https://jjm2473.github.io/virtual-network-laboratory/)拖出相应的网络架构;\n2. 在菜单栏点编译, 生成Shell脚本, 编译结果下载到本地并增加执行权限`chmod 755 network.sh`; \n3. (之后的操作都在Linux下) 创建虚拟网络:\n    ```shell script\n    sudo ./network.sh create\n    ```\n4. 创建虚拟网络之后, 即可进入各个Host(即命名空间)进行网络实验, \n    为了方便进入不同Host, 提供了脚本 [scripts/netenter](scripts/netenter),\n    假设要进入`pc1`, 执行:\n    ```shell script\n    ./scripts/netenter pc1\n    ```\n    `netenter`还能直接在指定的Host执行指定的命令, 例如在`pc1`执行`ping 8.8.8.8`:\n    ```shell script\n    ./scripts/netenter pc1 ping 8.8.8.8\n    ```\n5. 销毁虚拟网络(或者直接重启机器):\n    ```shell script\n    sudo ./network.sh destory\n    ```\n\n### 图形编辑器\n\n图形编辑器中有三种角色, 分别是:\n\n1. 主机(hosts)\n   \u003e 主机对应Linux中一个网络命名空间, 主机同时也可能是路由器, 看你怎么配置.\n     主机有两个属性: \n   1. 名称: 主机的名称, 即命名空间的名称, 不可重复\n   2. 网关: 默认网关, 可以不指定 \n2. 交换机(switches)\n   \u003e 交换机对应一个虚拟bridge设备, 交换机只有一个属性:\n   1. 名称: 交换机的名称, 不可重复\n3. 链路(links)\n   \u003e 主机和交换机有多个网口, 不同主机或交换机的两个网口连接形成链路.\n    每条链路有两个网口, 每个网口有三个属性:\n   1. 名称: 此端口在节点中的接口名称, 可以不指定\n   2. IPv4: 配置此端口的ipv4地址, 可以不指定\n\n需要注意的是所有交换机都在宿主机的根命名空间里, 所以交换机的名称不能重复.\n\n图形编辑器中可导出[蓝图](#蓝图), 蓝图即网络架构信息, 不包含图形相关信息.\n\n### 蓝图\n[蓝图示例](docs/example.json)\n\n蓝图中有三种角色, 分别是:\n\n1. 主机(hosts)\n   \u003e 主机对应Linux中一个网络命名空间, 主机同时也可能是路由器, 看你怎么配置.\n     主机有两个属性: \n   1. name: 主机的名称, 即命名空间的名称, 不可重复\n   2. gateway: 默认网关, 可不指定 \n2. 交换机(switches)\n   \u003e 交换机对应一个虚拟bridge设备, 交换机只有一个属性:\n   1. name: 交换机的名称, 不可重复\n3. 链路(links)\n   \u003e 链路对应一对veth设备, 相当于网线, 用于连接主机或者交换机.\n    链路有两个成员, 分别是from 和 to, 代表连接的两个节点, 不分先后,\n    from 和 to各有三个属性:\n   1. peer: 主机或者交换机节点的名称\n   2. if: 此端口在节点中的接口名称, 可以不指定, 建议交换机节点别配置, 以免重名\n   3. ipv4: 配置此端口的ipv4地址, 可以不指定, 连接到交换机的端口忽略此参数\n\n需要注意的是交换机和连接到交换机的端口都在宿主机的根命名空间里, 所以交换机的名称不能重复, \n连接到所有交换机的所有端口的接口名称也不能重复.\n\n蓝图可单独[在线编译](https://jjm2473.github.io/virtual-network-laboratory/compile.html)成Shell脚本.\n\n### 案例\n要实现的网络拓扑:\n```text\n            宿主机\n              |\n            路由器(router1)\n            /   \\\n      交换机1     交换机2\n       /   \\     /   \\\n     pc1  pc2  pc3   pc4\n```\n~ ___宿主机___ 即当前运行Linux的机器, 图形编辑器和蓝图中用`root`表示;\n\n~ ___路由器___ 并非现代意义上的路由器, 而是一台普通的主机, 跟 ___交换机1___ 和 ___交换机2___ 合在一起更像是现代的路由器; \n\n此网络拓扑对应的项目文件是 [docs/example.prj.json](docs/example.prj.json).\n\n最终要实现的是pc之间互通, pc可以连接外网.\n\n打开[图形编辑器](https://jjm2473.github.io/virtual-network-laboratory/), 在图形编辑器中拖出网络拓扑或者直接打开示例项目文件 [docs/example.prj.json](docs/example.prj.json), 在菜单栏点编译, 生成Shell脚本, 编译结果下载到本地命名为`example.sh`并增加执行权限`chmod 755 example.sh`; \n\n之后的命令都在Linux上执行;\n\n创建虚拟网络:\n```shell script\nsudo ./example.sh create\n```\n创建完之后可以执行`ip netns`查看有哪些主机, 这个案例中会输出:\n```text\npc4 (id: 3)\npc3 (id: 2)\npc2 (id: 1)\npc1 (id: 0)\nrouter1 (id: 4)\n```\n\n#### pc之间的连通\n在`pc1`中ping `pc2`:\n```shell script\n./scripts/netenter pc1 ping 192.168.65.2\n```\n`pc1`和`pc2`在同一个交换机下, 可以ping通;\n\n再试试ping `pc3`:\n```shell script\n./scripts/netenter pc1 ping 192.168.66.1\n```\n这个时候能不能ping通取决于router1上的路由转发有没有打开:\n```shell script\n./scripts/netenter router1 cat /proc/sys/net/ipv4/ip_forward\n```\n如果输出1, 说明路由转发已经打开, 那前面的ping应该也是成功的;\n如果输出0, 说明路由转发没打开, 可以通过这个命令打开:\n```shell script\necho 'echo \"1\"\u003e/proc/sys/net/ipv4/ip_forward' | ./scripts/netenter router1\n```\n现在`pc1`到`pc4`的网络可以互通了;\n\n#### pc到路由器的连通\n现在试试ping路由器`router1`的外网端口`eth0`:\n```shell script\n./scripts/netenter pc1 ping 192.168.64.1\n```\n可以ping通;\n\n#### pc到宿主机的连通\n试试ping宿主机的端口`vroute1`:\n```shell script\n./scripts/netenter pc1 ping 192.168.64.254\n```\n发现ping不通;\n同样宿主机也无法ping通`pc1`\n(如果ping通了, 也许是因为宿主机的网关那边有相同的ip, 或者因为宿主机能自己学习路由表, 例如安装了OSPF相关软件):\n```shell script\nping 192.168.65.1\n```\nping不通的原因是宿主机不知道192.168.65.1在哪, \n要让pc到宿主机连通有两个方案, 分别是NAT和路由表:\n- NAT方案是在router1上开启NAT, 将pc的地址伪装成192.168.64.1, 再跟宿主机通信,\n这个方案下, 宿主机不知道pc的存在, router1上还能配置防火墙规则禁止宿主机主动连接pc, \n就跟我们平时用的路由器那样;\n- 路由表方案是在宿主机上增加路由规则, 让宿主机知道pc在vroute1端口下, \n这个方案下宿主机和pc可以直接互联, 如果我们把宿主机当成ISP, 那pc就相当于有了公网IP.\n\n为了简单, 选择路由表方案, 直接在宿主机增加一条路由规则:\n```shell script\nsudo ip route add 192.168.64.0/18 via 192.168.64.1\n```\n(`192.168.64.0/18`这个网段包含了`192.168.65.1`)\n\n现在`ping 192.168.65.1`, `./scripts/netenter pc1 ping 192.168.64.254`都能通了.\n\n#### pc到外网\n首先打开宿主机的路由转发:\n```shell script\nsudo sh -c 'echo \"1\"\u003e/proc/sys/net/ipv4/ip_forward'\n```\n这个时候尝试ping外网地址`./scripts/netenter pc1 ping 114.114.114.114`, 还是ping不通, \n原因跟上一节一样, 解决方案也是一样, 但是我们不应该改宿主机上级路由的路由表, 所以只能用NAT方案.\n假设宿主机的外网端口是`eth0`, 那么执行这条命令增加NAT:\n```shell script\nsudo iptables -t nat -A POSTROUTING -s 192.168.64.0/18 -o eth0 -j MASQUERADE\n```\n再来一次`./scripts/netenter pc1 ping 114.114.114.114`,\n好耶, pc可以访问外网了! (如果pc还是上不了网, 是不是因为宿主机本来就不能上网??)\n\n本例完结, 其实宿主机也被当成路由器了.\n\n### TODO\n- 核心\n    - 支持路由表配置\n    - 支持NAT配置\n- 图形编辑器\n    - 支持导入蓝图\n    - 撤销/重做\n    - 快捷键\n    - 错误检查\n- 其他\n    - 是否可以利用[JSLinux](https://bellard.org/jslinux/)让整个系统运行在浏览器中?","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjjm2473%2Fvirtual-network-laboratory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjjm2473%2Fvirtual-network-laboratory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjjm2473%2Fvirtual-network-laboratory/lists"}