VSCode中Node环境配置HTTPS本地域名解析与自签名证书双向绑定-VSCode-PHP中文网

vscode不处理https证书和域名解析，关键在node进程、系统hosts及证书cn三者严格匹配：cn须与访问域名完全一致，hosts需映射域名到127.0.0.1，证书须utf-8无bom编码且路径正确。

vscode中node环境配置https本地域名解析与自签名证书双向绑定

VSCode 本身不参与 HTTPS 证书加载或域名解析，真正起作用的是你运行的 Node.js 进程（比如 Express、Vite 或原生 https 模块）和操作系统级的 hosts 配置。所谓“双向绑定”，其实是三个独立环节的协同：Node 服务读取证书文件、浏览器信任该证书（或手动忽略警告）、系统将自定义域名映射到 127.0.0.1。漏掉任一环，都会表现为“证书无效”“NET::ERR_CERT_COMMON_NAME_INVALID”或“无法访问域名”。

生成 server.key 和 server.crt 时 CommonName 必须匹配你要访问的域名

这是最常被跳过的一步。OpenSSL 在生成 server.csr 时会交互式询问 CommonName（CN），它不是随便填的——必须和你在浏览器里输入的域名完全一致，包括端口无关的主机名部分。

如果你打算用 https://myapp.local:3000 访问，这里就填 myapp.local
如果填了 localhost，那只能用 https://localhost:3000，myapp.local 会触发 ERR_CERT_COMMON_NAME_INVALID
不支持通配符（如 *.local）用于自签名证书，除非你用 mkcert 工具生成
生成命令中不要省略 -days 365，否则默认只有 30 天，过期后 Node 启动不报错，但浏览器直接拦截

正确流程示例：

openssl genrsa -out server.key 2048
openssl req -new -key server.key -out server.csr -subj "/C=CN/ST=Beijing/L=Beijing/O=Dev/CN=myapp.local"
openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt

VSCode 中启动 Node HTTPS 服务前，必须确保 key/crt 文件路径可读且编码为 UTF-8（无 BOM）

Windows 下用 OpenSSL 生成的 .key 文件默认可能是 ANSI 或 UTF-8 with BOM 编码，Node 的 fs.readFileSync() 读出来会变成乱码，导致 error:0909006C:PEM routines:get_name:no start line。

Rydberg Agent Node

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

下载

用 VSCode 或 Sublime Text 打开 server.key，右下角查看当前编码，如果不是 UTF-8，点击切换并保存
确认保存时未勾选 “BOM”（即 UTF-8 without BOM）
在 Node 代码里用 fs.readFileSync('./server.key', 'utf8') 显式指定编码，比默认二进制读取更安全
路径必须是相对当前 server.js 所在目录的正确路径；VSCode 调试时工作目录默认是打开的文件夹根目录，不是 .vscode/ 下

让 myapp.local 解析到 127.0.0.1 需手动改系统 hosts，且不能依赖 VSCode

VSCode 不修改系统 DNS 或 hosts。你必须自己编辑操作系统的 hosts 文件，添加一行映射：

127.0.0.1 myapp.local

macOS / Linux：编辑 /etc/hosts，需 sudo
Windows：编辑 C:\Windows\System32\drivers\etc\hosts，需管理员权限启动记事本
改完后无需重启，但建议执行 ping myapp.local 确认是否返回 127.0.0.1
浏览器缓存 DNS，若之前访问失败过，可尝试无痕窗口或清空 DNS 缓存（sudo dscacheutil -flushcache macOS / ipconfig /flushdns Windows）

浏览器对自签名证书的警告无法绕过，但可临时信任（仅限开发）

Chrome、Edge、Safari 默认不信任自签名证书，即使域名和证书 CN 匹配，也会显示全屏警告页。这不是 Node 或 VSCode 的问题，是浏览器策略。

Chrome：在警告页输入 thisisunsafe（不显示、不提示，敲完回车即可跳过）
Firefox：点击“高级”→“接受风险并继续”
更彻底方案：用 mkcert 生成由本地 CA 签发的证书，并把 CA 根证书导入系统钥匙串（macOS）或受信任根证书存储（Windows），这样浏览器就真“信任”了
注意：mkcert 生成的证书仍需配合 hosts 修改和 Node 正确加载，三者缺一不可

真正容易被忽略的点是：证书 CN、hosts 条目、浏览器地址栏输入的域名，这三个字符串必须逐字节一致（大小写、点号、有无 www 前缀）。差一个点，整个 HTTPS 握手就失败。