1. 为什么本地开发需要 HTTPS 环境
作为一名长期奋战在开发一线的工程师,我深刻体会到本地HTTPS环境的重要性。很多开发者习惯在本地使用HTTP协议进行开发测试,等到部署到生产环境时才切换到HTTPS,这种做法往往会带来一系列问题。
最典型的场景是前端调用后端API时,如果开发环境使用HTTP而生产环境使用HTTPS,可能会遇到混合内容警告(Mixed Content Warning)甚至功能异常。现代浏览器对安全性的要求越来越高,很多Web API(如地理位置、摄像头等)都要求必须在HTTPS环境下才能使用。
我在去年开发一个PWA应用时就踩过这个坑。本地测试时一切正常,部署到线上后却发现部分功能失效,排查了半天才发现是因为某些API在HTTP环境下被浏览器直接拦截了。从那以后,我就养成了在本地开发阶段就配置HTTPS环境的习惯。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 准备工作与环境搭建
2.1 OpenSSL 安装与配置
OpenSSL是生成和管理SSL/TLS证书的事实标准工具。在Windows环境下安装OpenSSL需要注意几个关键点:
首先,建议从官方推荐的Win32 OpenSSL页面下载安装包。这里有个小技巧:如果你的系统是64位的,建议选择"Win64"版本,但要注意查看是否有"Light"版本(只包含必要组件)和完整版本的区别。
安装过程中有几个关键选项需要注意:
- 安装位置建议保持默认(通常是
C:\Program Files\OpenSSL-Win64) - 一定要勾选"Copy OpenSSL DLLs to"相关选项
- 建议选择"The Windows system directory"选项
安装完成后,需要将OpenSSL的bin目录添加到系统PATH环境变量中。具体路径取决于你的安装位置,通常是:
code复制C:\Program Files\OpenSSL-Win64\bin
验证安装是否成功,可以打开命令提示符输入:
bash复制openssl version
如果显示版本信息(如"OpenSSL 3.0.7"),说明安装配置成功。
2.2 Nginx 环境准备
对于Nginx环境,我推荐几种常见的搭建方式:
-
独立安装Nginx:
- 从官网下载Windows版Nginx
- 解压到任意目录(建议路径简单,如
C:\nginx) - 通过
nginx.exe启动服务
-
使用集成环境(推荐):
- PHPStudy(适合PHP开发者)
- WampServer(适合全栈开发者)
- Laragon(适合现代化开发)
我个人更倾向于使用PHPStudy,因为它提供了可视化管理界面,可以方便地切换不同版本的PHP、Nginx/Apache等组件。安装后,Nginx的配置文件通常位于:
code复制D:\phpstudy_pro\Extensions\Nginx1.15.11\conf\nginx.conf
或者针对特定站点的配置在:
code复制D:\phpstudy_pro\Extensions\Nginx1.15.11\conf\vhosts\
3. SSL证书生成全流程
3.1 生成私钥和证书
打开命令提示符(建议以管理员身份运行),切换到你想保存证书的目录。我通常会在Nginx的conf目录下创建ssl子目录来存放证书文件:
bash复制cd D:\phpstudy_pro\Extension
