VSCode下Node环境SSL本地自签名配置

云辰大大_2815

云辰大大_2815

2026-09-15

381人浏览

原创

node.js 启动 https 服务报 enoent 是因路径错误或权限问题,需用绝对路径或正确相对路径;证书无效显示 net::err_cert_authority_invalid 属自签名正常现象,应导入根证书而非禁用校验;客户端请求失败需局部关闭校验;代理到 https 后端须设 secure: false;证书链不完整时应分两步生成 ca 和域名证书。

vscode下node环境ssl本地自签名配置

Node.js 启动 HTTPS 服务时报 ENOENT 找不到证书文件

根本不是 VSCode 的问题,而是 Node.js 进程读取路径失败。常见于相对路径写错、工作目录不一致、或证书文件权限不足。

  • https.createServer() 中传入的 keycert 路径必须是绝对路径,或相对于当前工作目录(即你运行 node app.js 时所在的目录),不是相对于 app.js 文件所在目录
  • 验证路径是否有效:在代码开头加 console.log(require('fs').existsSync('/path/to/cert.pem')),输出 false 就说明路径错了
  • Mac/Linux 下注意权限:如果证书放在 ~/Downloads/,Node.js 可能因波浪线未展开而找不到——改用 require('os').homedir() 拼接,或直接用绝对路径如 /Users/xxx/ssl/cert.pem
  • Windows 路径分隔符别混用:C:sslcert.pem 在字符串里要写成 C:\ssl\cert.pem 或使用正斜杠 C:/ssl/cert.pem

浏览器访问 https://localhost:3000 显示 NET::ERR_CERT_AUTHORITY_INVALID

这是自签名证书的必然行为,不是配置失败,但绕过方式有明确优先级和风险差异。

jinn-node
jinn-node

在Jinn网络为自主项目工作赚取代币奖励,让闲置的OpenClaw代理开始工作。

下载
  • 最安全做法:把根证书(rootCA.pem)导入系统钥匙串(macOS)或受信任的根证书颁发机构(Windows),再重启浏览器——这样所有子域名证书都自动信任
  • 临时调试可手动点击「高级 → 继续前往 localhost(不安全)」,但每次重启服务或清缓存后需重点,且 Chrome 120+ 已限制该入口频次
  • 别信「在 VSCode 设置里关掉 http.proxyStrictSSL」——这仅影响 VSCode 自身 HTTP 客户端(如扩展市场),不影响你跑的 Node.js 服务被浏览器访问

Node.js 脚本调用 HTTPS 接口报 SELF_SIGNED_CERT_IN_CHAIN

错误来自你代码里发起请求的模块(https.requestaxiosfetch),不是服务器端证书问题,而是客户端校验失败。

  • 开发阶段最快验证:在脚本最顶部加 process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';(必须在 require('https') 之前)
  • 局部控制更稳妥:用 axios 时传 httpsAgent: new https.Agent({ rejectUnauthorized: false });用 node-fetch@3+ 时传 { dispatcher: new Agent({ rejectUnauthorized: false }) }
  • 生产环境禁用此选项——它跳过证书链验证,但 TLS 加密仍生效,仅失去身份认证能力,敏感数据场景下等同裸奔
  • 企业内网推荐方案:设环境变量 NODE_EXTRA_CA_CERTS=/path/to/internal-ca.pem,让 Node.js 主动加载私有 CA,比全局关校验更可控

Vite/webpack dev server 代理到本地 HTTPS 后端失败

代理本身默认启用证书校验,遇到自签名后端会直接中断连接,错误常表现为 504 Gateway Timeout 或空响应。

  • Vite 中配置 server.proxy['/api'] 时,必须显式加 secure: false,否则代理层拒绝转发
  • Webpack Dev Server 同理,在 devServer.proxy 对象里加 secure: false,否则底层 http-proxy-middleware 默认校验目标证书
  • 注意:这个 secure: false 是代理客户端的行为,和你的前端页面是否走 HTTPS 无关,也不影响浏览器对前端自身的证书校验
  • 若代理目标是 https://dev.example.com:8080,确保 hosts 文件已映射该域名到 127.0.0.1,否则 DNS 解析失败会掩盖真实证书问题
真正容易被忽略的是证书链完整性:生成自签名证书时,如果只用 openssl req -x509 一步生成,它本质是自签的「终端实体证书」,没有中间 CA 层;但某些工具(如 Chrome 110+)对单级自签名证书的信任提示更隐蔽,甚至不显示「添加为信任」入口——此时必须用两步法:先建 rootCA.pem,再用它签发域名证书,才能稳定触发系统级信任导入流程。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode node ssl

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1155

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2292

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1789

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1587

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2487

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1778

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1202

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1076

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

414

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程