讲师中心 微信公众号
AI工具推荐 视频效率加速

HTTPS网站怎么连接WS?Workerman配置WSS无证书报错解决

梦萱吖_1661

梦萱吖_1661

发布时间:2026-05-26 22:10:00

|

1059人浏览过

|

来源于php中文网

原创

小程序连不上Workerman的wss服务,主因是SSL证书未正确配置、端口未暴露或反向代理未透传Upgrade头;需用ssl://协议启动、PEM格式完整证书链、绝对路径引用,并确保域名备案、HTTPS有效、端口公网可达。

https网站怎么连接ws?workerman配置wss无证书报错解决

HTTPS网站不能直接用 ws:// 连 Workerman,必须走 wss://;而 Workerman 自己不处理 TLS 握手,所谓“无证书启动 WSS”本身就是矛盾的——要么配好证书让 Workerman 直启 ssl://,要么用 Nginx 做 TLS 终结、Workerman 只跑明文 ws://。硬要跳过证书,只会触发 SSL routines::wrong version number 或 net::ERR_SSL_PROTOCOL_ERROR。

Workerman 启动 ssl:// 时证书路径和参数怎么填才不报错

Workerman 的 ssl://0.0.0.0:8443 协议要求你显式传入 ssl_context,漏掉或写错任意一项都会在 stream_socket_server 阶段直接失败。

  • local_cert 必须是完整链 PEM 文件(fullchain.pem),不是 cert.pem;路径必须绝对,推荐写成 __DIR__ . '/certs/fullchain.pem'
  • local_pk 指向私钥 privkey.pem,同样需绝对路径
  • 开发环境加 'verify_peer' => false,否则 PHP OpenSSL 会校验 SNI 域名,而本地调试域名(如 localhost)必然不匹配
  • 别混用 Swoole 的 SSL 参数名(如 ssl_cert_file),Workerman 只认标准 OpenSSL 上下文键名

Nginx 反代 wss 到 Workerman 时 Upgrade 头为什么总被丢

Nginx 默认把 WebSocket 当普通 HTTP 处理,Upgrade 和 Connection 头根本不会透传,导致握手卡在 connecting 状态,几秒后报 fail net::ERR_CONNECTION_REFUSED。

  • 必须显式设置 proxy_set_header Upgrade $http_upgrade 和 proxy_set_header Connection "upgrade"
  • proxy_http_version 1.1 缺一不可,HTTP/1.0 不支持 Upgrade 机制
  • 禁用缓存:proxy_buffering off 和 proxy_cache off,否则响应体可能被截断
  • 别在 location 块里写 rewrite 或 return,它们会中断 upgrade 流程

小程序连 wss:// 报 ERR_CONNECTION_REFUSED 的真实原因

这个错误几乎从不来自 PHP 代码,而是网络层彻底不通:端口没开、域名没解析、或服务根本没监听到公网 IP。

  • Workerman 必须监听 0.0.0.0:2346,不能只写 127.0.0.1:2346——后者只允许本机访问
  • 云服务器安全组 + 系统防火墙(如 firewall-cmd)都要放行目标端口(如 8443 或反代用的 443)
  • 小程序真机调试走外网,localhost、127.0.0.1、内网 IP 全无效,必须用已备案的域名
  • 用手机浏览器直访 wss://your-domain.com(可用 websocket.org 测试页),连不上就说明服务没暴露成功

最易被忽略的是证书链完整性:Let’s Encrypt 的 fullchain.pem 必须包含 root + intermediate + domain cert 三段,少一段,微信客户端就直接中断连接,连握手包都收不到。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5530

2024.08.16

Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

226

2026.05.20

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

222

2026.05.20

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

227

2026.05.20

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

0

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

0

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

20

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

20

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
零基础精通 PS 视频教程
零基础精通 PS 视频教程

共268课时 | 120.6万人学习

前端工程师必备技能—PS切图
前端工程师必备技能—PS切图

共11课时 | 2.2万人学习

麦子学院Photoshop切片视频教程
麦子学院Photoshop切片视频教程

共13课时 | 4.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn