如何为开发环境创建自签名的SSL证书？

在开发环境中使用自签SSL证书的关键步骤如下：1. 安装OpenSSL工具，可通过brew、apt或官方下载安装；2. 使用openssl命令生成私钥和证书文件，包含-x509、rsa:4096、-keyout、-out等参数配置；3. 在Node.js、Nginx或Apache中分别配置证书路径及服务监听；4. 解决浏览器信任问题，通过钥匙串访问或管理证书工具将证书加入受信任根证书颁发机构。整个过程旨在创建本地HTTPS测试环境并避免安全警告，同时确保开发效率。

在开发环境中使用自签 SSL 证书，主要是为了模拟 HTTPS 的运行环境，同时避免浏览器的安全警告。虽然它没有经过权威机构认证，但在本地测试中非常实用。下面是一些关键步骤和注意事项。

准备工作：安装 OpenSSL 工具

大多数系统默认已经安装了 OpenSSL，但最好先确认一下。打开终端输入：

openssl version

如果没有显示版本号，可以按照以下方式安装：

• macOS（使用 Homebrew）：

  brew install openssl

• Ubuntu/Debian：

  sudo apt update && sudo apt install openssl

• Windows：可以下载并安装 OpenSSL 官方提供的版本 或通过 WSL 使用 Linux 版本。

安装完成后，就可以开始生成证书了。

生成私钥和证书的命令流程

你可以用一条命令快速生成一个包含私钥和证书的 PEM 文件：

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -sha256 -days 365 -nodes

这条命令的意思是：

• -x509：表示这是一个自签名证书
• -newkey rsa:4096：生成一个 4096 位的 RSA 私钥
• -keyout key.pem：将私钥保存为 key.pem
• -out cert.pem：将证书保存为 cert.pem
• -sha256：使用 SHA-256 算法签名
• -days 365：证书有效期为一年
• -nodes：不加密私钥（方便开发时使用）

执行后会提示你填写一些信息，比如国家、组织名等，可以随便填或者留空（按回车跳过）。最后你会得到两个文件：key.pem 和 cert.pem。

在开发服务器中配置证书

不同的开发环境配置方式略有不同，以下是几个常见场景的参考：

• Node.js Express 应用：

  const fs = require('fs');
  const https = require('https');
  const express = require('express');
  
  const app = express();
  
  const options = {
    key: fs.readFileSync('key.pem'),
    cert: fs.readFileSync('cert.pem')
  };
  
  https.createServer(options, app).listen(443);

• Nginx 配置：

  server {
      listen 443 ssl;
      server_name localhost;
  
      ssl_certificate /path/to/cert.pem;
      ssl_certificate_key /path/to/key.pem;
  
      ssl_protocols TLSv1.2 TLSv1.3;
      ssl_ciphers HIGH:!aNULL:!MD5;
  
      location / {
          proxy_pass http://localhost:3000;
      }
  }

• Apache 配置： 启用 SSL 模块后，在虚拟主机配置中添加：

  <VirtualHost *:443>
      SSLEngine on
      SSLCertificateFile "/path/to/cert.pem"
      SSLCertificateKeyFile "/path/to/key.pem"
  </VirtualHost>

  别忘了重启服务或重新加载配置使更改生效。

  浏览器信任问题及解决方法

  由于是自签名证书，浏览器会显示“不安全”警告。你可以手动将其加入受信任的根证书来绕过这个问题。

  Chrome/Firefox（Mac）：

  1. 打开钥匙串访问（Keychain Access）
  2. 选择“系统”钥匙串
  3. 点击“文件 > 添加证书”
  4. 选择你的 cert.pem 文件
  5. 双击新添加的证书，展开“信任”，选择始终信任

  Edge/Chrome（Windows）：

  1. 打开“管理证书”（可以在运行中输入 certmgr.msc）
  2. 在“受信任的根证书颁发机构”中导入你的证书
  3. 按照向导完成导入

  这样之后，访问本地 HTTPS 地址就不会再出现安全警告了。

  ---

  基本上就这些操作。虽然过程看起来有点多，但其实每一步都很直接。关键是记住生成证书时要加上 -nodes 参数，不然每次启动服务都得输密码，反而影响效率。

  以上是如何为开发环境创建自签名的SSL证书？的详细内容。更多信息请关注PHP中文网其他相关文章！