中文文档

vite-plugin-mkcert

使用 mkcert 为 vite https 开发服务提供证书支持。

何时使用此插件

1. 当你希望使用 http/2 来解决 vite http 开发服务器请求的并发限制时，发现浏览器缓存无效 #2725。
2. 我有强迫症，希望浏览器不要显示烦人的 https 证书错误。

效果

查看

快速开始

要求

• Node.js >= 22.19.0

1. 安装依赖

yarn add vite-plugin-mkcert -D

2. 配置 vite

import {defineConfig} from 'vite'
import mkcert from 'vite-plugin-mkcert'

// https://vitejs.dev/config/
export default defineConfig({
  server: {
    https: true
  }, // Not needed for Vite 5+ (simply omit this option)
  plugins: [mkcert()]
})

参数

hosts

自定义 hosts，默认值为 localhost + local ip addrs。

force

是否强制生成。

autoUpgrade

是否自动升级 mkcert。

source

指定 mkcert 的下载源，国内用户可将其设置为 coding 以从 coding.net 镜像下载，或提供自定义 BaseSource。

mkcertPath

如果网络受限，可以指定本地的 mkcert 文件，而不是从网络下载。

proxy

下载 mkcert 二进制文件时使用的代理 URL。

示例：http://127.0.0.1:7890

如果未提供，将回退到环境变量：HTTPS_PROXY、https_proxy、HTTP_PROXY、http_proxy。

savePath

保存文件的位置，例如下载的 mkcert 程序以及生成的 CA 文件、私钥和证书文件等。默认值为 PLUGIN_DATA_DIR

keyFileName

mkcert 生成的私钥文件名

certFileName

mkcert 生成的证书文件名

移动设备

若要在移动设备上信任这些证书，必须安装根 CA。它是 mkcert -CAROOT 打印出的文件夹中的 rootCA.pem 文件。

在 iOS 上，你可以使用 AirDrop、将 CA 通过电子邮件发送给自己，或从 HTTP 服务器提供它。打开后，你需要在“设置 > 已下载描述文件”中安装该描述文件，然后启用完全信任。

对于 Android，你必须安装 CA，然后在应用的开发构建中启用用户根证书。参见此 StackOverflow 回答。

显示插件的调试信息

设置环境变量 DEBUG=vite:plugin:mkcert

CHANGELOG

CHANGELOG

原理

使用 mkcert 安装本地 CA 证书，并为其生成 server.https 服务器证书。

温馨提示

1. 卸载 CA 证书：mkcert -uninstall

致谢

• mkcert
• daquinoaldo/https-localhost