【产品教程】2026.07.03 XOS2.0（公用801）WIFI认证-梦想网关桥接模式-对接光迅portal短信认证（标准模式）
操作背景：客户需要保留原有的网络结构，确保可以正常通信，在此基础上，增加portal认证的功能，针对内部接入到无线网段的设备，只有通过认证后方可上网
一、拓扑和IT规划
1、IT网络规划（实际场景中可能有业务VLAN，或者网段不一样，根据实际场景做变通，这里仅以关键数据为例）
设备管理10.10.0.1/22DHCP：10.10.1.2-10.10.3.254GW：10.10.0.1（不需要portal认证）
有线网络10.20.0.1/22DHCP：10.20.1.2-10.20.3.254GW：10.20.0.1（不需要portal认证）
无线网络10.50.0.1/22DHCP：10.50.1.2-10.50.3.254GW：10.50.0.1（需要portal认证）
2、拓扑链接和配置
        客户这边的简化场景拓扑如下图所示：
拓扑的网络属性特点：
● 终端有划分vlan，承载多种业务，从梦想网关的一对桥接口穿过
● 梦想网关系统本身通过桥接接口Br1口绑定WAN口，可以和外部网路进行通信（实现设备远程+云端portal服务器对接）
● 终端可以和桥接虚拟接口Br1口建立通信

![](/media/202607/09b37a004069492fa7a4f6f9ccbf2a3e3394.png)
3、XOS2.0设备版本设备和操作条件
（1）XOS2.0设备的版本需求：C01V01R001P260416版本以上

![](/media/202607/a3facad1c724483c997564fa135502385105.png)
（2）操作前环境需要有通网条件
4、部署总流程

![](/media/202607/2fd07925da234a14b61c9b24c1034f6d6725.png)
5、XOS2.0对接EAASportal微信小程序认证部署
第一部分：关键信息的获取
（1）项目名称和项目ID（EAAS上面自动生成的ID）

![](/media/202607/671cf57a8c2d40e88acaf2e45b4eee865294.png)
（2）网关MAC（设备的LAN口mac，这里只是标识作用，因此，这里咱们统一用1口的mac）
网关mac的获取位置如下：

![](/media/202607/e368aebc11fa4ed796648c76f8e0f44e5191.png)
（3）网关序列号（授权码通过一次MD5运算输出的结果）
网关序列号可以通过如下方式获取

![](/media/202607/2adecfa8478c49e889acfaf2edd7fd2d8072.png)
第二部分：光迅的portal服务器模块调试
场景一：针对客户没有专门开通短信平台的场景，可以附带关键信息，并联系售后技术配置portal平台
关键信息整理：
（1）关键项目信息：项目ID 以及对应的项目名称
（2）认证需求信息：真实短信认证，对接光迅portal
（3）网关设备信息：具体的网关设备型号 (比如：ZH-M1)
（4）页面素材信息（三个文件）：
① LOGO图片信息：150x58px png格式（可透明背景效果） jpg格式（无透明背景效果）文件重命名：LOGO.png
② 品牌LOGO图片信息：120x16px png格式（可透明背景效果） jpg格式（无透明背景效果） 文件重命名：品牌LOGO.png
③ 背景图片信息：864*1536px jpg格式 背景.jpg
整理后，可以将整理的信息发送给到技术人员，进行portal平台的部署，部署完成后，接口进行下面的步骤
第三部分：XOS2.0设备的调试（基础网络参数）
第一步：配置物理接口属性

![](/media/202607/c4808d907049418488d721dcd914e7bd6317.png)
将该接口修改为桥接模式，并配置Br口到信任区域，设置为外网类型
配置内网端口为本端端口，并配置接入到L2trust区域；配置外网端口为5口，并配置接入到L2untrust区域；

![](/media/202607/1c4942c10c814e6ba6f1df24284f64cf1124.png)
配置完成后，在接口列表中可以看到，1口和5口被对应首选成为了桥接模式，同时自动Br口，接口编号1

![](/media/202607/360b366ed7124ced8dffe3fbaf693de95806.png)
第二步：创建WAN口，绑定到桥接虚拟口Br1口，配置完成后，点击确定

![](/media/202607/d049d6a4cd3341329ad98961aedc78e21554.png)

![](/media/202607/3cb442afa69942d2a705e37a3ef17f351748.png)

![](/media/202607/d24457f662f548c5bc95cc5382e4f3b93981.png)
第四步，配置缺省路由（缺省路由指向对应出接口网关IP地址）

![](/media/202607/a25b8c79b7c1401780a08342fdb604b88466.png)
选择接口为Br1口，配置完成后，点击确定

![](/media/202607/50538dc5a6de4a0cb870ad730122e1582105.png)
点击确定后，在静态路由列表中，可以看到咱们刚刚添加的静态路由表项

![](/media/202607/724e82f9729243ef99ba4d409b7c91b66003.png)
第六步：配置安全策略（将信任区域到非信任区域打通）

![](/media/202607/3c3335de2f06419b83369c93b60fc6577917.png)

![](/media/202607/5323715aa9e24dd986c1060b01d3384d7406.png)
配置完成后，可以看到已经创建的安全策略条目如下图所示：

![](/media/202607/06fd199f5f01436988e9f97503cc8aa32378.png)
第四部分：配置portal认证
第一步：在LAN口配置中打开web认证开关

![](/media/202607/5dfe51eccfd8422da2aeca2ffd9476a35953.png)

![](/media/202607/c406790635ba4fffa9fde358bb00cb157075.png)
第二步：添加认证策略，认证类型设置为wifidog

![](/media/202607/42c266041c4a4ace9ac7efb4c523fcd81192.png)
默认是没有认证条目的，咱们点击新增，点击后可新增认证条目
特别注意：portal场景下，自动绑定这里不要配置，因为portal场景下，终端基本上都是移动的手机，这里我们不需要做IP地址绑定鉴权！
特别注意：portal场景下，咱们一般选择绑定mac地址（在portal场景下系统在加入组织的过程中，会将mac作为用户名，将用户加入到组织中）
特别注意：一定不能去绑定IP地址，绑定IP地址的意思是只允许用户使用这个IP地址上网，不是这个IP地址不允许上网

![](/media/202607/ee92bdc178e84fe0a444aa5f1a58443c4926.png)
配置完成后，点击确定提交，在认证策略条目中，可以看到咱们刚刚添加的条目

![](/media/202607/207f0e3a4a484e17acb1ee6f3537621d4686.png)
第三步：配置认证参数
注意：场景若单单需要满足真实短信认证，则配置如下图所示：（单做真实短信认证，不做小程序认证的场景）

![](/media/202607/62800ebca0b843b1b61bc4a0d70d437b6596.png)
第四步：新增域名组（第五步调用）
咱们新增域名组
portal域名组：portal过程中，终端请求登录页和成功页等，和云端portal服务器交互使用的域名
wifiportal.sczhgx.com（M1产品线）；
OSS域名组：在登录页成功页中，一些图片素材（比如背景图片，logo等等）资源的请求地址使用的域名
wifi-portal.oss-cn-shenzhen.aliyuncs.com（以后使用）；
at-portal-test.oss-cn-hangzhou.aliyuncs.com（当前使用）；

![](/media/202607/afed2360aa9d481cbc2b431df6daf4ca7586.png)
创建portal域名组（只需要填写 wifiportal.sczhgx.com（M1产品线）即可）

![](/media/202607/97b80bcccec4408bb9130de24f72d2192740.png)
创建OSS域名组

![](/media/202607/4c58b56087f648589b891e41bb9b7b9c2260.png)
创建好后，情况如下图：

![](/media/202607/32cc4709bbbc4e61b44be057bdebbef92606.png)
第五步：配置未认证权限
新增未认证权限项，确保网关设备不会拦截：
Portal域名：wifiportal.sczhgx.com
OSS域名：
wifi-portal.oss-cn-shenzhen.aliyuncs.com（以后使用）；at-portal-test.oss-cn-hangzhou.aliyuncs.com（当前使用）；

![](/media/202607/1b3eb454b3c4415eb020c98aa315be931468.png)
创建Portal域名放行

![](/media/202607/6668f567208d4ed3b23d67c06bf65afc6581.png)
创建
OSS域名放行

![](/media/202607/4692b5f9014d426b953e36e91a6aa6937081.png)
添加完成后，如下图所示：（可以看到未认证选项这里调用了刚刚上一步创建的域名组，确保网关设备不会拦截portal服务器地址：wifiportal.sczhgx.com）

![](/media/202607/44be9a4f56f8422e817ccb8846d32d9b9865.png)
第六步：配置wifidog服务器
配置portal服务器地址为：https://wifiportal.sczhgx.com/gxwifidog

![](/media/202607/c738aa97c751436884b277dae3863c265358.png)

![](/media/202607/2294ce081f874e26a626703974b3dedf2516.png)

梦想网关 桥接模式对接光迅portal短信认证（标准模式）

梦想网关桥接模式对接光迅portal短信认证（标准模式）