为什么开发环境能打印,上线 HTTPS 后 WebSocket 连 127.0.0.1:16794 失败?
多为 Chrome Local Network Access 限制:公网 HTTPS 页面默认不能随意访问本机回环地址。需配置受信证书并按文档放开本地网络访问,或仅在受控环境用 flags 临时验证。
浏览器 Console 或 Network → WS 可能出现:
WebSocket connection to 'ws://127.0.0.1:16794/websocket/standard' failed:| 环境 | 是否常见 |
|---|---|
开发(localhost 等) | 通常不会 |
| 线上 HTTP | 会(LNA 静默拒绝) |
| 线上 HTTPS(证书受信任) | 首次需点「允许本地网络」,之后一般正常 |
Chrome / Edge 将「非本地页面访问 127.0.0.1」视为本地网络访问(Local Network Access),可能拦截 WebSocket。开发环境页面来源为本地,线上则否。
许多业务系统仍是 HTTP 站点,或从内网 IP / 域名访问。自 Chrome 142(2025 年 10 月)起,浏览器启用「本地网络访问(LNA)」:公网站点须在 HTTPS 等安全上下文 下才能申请访问本机/内网;HTTP 页会被静默拒绝。自 Chrome 147 起,该限制扩展到 WebSocket,因此公网站点无法连接本机打印客户端(ws://127.0.0.1:16794/websocket/standard),即使用户已安装并启动 Web打印专家客户端也会报 WebSocket 连接失败。Chromium 系浏览器(Edge 等)会跟进同类策略。
目标:业务页须处于安全上下文(HTTPS),浏览器才允许向本机 127.0.0.1 发起 WebSocket 并弹出「本地网络」授权;纯 HTTP 会被静默拒绝,与客户端是否已启动无关。
证书配置完成、用户用 https:// 正常打开业务页(地址栏有锁、无证书错误)后,首次打印时请在弹窗中选择允许访问本地网络。
有公网 DNS 且 80/443 可达时,可用 Certbot 免费签发:
# /etc/nginx/conf.d/erp.conf
server {
listen 80;
listen [::]:80;
server_name erp.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name erp.example.com;
ssl_certificate /etc/letsencrypt/live/erp.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/erp.example.com/privkey.pem;
ssl_session_timeout 1d;
ssl_protocols TLSv1.2 TLSv1.3;
root /var/www/erp/dist;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}
# Ubuntu / Debian
sudo apt update
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d erp.example.com
# 续签验证
sudo certbot renew --dry-run
内网 IP(如 192.168.x.x)或纯内网域名无法用 Let's Encrypt 公网签发。可使用自签证书或企业内网 CA:将根证书安装到各工位「受信任的根证书颁发机构」,再用 https:// 访问业务页。
# 示例:内网域名 erp.lan(按实际主机名改 CN / SAN)
sudo mkdir -p /etc/nginx/ssl
sudo openssl req -x509 -nodes -days 825 -newkey rsa:2048 \
-keyout /etc/nginx/ssl/erp.key \
-out /etc/nginx/ssl/erp.crt \
-subj "/CN=erp.lan" \
-addext "subjectAltName=DNS:erp.lan"
# 若用 IP 访问(如 https://192.168.1.10),SAN 须含该 IP,例如:
# -addext "subjectAltName=DNS:erp.lan,IP:192.168.1.10"
# Nginx 引用自签证书(路径按实际部署修改)
server {
listen 443 ssl;
server_name erp.lan; # 或与证书 SAN 一致的 IP / 域名
ssl_certificate /etc/nginx/ssl/erp.crt;
ssl_certificate_key /etc/nginx/ssl/erp.key;
root /var/www/erp/dist;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}
自签证书未安装到工位信任库时,浏览器会提示「连接不安全」,页面不是安全上下文,仍无法连本机 WebSocket。内网批量部署建议用企业 CA 统一下发根证书,或暂用方案二关闭 LNA 检查。
https:// 打开,Console 执行 window.isSecureContext 为 trueChrome / Edge(Chromium 141+)会检查页面访问本机服务。可在工位浏览器关闭 Local Network Access check(HTTP / HTTPS 均有效)。
chrome://flags/#local-network-access-checkedge://flags/#local-network-access-check多为 Chrome Local Network Access 限制:公网 HTTPS 页面默认不能随意访问本机回环地址。需配置受信证书并按文档放开本地网络访问,或仅在受控环境用 flags 临时验证。
确认本机已安装并启动 Web打印专家客户端;检查防火墙是否放行 16794;公网 HTTPS 站点优先用 Nginx + 证书,详见本排障页。
面向公网用户强烈建议 HTTPS。内网 HTTP 限制较少,但仍需客户端在线且端口可达。
不能。浏览器 flags 仅适合开发或受控终端;生产应走 HTTPS + 合规本地网络访问配置。