WX控制器本地web portal页面文件

AC本地portal认证自定义认证页面修改失败！ - 知了社区

可以的

定制WX控制器的本地Portal页面，需要先遵循一套固定的文件名规范，然后通过命令行上传和激活。

 第一步：准备自定义页面文件

在开始前，请先按H3C的规范准备好页面文件，这是最关键的一步：

• 固定文件名：核心页面必须使用下表列出的文件名，不能更改。

  页面类型	固定文件名 (必须)	说明
  登录页面	logon.htm	用户输入用户名和密码的界面
  登录成功页	logonSuccess.htm	认证通过后的提示页面
  登录失败页	logonFail.htm	认证失败后的提示页面
  在线页面	online.htm	用户已在线时的提示页面
  系统忙页面	busy.htm	系统繁忙时的提示页面
  下线成功页	logoffSuccess.htm	用户成功下线后的提示页面

• 表单属性规范：logon.htm 页面中，用户提交登录信息的表单 action 属性必须指向 logon.cgi，并且用户名和密码的 name 属性必须分别设置为 PtUser 和 PtPwd。

  <!-- 表单示例 -->

  <form action="logon.cgi" method="post"> <input type="text" name="PtUser" placeholder="用户名"> <input type="password" name="PtPwd" placeholder="密码"> <input type="submit" value="登录"> </form>

• 打包与命名：将所有页面文件（包括图片、CSS等）打包成一个 ZIP格式 的压缩包。压缩包的名称可以自定义（例如 myportal.zip），但文件名不要使用中文。

• 文件大小限制：请注意，整个ZIP压缩包大小不能超过500KB，其中单个页面文件不能超过50KB。

 第二步：上传并激活自定义页面

页面准备完成后，就可以将其上传到WX控制器并激活了。

1. 上传文件：通过TFTP、FTP或USB等方式将ZIP包上传到AC的Flash中。

   <H3C> system-view

   # 建议将文件放在 flash:/ 根目录下 <H3C> tftp 192.168.1.100 get myportal.zip

2. 配置本地Portal Web服务器并激活：进入配置模式，将刚刚上传的ZIP文件设置为默认登录页面。

   <H3C> system-view

   [H3C] portal local-web-server http [H3C-portal-local-websvr-http] default-logon-page myportal.zip 这个命令会立即解压ZIP包并使其生效。你也可以在命令后加上 no-reload 选项来禁止立即解压，但通常不需要。

 第三步：将页面绑定到特定SSID（可选）

如果需要为不同SSID提供不同风格的认证页面，可以使用绑定功能。否则，上面的设置会作为全局默认页面生效。

H3C WX 控制器（WX2500/WX3500/WX5500/WX6600 等）支持本地 Portal 自定义页面，核心是：自己写 6 个 HTML → 打包 ZIP → 上传到 AC → 命令引用。下面给你完整可落地的文件规范、路径、上传与配置步骤。
一、本地 Portal 页面文件规范（必须严格遵守）
1. 必须的 6 个页面（文件名固定）
logon.htm —— 登录页（必填）
logonSuccess.htm —— 登录成功
logonFail.htm —— 登录失败
online.htm —— 在线页
busy.htm —— 系统忙
logoutSuccess.htm —— 下线成功
只做其中几个也可以，缺的用 AC 默认页。
2. 页面与资源要求
纯静态 HTML/CSS/JS/ 图片
页面内引用资源（img、css、js）必须用相对路径
html
预览
<img src="logo.png">
<link rel="stylesheet" href="style.css">
不要嵌套目录：所有文件直接放 ZIP 根目录
ZIP 命名：字母 / 数字 / 下划线，如 portal_vip.zip
默认包必须叫：defaultfile.zip
3. 表单关键（必须包含）
登录页 logon.htm 必须有如下表单（AC 才能识别）：
html
预览
<form method="post" action="/portal">
<input type="text" name="username">
<input type="password" name="password">
<input type="hidden" name="cmd" value="login">
<button type="submit">登录</button>
</form>
action="/portal" 固定
name="username"/password 固定
name="cmd" value="login" 固定
二、AC 上文件路径与存储位置
存储介质：flash:
存放目录：
默认页：flash:/defaultfile.zip
自定义页：flash:/xxx.zip 或 flash:/portal/xxx.zip
查看：
plaintext
dir
dir flash:/portal/
三、完整操作流程（现场直接照做）
1. 准备页面并打包
写好 6 个 htm + 图片 / CSS/JS
全选 → 右键 → 发送到 → 压缩 (zip)
不要套文件夹：zip 内直接看到所有文件
命名：如 myportal.zip
2. 上传 ZIP 到 AC（3 种方法）
方法 1：FTP 上传（最常用）
plaintext
# 电脑开 FTP Server（如 FileZilla）
# AC 上执行：
ftp 192.168.1.100
get myportal.zip flash:/
方法 2：TFTP
plaintext
tftp 192.168.1.100 get myportal.zip flash:/
方法 3：Web 上传（部分型号支持）
网络 → 安全 → Portal → 本地 Portal Web 服务器 → 上传页面包
3. AC 命令配置（核心）
1) 启用本地 Portal Web 服务（HTTP/HTTPS）
plaintext
# HTTP
portal local-web-server http
default-logon-page myportal.zip # 引用你的zip
tcp-port 80 # 默认80
quit

# HTTPS（推荐）
portal local-web-server https
ssl-server-policy ssl_policy # 先配好SSL策略
default-logon-page myportal.zip
tcp-port 443
quit
2) 按 SSID / 设备类型 绑定不同页面（多 SSID 常用）
plaintext
portal local-web-server http
# 绑定SSID：office 用 office.zip
logon-page bind ssid office file office.zip
# 绑定手机/平板/电脑不同页面
logon-page bind device-type phone file mobile.zip
logon-page bind device-type pad file pad.zip
logon-page bind device-type computer file pc.zip
quit
3) 无线服务模板引用 Portal
plaintext
wlan service-template 1
portal enable method direct # 直接Portal
portal apply web-server newpt # 关联Portal服务器
# 下面是创建Portal服务器（指向AC自身）
portal web-server newpt
url http://AC_IP/portal
url-parameter wlanuserip source-address
quit
4. 生效与查看
plaintext
# 重启本地Portal（改页面后必做）
undo portal local-web-server http
portal local-web-server http
default-logon-page myportal.zip

# 查看
display portal local-web-server
display portal web-server
四、常见问题
上传后不生效
检查：zip 内无嵌套目录
文件名是否严格：logon.htm 等
执行：undo default-logon-page 再重新配置
页面显示乱码 / 无样式
编码：UTF-8
路径：相对路径
登录提交没反应
表单 action、name 是否和上面一致
五、默认页面导出（参考）
如果你需要默认页面模板：
plaintext
# 把默认 defaultfile.zip 传到电脑
tftp 192.168.1.100 put flash:/defaultfile.zip
解压后照着改即可。