Workerman 4.0.34 HTTPS 证书配置全解

大明姑娘_2377

大明姑娘_2377

2026-08-07

708人浏览

原创

workerman https启动报err_ssl_protocol_error,主因是未启用tls握手:需确认php已加载openssl扩展,证书为pem格式且local_cert含私钥+域名证书+中间证书三者拼接,ssl_context必须构造时传入而非set设置,verify_peer必须为false。

workerman 4.0.34 https 证书配置全解

Workerman 4.0.34 启动 HTTPS 服务时,浏览器访问直接报 ERR_SSL_PROTOCOL_ERROR,不是证书无效,而是 Workerman 根本没启用 TLS 握手——它在监听 443 端口的同时仍跑着裸 TCP,协议栈压根没加载 SSL 层。

确认 PHP 环境支持 OpenSSL

执行 php -m | grep openssl,输出必须含 openssl。若无输出,需重新编译 PHP 并启用 --with-openssl 参数,或在 Ubuntu 上运行 sudo apt install php-opcache php-curl php-xml php-mbstring php-zip php-gd php-bcmath php-redis(其中 php-opcache 会自动拉入 openssl 依赖)。

这一步跳过会导致后续所有配置成功但服务启动即失败,错误日志里只显示 “failed to listen”,不提 SSL。

准备 PEM 格式证书链

证书必须是 PEM 格式,且 【local_cert 必须包含私钥 + 域名证书 + 中间证书三者按序拼接】。用 Let’s Encrypt 的话,直接取 fullchain.pem(不是 cert.pem),私钥用 privkey.pem。

验证命令:openssl x509 -in fullchain.pem -text -noout | head -10 应看到 “Certificate” 开头;openssl rsa -in privkey.pem -check -noout 返回 “RSA key ok” 才算有效。

别把 PFX 或 DER 文件直接丢进去——Workerman 会静默报错 failed to load certificate,连启动都卡住。

Workerman 4.0.34 正确配置 ssl_context

使用 Workerman\Protocols\Http\WebServer 类启动 HTTPS 服务,【ssl_context 必须作为构造参数传入,不能靠 set 方法后期补】。

方法一:完整数组写法(推荐)

第一步:$context = ['ssl' => ['local_cert' => '/var/www/myapp/certs/fullchain.pem', 'local_pk' => '/var/www/myapp/certs/privkey.pem', 'verify_peer' => false]];

第二步:$web = new WebServer('ssl://0.0.0.0:443', $context);

ChatCut
ChatCut

一款AI视频创作工具,主要用于AI视频剪辑工具,适合需要提升相关任务效率的用户。

下载

第三步:$web->onMessage = function ($connection, $request) { $connection->send('<h1>HTTPS OK</h1>'); };

注意:路径必须是绝对路径,__DIR__ . '/certs/fullchain.pem' 可防工作目录变化导致文件找不到;verify_peer => false 是强制项,设为 true 会导致小程序或浏览器握手失败。

方法二:单行路径写法(仅限开发测试)

$web = new WebServer('ssl://0.0.0.0:443/fullchain.pem:/privkey.pem');

该写法省略数组,但要求两个文件在同一目录、权限一致、且不能加密码;生产环境禁用,因无法设置 verify_peer,上线后会因校验失败断连。

绕过 Nginx 直连 Workerman 的关键检查项

若你坚持让 Workerman 自己扛 HTTPS(而非用 Nginx 反代),请逐项核对:

确保防火墙放行目标端口(如 443 或 8443),sudo ufw status 查看规则,sudo ufw allow 443 补开;

域名必须已备案且解析到服务器公网 IP,dig your-domain.com +short 输出应为真实 IP;

PHP 进程用户(如 www-data)对证书文件有读权限:sudo chown www-data:www-data /var/www/myapp/certs/*.pem && sudo chmod 600 /var/www/myapp/certs/*.pem;

【不要同时开启 Nginx SSL 和 Workerman SSL】,否则 wss 连接会因双重加密 handshake failure 而重置。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

10304

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6081

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2095

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3828

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4534

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3551

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5057

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3962

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11922

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

ThinkPHP5.1完全开发手册
ThinkPHP5.1完全开发手册

共0课时 | 0人学习