如何使用 IP 地址修改 Android 的 Captive Portal 校验 URL

在 Android 设备连接 Wi-Fi 时，系统会进行 Captive Portal 检测 ，即访问一个特定的 URL 来判断网络是否可用。如果该 URL 无法访问或返回非预期结果，系统可能会显示"网络连接受限"，并导致 Wi-Fi 不自动重连。

通常，Android 设备默认使用 Google 或厂商提供的 URL 进行校验，例如：

https://connectivitycheck.gstatic.com/generate_204
http://connectivitycheck.gstatic.com/generate_204

如果你希望 使用自己的服务器或 IP 地址 进行校验，可以通过 settings 命令修改这些 URL。

1. 修改 Captive Portal 校验 URL

你可以使用 adb shell 或在 root 设备上执行以下命令：

bash 复制代码

settings put global captive_portal_https_url "https://192.168.1.1/generate_204"
settings put global captive_portal_http_url "http://192.168.1.1/generate_204"

其中：

192.168.1.1 是你的服务器 IP（请替换为你的实际 IP）。
/generate_204 需要配置为返回 HTTP 204 状态码（无内容）。

2. 服务器必须返回 HTTP 204

Android 设备期望该 URL 返回 204 No Content ，否则仍然会认为网络受限。你可以在服务器上配置 /generate_204 路径，使其正确返回 HTTP 204 响应。

示例：如何配置服务器

Nginx 配置

nginx 复制代码

location /generate_204 {
    return 204;
}

Apache 配置

apache 复制代码

Redirect 204 /generate_204

Python Flask 示例

如果你使用 Python 作为服务器，可以创建一个 Flask 应用：

python 复制代码

from flask import Flask, Response
app = Flask(__name__)

@app.route('/generate_204')
def generate_204():
    return Response(status=204)

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=80)

这样，访问 http://192.168.1.1/generate_204 时，服务器会正确返回 HTTP 204。

3. 确保 IP 地址可访问

设备必须能够访问该 IP 地址，否则校验仍然会失败。
如果是 本地服务器，确保 Wi-Fi 设备可以访问它。
如果是 公网服务器，确保 IP 地址可以被 Android 设备访问，并且没有防火墙阻挡。

4. 关闭 Captive Portal 检测（可选）

如果你希望 完全禁用网络校验（不推荐），可以执行：

bash 复制代码

settings put global captive_portal_mode 0

其中：

0 = 禁用网络校验（Wi-Fi 连接时不会检查是否有互联网）
1 = 仅显示通知（如果网络受限，系统会提示但不会阻止连接）
2 = 标准校验（默认，系统会检测网络是否可用，并可能限制连接）

如果你只是希望 Wi-Fi 自动连接，但仍然希望检测网络状态，建议使用：

bash 复制代码

settings put global captive_portal_mode 1

5. 查看当前 Captive Portal 配置

如果你想检查当前设备的 Captive Portal 设置，可以使用：

bash 复制代码

settings get global captive_portal_https_url
settings get global captive_portal_http_url
settings get global captive_portal_mode

这将返回当前的校验 URL 和模式。

6.日志

bash 复制代码

logcat | grep NetworkMonitor

6. 总结

Android 设备使用 Captive Portal URL 来检测网络是否可用，如果检测失败，Wi-Fi 可能不会自动重连。
可以使用 IP 地址替换默认的校验 URL ，但服务器必须正确返回 HTTP 204 状态码。
确保 IP 地址可访问，否则设备仍然可能认为网络受限。
可以选择关闭 Captive Portal 检测，但不推荐，因为可能影响 Wi-Fi 连接稳定性。