本地模型Web界面部署到内网穿透时HTTPS证书失效导致权限请求失败

文章导读
最近在处理本地模型Web界面通过内网穿透暴露到公网时遇到的权限请求失败问题。现象很典型:
📋 目录
  1. Ⅰ 先确认现象
  2. Ⅱ 容易误判的地方
  3. Ⅲ 临时止血:本地访问
  4. Ⅳ 配置证书与转发
  5. Ⅴ 验证与回滚
A A

最近在处理本地模型Web界面通过内网穿透暴露到公网时遇到的权限请求失败问题。现象很典型:

当本地模型Web界面通过内网穿透服务暴露到公网时,浏览器地址栏会出现证书警告,页面内涉及摄像头、麦克风或文件读取的权限请求会被浏览器直接拦截。这是因为内网穿透分配给用户的域名通常使用服务商提供的通配符证书,与该域名下的实际主机名不匹配,导致安全上下文失效。权限API在非安全源下默认禁止调用,即使后端逻辑正常,前端也会在发出请求前就抛出NotAllowedError。

这个报错不属于后端接口异常,而是浏览器在权限API调用前就已经切断了执行路径。排查时我按下面几个步骤走。

先确认现象

要确认是否属于证书失效导致的权限问题,可以先在浏览器开发者工具的Console面板中查看错误类型。若看到类似于“The request is not allowed by the user agent or the platform in the current context”的提示,且页面URL的协议为HTTPS但证书图标显示为“不安全”,则基本可以判定为证书信任链问题。此时应检查证书的域名是否与访问地址完全一致,包括子域名和路径,以及证书是否过期或由不受信任的CA签发。

我打开浏览器控制台,确实看到了这句提示,地址栏左侧的锁图标也变成了“不安全”样式。为了进一步确认,我执行了下面的命令,检查证书实际信息:

openssl s_client -connect your.domain.com:443 -servername your.domain.com

重点看输出里的subject和issuer。如果subject中的CN或SAN不包含你的访问域名,说明证书匹配失败。还要检查verify return code,不是0的话,证书链也可能不完整。

容易误判的地方

第一次遇到这种情况,容易把注意力放在权限请求的代码上,以为是getUserMedia参数错误或者权限策略没配好。但真正的原因多半是页面没有处于“secure context”。除了证书不匹配,下面几种情况也会导致类似问题:

本地模型Web界面部署到内网穿透时HTTPS证书失效导致权限请求失败
  • 页面通过http://或非规范域名访问,例如直接用穿透分配的内网IP。
  • 页面被嵌入iframe,但父级没有设置allow="camera; microphone"属性,或者Permissions-Policy头限制了子页面权限。
  • 浏览器扩展或Service Worker干扰了权限请求,这个情况较少见。

权限请求失败还和触发时机有关。如果页面一加载就立即调用getUserMedia,浏览器可能还没完成证书验证,就会以“不安全上下文”为由拒绝。所以我把权限请求放到用户点击按钮之后触发,而不是放在页面onload里。同时检查了iframe的allow属性和父级返回的Permissions-Policy头,避免子页面被限制。

临时止血:本地访问

如果短期无法更换证书,又必须立刻测试界面功能,可以先退回局域网访问。通过IP地址或修改hosts文件,把域名解析到本机,用HTTP协议或自签证书访问。这样绕开了穿透服务的证书限制,但局域网IP访问不会让外网用户获得权限。

如果你的穿透服务支持自定义域名和证书绑定,也可以先在后台绑定证书。不过申请证书需要时间,临时方案可以先顶着。

配置证书与转发

从根源上避免证书失效,合理的方式是让本地Web服务器直接承载公开域名对应的证书,然后通过内网穿透工具将TCP流量原样转发到本地的443端口,而不是让穿透服务用其自有证书做HTTPS接管。这样浏览器看到的就是你配置在本地服务器上的证书,域名匹配即可建立信任。实现时需保证穿透服务不被中间层替换证书,同时本地防火墙要放行对应映射端口。若无法做到,则退而求其次,将涉及权限请求的敏感功能降级为基于token的授权,不使用浏览器原生权限API。

具体操作分三步。第一步申请Let's Encrypt证书:

sudo certbot certonly `--standalone` -d your.domain.com

执行前确保域名已解析到公网IP,且本地80端口没有被其他服务占用。成功后证书会写入/etc/letsencrypt/live/your.domain.com/。

本地模型Web界面部署到内网穿透时HTTPS证书失效导致权限请求失败

第二步配置本地Web服务器。以Nginx为例,在443端口上使用刚才签发的证书,并把流量反向代理到本地模型Web界面的实际端口:

server {
    listen 443 ssl;
    server_name your.domain.com;

    ssl_certificate /etc/letsencrypt/live/your.domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your.domain.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

这里proxy_pass里的8080要替换成你本地模型Web界面的端口。配置完成后先本机验证:curl -k https://127.0.0.1,能返回界面内容再继续。

第三步调整内网穿透。以frp为例,使用TCP透传,而不是HTTP代理,确保证书在本地Nginx终结:

# frpc.toml
serverAddr = "your-server-ip"
serverPort = 7000

[[proxies]]
name = "web-https"
type = "tcp"
localIP = "127.0.0.1"
localPort = 443
remotePort = 443

注意localPort填本地Nginx监听的443端口,remotePort是公网开放端口。如果穿透服务支持直接绑定证书,也可以在后台配置,但建议采用TCP透传,这样证书链完全由自己控制。

验证与回滚

全部配置完成后,清理浏览器缓存和Service Worker,重新访问https://your.domain.com。地址栏出现锁图标,控制台不再报NotAllowedError,点击权限请求按钮会弹出浏览器授权对话框。

如果验证失败,优先检查穿透服务是否替换了证书。有些服务商默认启用SSL终结,需要在后台关闭或选择TCP类型。回滚时,撤掉本地Nginx配置和frp的TCP转发,保留原来的HTTP入口,同时继续用局域网IP访问作为临时方案。