【产品教程】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/7a69afc803834e67b5290e0c8c15caad5331.png)
3、XOS2.0设备版本设备和操作条件
（1）XOS2.0设备的版本需求：C01V01R001P260416版本以上

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

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

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

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

![](/media/202607/9310c1356af84f05913dd1e579e08e379502.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/4e6d5c9819f34889843bff52653e02f96036.png)
将该接口修改为桥接模式，并配置Br口到信任区域，设置为外网类型
配置内网端口为本端端口，并配置接入到L2trust区域；配置外网端口为5口，并配置接入到L2untrust区域；

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

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

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

![](/media/202607/38d6a20e824145c698c6545f3dc825d05996.png)

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

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

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

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

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

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

![](/media/202607/464ee373de7e448eb9a6c35424edb6289247.png)
第四部分：配置portal认证
第一步：在WAN口（Br口上）配置中打开web认证开关

![](/media/202607/7ae14bcee7f44a6b9db40973325f913c4324.png)

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

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

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

![](/media/202607/b70f685df744424ca66d6594b2f2a0d77497.png)
第三步：配置认证参数
注意：场景若单单需要满足真实短信认证，则配置如下图所示：

![](/media/202607/3d09cfa784174b408c2fe174abd852e21279.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/c394122827e0442d892a33bd0689a0796616.png)
创建portal域名组（只需要填写 wifiportal.sczhgx.com（M1产品线）即可）

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

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

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

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

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

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

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

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

![](/media/202607/6a77b5e9328d4206b1cb975e9543e77c9555.png)

梦想网关 桥接模式对接光迅portal小程序认证（标准模式）

梦想网关桥接模式对接光迅portal小程序认证（标准模式）