https

  • 类型: import('https').ServerOptions
  • 默认值: undefined

配置该选项后,可以开启 Rsbuild Server 对 HTTPS 的支持,同时会禁用 HTTP 服务器。

开启前:

> Local:    http://localhost:8080/
  > Network:  http://192.168.0.1:8080/

开启后:

> Local:    https://localhost:8080/
  > Network:  https://192.168.0.1:8080/

设置证书

你可以在 server.https 选项中手动传入 HTTPS 服务器所需要的证书和对应的私钥,这个参数将直接传递给 Node.js 中 https 模块的 createServer 方法。

具体可以参考 https.createServer

import fs from 'node:fs';

export default {
  server: {
    https: {
      key: fs.readFileSync('certificates/private.pem'),
      cert: fs.readFileSync('certificates/public.pem'),
    },
  },
};
TIP

本地开发所使用的证书通常使用 mkcert 生成,请阅读 "如何使用 HTTPS 进行本地开发" 来了解如何使用。