【Vite插件mkcert详尽安装配置手册】:为Vite的HTTPS开发服务轻松生成证书

【Vite插件mkcert详尽安装配置手册】:为Vite的HTTPS开发服务轻松生成证书

vite-plugin-mkcert Provide certificates for vite's https dev service. vite-plugin-mkcert 项目地址: https://gitcode.com/gh_mirrors/vi/vite-plugin-mkcert

项目基础介绍及主要编程语言

项目名称: vite-plugin-mkcert
开发者: liuweiGL
项目地址: https://github.com/liuweiGL/vite-plugin-mkcert
主要编程语言: TypeScript

本项目提供了一个便捷的解决方案,用于为Vite的HTTPS开发服务器生成所需的SSL证书,帮助开发者解决在本地进行HTTPS开发时遇到的证书问题,确保浏览器不显示证书错误。特别适合希望利用HTTP/2来提升并发性能,以及注重开发环境体验的用户。

关键技术和框架

关键技术:

  • mkcert:这是一个简单的命令行工具,用于创建自签名的X.509证书和私钥,非常适合本地开发。
  • Vite:由Vue.js作者尤雨溪打造的下一代前端构建工具,以其快速的热更新和简洁的配置著称。

集成框架:

  • Vite:作为核心,处理项目的打包和热更新。
  • Node.js:作为运行环境,因为Vite和mkcert都基于Node.js。

安装和配置指南

准备工作

  1. 确保安装Node.js:你需要至少Node.js v14及以上版本。可以访问Node.js官网下载安装。
  2. 环境初始化:打开终端或命令提示符。

第一步:安装vite-plugin-mkcert

  1. 在你的项目根目录下(如果你还没有项目,可以通过npm init初始化一个新项目)。
  2. 使用npm或yarn添加此插件到你的项目开发依赖中:
    npm add vite-plugin-mkcert --save-dev
    
    或者
    yarn add vite-plugin-mkcert -D
    

第二步:配置Vite

对于纯Vite项目,编辑或者创建vite.config.js文件,并加入以下配置:

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

export default defineConfig({
  server: {
    https: true, // 对于Vite 5+,此配置可能不再需要
  },
  plugins: [
    mkcert() // 直接添加插件
  ],
});

如果你使用的是Nuxt.js并且它底层也是使用Vite,配置会稍微不同,确保你有正确的Nuxt版本支持Vite,然后在nuxt.config.js里加入:

import mkcert from 'vite-plugin-mkcert';

export default {
  vite: {
    plugins: [
      mkcert({
        savePath: './certs', // 指定保存证书的位置
        force: true, // 强制重新生成证书,即使没有设置Vite的https属性
      }),
    ],
  },
  devServer: {
    https: {
      cert: './certs/cert.pem',
      key: './certs/key.pem',
    },
  },
};

第三步:生成证书

无需手动执行任何生成命令。当你第一次启动项目(通过npm run devyarn dev),vite-plugin-mkcert将会自动检测并尝试生成必要的证书。如果一切顺利,你会看到证书已成功生成的消息。

注意事项

  • 确保你的防火墙或安全软件不会阻止mkcert的下载或运行。
  • 在iOS或Android设备上使用这些证书时,可能需要额外的步骤来信任自签名的证书。
  • 若遭遇权限问题,请以适当的方式运行命令,例如,在macOS或Linux中使用sudo(但请注意这通常不是必需的,且不是最佳实践)。

现在,你可以安心地在本地环境中使用HTTPS进行开发了,无需担心浏览器的安全警告。

vite-plugin-mkcert Provide certificates for vite's https dev service. vite-plugin-mkcert 项目地址: https://gitcode.com/gh_mirrors/vi/vite-plugin-mkcert

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

苏葵毅Bess

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值