portnox/portnox-unifi-agent
portnox
该Docker镜像允许Portnox客户将Portnox Guest Portal与Ubiquiti Unifi网络集成，作为外部 captive portal使用，实现访客网络的认证与管理。
下载次数: 0状态：社区镜像维护者：portnox仓库类型：镜像最近更新：4 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
portnox/portnox-unifi-agent镜像说明
镜像概述
该Docker镜像为Portnox客户提供将Portnox Guest Portal与Ubiquiti Unifi网络集成作为外部 captive portal的能力，帮助企业或组织实现访客网络的认证与管理。
核心功能
- 集成Portnox Guest Portal与Unifi网络，提供访客认证服务
- 通过环境变量灵活配置Unifi控制器连接信息（IP、端口、登录凭证）
- 支持Portnox Cloud参数（Captive Portal ID、API访问令牌）的配置
- 可选支持多站点配置（UNIFI_SITE参数）和自签名证书忽略（IGNORE_TLS_ERRORS参数）
使用场景
- 企业或组织需要为访客网络部署Portnox Guest Portal认证的场景
- Unifi网络环境下需要外部 captive portal解决方案的场景
- 需要通过Docker容器快速部署集成工具的场景
配置说明
前置准备
在配置Unifi控制器前，需先在Portnox Cloud配置访客网络，并记录以下参数：
- Captive Portal ID（示例：
b2973887-1274-45c4-91d0-4a342a861c76-homeworld，对应PORTNOX_ECP_ID字段） - Captive Portal Proxy URL（适用于UniFi）（示例：
https://b2973887-1274-45c4-91d0-4a342a861c76-homeworld.proxy.guests.portnox.com） - 在Settings > Profile Settings > CLEAR API TOKENS生成的API访问令牌（示例：
mk1yiGyEatNa_qFR8ibnr9HWht4）
在Unifi控制器创建服务账户
- 登录Unifi Web UI，进入Settings > Admins & Users > Create New Admin
- 创建服务账户： a. 勾选Restrict to Local Access Only b. 输入用户名和密码 c. 取消勾选Use a Predefined Role d. Network字段选择Site Admin e. Control Plane字段选择None f. 点击Create按钮
- 进入Settings > System > Advanced，若Sync Local Admins with SSO勾选则取消（若不可用则跳过）
运行Docker容器
- 在与Unifi控制器同子网的机器上安装Docker
- 执行以下命令运行容器：
bashdocker run -d --name portnox-unifi-agent --restart=on-failure --pull always \ -e UNIFI_HOST=你的Unifi控制器本地IP \ -e UNIFI_PORT=你的Unifi端口（通常为443或8443） \ -e UNIFI_LOGIN=Unifi服务账户或管理员登录名 \ -e UNIFI_PASSWORD=Unifi服务账户或管理员密码 \ -e PORTNOX_ECP_ID=Captive Portal ID值 \ -e PORTNOX_ACCESS_TOKEN=API访问令牌值 \ -e UNIFI_SITE=你的Unifi站点名称（可选） \ -e IGNORE_TLS_ERRORS=true（可选，用于自签名证书） \ portnox/portnox-unifi-agent:latest
示例：
bashdocker run -d --name portnox-unifi-agent --restart=on-failure --pull always \ -e UNIFI_HOST=192.168.0.1 \ -e UNIFI_PORT=443 \ -e UNIFI_LOGIN=service \ -e UNIFI_PASSWORD=hsDkjFg643mvi!eBHJps \ -e PORTNOX_ECP_ID=b2973887-1274-45c4-91d0-4a342a861c76-homeworld \ -e PORTNOX_ACCESS_TOKEN=HyDd3gwcz3EGXvEEmjes1kktPXY \ -e UNIFI_SITE="default" \ -e IGNORE_TLS_ERRORS=true \ portnox/portnox-unifi-agent:latest
（Windows环境下将每行末尾的\替换为^或合并为单行）
创建访客网络SSID
- 进入Unifi Web UI的Settings > WiFi > Create New
- 配置新WiFi： a. 输入访客网络SSID名称 b. Advanced选择Manual c. Hotspot 2.0选择Captive Portal d. Security Protocol选择Open e. 配置其他必要字段后点击Add WiFi Network
配置Unifi Captive Portal
- 进入Unifi Web UI的Insights > Hotspot
- 点击Landing Page按钮
- 在右侧面板的Authentication标签中勾选External Portal Server
- 点击External Portal Server的Edit链接，输入IP地址（美国：134.33.139.160，欧盟：50.85.37.114）并保存
- 在Settings标签中：
a. Landing Page Settings部分勾选Show Landing Page, HTTPs Redirection Support、Secure Portal和Domain，在Domain字段粘贴Portnox Cloud的Captive Portal Proxy URL（去除开头的
https://） b. Authorization Access部分：- Pre-Authorization Allowances添加
proxy.guests.portnox.com、134.33.139.160、50.85.37.114 - Post-Authorization Restrictions添加
192.168.0.0/16、172.16.0.0/12、10.0.0.0/8（若未存在） c. 点击Save保存配置
- Pre-Authorization Allowances添加
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 portnox-unifi-agent 镜像标签
docker pull docker.xuanyuan.run/portnox/portnox-unifi-agent:<标签>
DockerHub 原生拉取命令
docker pull portnox/portnox-unifi-agent:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"