本地打印成功,上线后无法打印?

你可能遇到的报错

浏览器 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:// 正常打开业务页(地址栏有锁、无证书错误)后,首次打印时请在弹窗中选择允许访问本地网络。

场景 A:公网域名(Let's Encrypt)

有公网 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

场景 B:内网 / 仅 IP(自签或企业 CA)

内网 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 为 true
  • 客户端已启动,首次打印时在浏览器弹窗点「允许」本地网络
  • 仍失败时再查防火墙或改用方案二

常见问题

为什么开发环境能打印,上线 HTTPS 后 WebSocket 连 127.0.0.1:16794 失败?

多为 Chrome Local Network Access 限制:公网 HTTPS 页面默认不能随意访问本机回环地址。需配置受信证书并按文档放开本地网络访问,或仅在受控环境用 flags 临时验证。

ws://127.0.0.1:16794/websocket/standard failed 怎么处理?

确认本机已安装并启动 Web打印专家客户端;检查防火墙是否放行 16794;公网 HTTPS 站点优先用 Nginx + 证书,详见本排障页。

是否必须用 HTTPS 才能在生产环境静默打印?

面向公网用户强烈建议 HTTPS。内网 HTTP 限制较少,但仍需客户端在线且端口可达。

flags 方案能用于正式用户吗?

不能。浏览器 flags 仅适合开发或受控终端;生产应走 HTTPS + 合规本地网络访问配置。