简介
现在是大前端的时代,我们在本地开发 React 项目非常方便。这不是本文的重点,今天要分享一个话题是,如何为这些本地的项目,添加 https
的支持。为什么要考虑这个问题呢?主要有几个原因
- 如果该项目需要调用下层的 API, 并且该 API 是用
https
的,则要求前端项目也用https
- 如果你为
Teams
或者Office
开发应用,他们要求这些应用必须用https
本文参考了官方文档 https://create-react-app.dev/docs/using-https-in-development/,并且用更加详细的步骤带领大家完成实验。
创建并React项目
npx create-react-app --template typescript testapp cd testapp npm start
我们会看到再熟悉不过的默认的React项目的那个模板效果,默认在 http://localhost:3000
这个地址访问
如果你想启用 https
,其实有一个简单的办法就是用 ($env:HTTPS = "true") -and (npm start)
替换上面的那句 npm start
即可
请注意,你现在已经可以用 https://localhost:3000
去访问它了。但很显然这个证书是无效的。下面就继续来学习如何创建自定义证书并且用它来绑定到我们的应用端口上来。
安装自签名证书工具
推荐使用 mkcert
,我一般会用 choco
这个工具来安装,请参考我的步骤
# 请在管理员模式下打开Powershell Set-ExecutionPolicy Bypass -Scope Process -Force; ` [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;` iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) choco install mkcert -y
安装证书信任机构(CA)
mkcert -install
创建证书
# 创建一个用来保存证书文件的目录 mkdir -p .cert # 可以一次性为多个域名创建证书,这个非常强大 mkcert -key-file ./.cert/key.pem -cert-file ./.cert/cert.pem "localhost" "dev.teamsapp.local"
使用证书来启动当前项目
在当前项目根目录下面创建一个 .env 文件,填写如下的内容
HTTPS=true SSL_CRT_FILE=.cert/cert.pem SSL_KEY_FILE=.cert/key.pem
然后,直接还是运行 npm start
,你会发现默认打开的 https://localhost:3000
已经带有合法的证书了