VSCode下Node环境配置CA根证书链实现向企业内部HTTPS接口安全拉取数据

风枫姑娘_2441

风枫姑娘_2441

2026-07-18

549人浏览

原创

应将企业ca证书添加到node.js信任链,而非设置node_tls_reject_unauthorized=0;需导出pem格式ca证书、合并系统ca、通过node_extra_ca_certs环境变量注入,并在vscode的settings.json和launch.json中分别配置路径。

vscode下node环境配置ca根证书链实现向企业内部https接口安全拉取数据

Node.js 进程报 “unable to verify the first certificate” 怎么办

这不是 VSCode 的 bug,而是你本地启动的 node 进程(比如调试、终端运行脚本、插件调用 CLI)在企业网络下无法验证 HTTPS 响应证书。根本原因是公司代理做了 SSL Inspection,签发了中间人证书,而 Node.js 默认不信任它。

常见现象包括:axios 请求内网 GitLab 失败、fetch 调用 https://api.internal 报错、npm install 卡在证书校验、VSCode 调试时断点进不去但终端里能跑通——这些都指向同一个根因:Node.js 的 CA 信任链没加载企业根证书。

  • 不要设 NODE_TLS_REJECT_UNAUTHORIZED=0 —— 它会让所有 HTTPS 请求跳过校验,密钥、登录态、API token 全部裸奔
  • 不要只改系统证书库(如 Windows Cert Store 或 macOS Keychain)—— VSCode 启动的 Node.js 进程不自动读取它们
  • 必须显式把企业 CA 加入 Node.js 自身的 CA 池,靠 NODE_EXTRA_CA_CERTS 环境变量注入

如何导出并合并企业 CA 证书为 PEM 格式

IT 部门通常提供的是 .cer 或 .crt 文件,但 Node.js 只认 PEM 格式(Base64 编码、以 -----BEGIN CERTIFICATE----- 开头)。如果直接双击安装到系统,Node.js 仍不可见。

Linux/macOS 下转换命令:

openssl x509 -inform DER -in company-ca.cer -out company-ca.pem

Windows 下可用 PowerShell 手动转(或用在线工具确认格式),关键看文件开头是否为 -----BEGIN CERTIFICATE-----。

  • 若有多张证书(如根 CA + 中间 CA),用 cat ca1.pem ca2.pem > node-ca-bundle.pem 合并成单个 PEM 文件
  • 路径建议放固定位置,比如 /opt/certs/internal-ca.pem(Linux/macOS)或 C:\certs\internal-ca.pem(Windows)
  • 确保该文件对当前用户可读,尤其在 WSL 或远程容器中,路径必须是目标环境能访问的路径(不是 Windows 主机上的 C:\)

VSCode 终端和调试器必须分别配置 NODE_EXTRA_CA_CERTS

NODE_EXTRA_CA_CERTS 是进程级环境变量,VSCode 的集成终端和调试器(launch.json 启动的 Node 进程)是两个独立上下文,彼此不继承环境变量。

Rydberg Agent Node
Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1),免gas,支持macOS/Linux/Windows。触发词:/r

下载

settings.json 中配了只影响终端:

"terminal.integrated.env.linux": {"NODE_EXTRA_CA_CERTS": "/opt/certs/internal-ca.pem"}

但 launch.json 中不加,调试照样失败。每个 configuration 都要显式写进去:

"env": {"NODE_EXTRA_CA_CERTS": "/opt/certs/internal-ca.pem"}
  • WSL 用户注意:路径必须是 Linux 视角,例如 /home/user/certs/internal-ca.pem,不是 C:\Users\xxx\certs\...
  • Remote-SSH 场景下,证书文件必须存在于远程服务器上,且路径与 launch.json 中一致
  • 验证是否生效:在 VSCode 终端运行 node -e "console.log(require('https').globalAgent.options.ca?.length)",输出值应明显大于默认的 ~110

为什么 Remote-SSH 和某些扩展仍报错 net::ERR_CERT_AUTHORITY_INVALID

VSCode 自身(Electron 渲染进程)和部分扩展(如 Tabnine、Remote-SSH 的元数据同步)走的是 Chromium 网络栈,只信任操作系统级证书库,不读 NODE_EXTRA_CA_CERTS。

这类问题不能靠 Node.js 层解决,需补充配置:

  • 在 settings.json 中加:"http.proxyStrictSSL": false —— 仅影响 VSCode 内置 HTTP 客户端(如扩展市场、GitHub 登录)
  • Remote-SSH 若用私有 CA,需在远程主机上把证书导入系统证书库:sudo cp internal-ca.pem /usr/local/share/ca-certificates/ && sudo update-ca-certificates
  • 国产化系统(麒麟、UOS)默认不含内部 CA,必须手动执行上述导入,否则 curl https://gitlab.internal 都失败

最常被忽略的是:证书路径在 launch.json 里写错,或者没同步到远程环境,导致调试时证书加载失败,但终端里 npm install 却正常——这种割裂感容易让人误判问题根源。

相关文章

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

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

下载

相关标签:

vscode node 环境配置

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

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3128

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

4769

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3769

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

446

15

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

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

2023.06.30

1335

18

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

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

2023.07.21

2812

3

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

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

2024.03.14

1949

12

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

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

2024.03.14

1727

8

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

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

2024.03.15

2607

12

热门下载

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

精品课程

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