基于Ignite云控制器搭建简易外部Captive Portal的技术咨询

完全没问题！你要的这种仅需条款确认的轻量Captive Portal，用普通Web服务就能实现，不需要复杂的AAA组件——刚好匹配你的需求。下面是一步步的实现思路和细节：

1. 先在Ignite云控制器完成基础配置 #

首先得让Ignite知道要把用户请求转发到你的Web服务：

• 登录Ignite云控制台，找到你要配置的SSID，进入Captive Portal设置项
• 选择「External Captive Portal」（外部门户）模式
• 填写你的Web服务的主页URL（比如http://your-server-ip:80），同时确认控制器里的「Redirect URL」或者「Completion URL」配置（这个是后续放行用户的关键地址）
• 确保Ignite控制器和你的Web服务之间网络连通：开放Web服务的端口（比如80/443），防火墙不要拦截AP到服务器的请求

2. 从AP获取用户/设备信息的方法 #

当用户连接SSID后，AP会自动把用户的所有HTTP请求重定向到你的Web服务，同时会在请求中携带关键信息——你不用主动去“拉”AP的信息，只要解析AP发过来的请求就行：

• 用户设备IP：通常在请求头X-Forwarded-For里，或者如果是直接转发的话，request.remote_addr就是设备IP
• 当前SSID：会作为Query参数传过来，参数名一般是ssid或者wlan-name
• AP自身信息：可能会带ap-mac、ap-name这类参数，用来标识是哪个AP转发的请求

你可以在Web服务里先打印所有请求参数和头信息来确认，比如用Python Flask写个简单的调试接口就能看到这些内容。

3. 核心Web服务实现逻辑 #

这里给你一个极简的Flask示例，实现“展示条款→点击同意→跳转放行”的流程：

from flask import Flask, request, redirect

app = Flask(__name__)

# 你要匹配的SSID列表（可以从本地文件/数据库读取）
ALLOWED_SSIDS = ["Guest_WiFi", "Office_Guest"]

@app.route('/')
def show_terms():
    # 提取关键参数
    client_ip = request.headers.get('X-Forwarded-For', request.remote_addr)
    ssid = request.args.get('ssid', '')
    # AP提供的放行跳转地址（必须保留，用来通知AP放行用户）
    redirect_url = request.args.get('redirect-url', 'http://www.example.com')

    # 匹配SSID，如果不在允许列表里，直接放行或者返回提示
    if ssid not in ALLOWED_SSIDS:
        return redirect(redirect_url)

    # 返回条款同意页面
    return f'''
    <html>
        <body style="text-align: center; margin-top: 50px;">
            <h2>欢迎使用{ssid}网络</h2>
            <p>请阅读并同意以下条款：</p>
            <p>1. 仅用于合法网络访问</p>
            <p>2. 请勿滥用网络资源</p>
            <form method="POST" action="/accept">
                <input type="hidden" name="redirect_url" value="{redirect_url}">
                <button type="submit" style="padding: 10px 20px; font-size: 16px;">我同意，继续访问</button>
            </form>
        </body>
    </html>
    '''

@app.route('/accept', methods=['POST'])
def accept_terms():
    # 获取之前保存的放行地址
    redirect_url = request.form.get('redirect_url')
    # 重定向到这个地址，AP会自动识别并放行该用户设备
    return redirect(redirect_url)

if __name__ == '__main__':
    # 让服务监听所有网卡，确保AP能访问到
    app.run(host='0.0.0.0', port=80)

4. 关键注意事项 #

• 放行逻辑：核心是让用户访问AP指定的redirect-url，只要用户成功访问这个地址，AP就会标记设备为已认证，不需要你调用额外的Ignite API
• SSID匹配：你可以把允许的SSID列表存在本地JSON文件或者简单的SQLite数据库里，方便动态更新，不需要重启服务
• 调试：用测试设备连接SSID后，打开浏览器随便访问一个网址，就能看到你的条款页面；同时在Web服务的控制台查看日志，确认参数是否正确获取
• HTTPS（可选）：如果需要更安全的传输，可以给Web服务配置SSL证书，用443端口，Ignite也支持HTTPS的外部Portal地址

这样一套下来，就能实现你要的轻量Captive Portal，完全不需要AAA功能，只靠普通Web服务就能搞定。

内容的提问来源于stack exchange，提问作者Saransh Sharma