# 预览选项

# preview.host

为开发服务器指定 ip 地址。 设置为 0.0.0.0true会监听所有地址,包括局域网和公共地址。

还可以通过 CLI 进行设置,使用 --host 0.0.0.0--host

注意

在某些情况下,可能响应的是其他服务器而不是 Vite。 查看 server.host 了解更多细节。

# preview.port

  • 类型:number
  • 默认:4173

指定开发服务器端口。注意,如果设置的端口已被使用,Vite 将自动尝试下一个可用端口,所以这可能不是最终监听的服务器端口。

示例:

export default defineConfig({
  server: {
    port: 3030,
  },
  preview: {
    port: 8080,
  },
})

# preview.strictPort

设置为 true时,如果端口已被使用,则直接退出,而不会再进行后续端口的尝试。

# preview.https

启用 TLS + HTTP/2。注意,只有在与 server.proxy 选项 同时使用时,才会降级为 TLS。

该值也可以传递给 https.createServer()options 对象

# preview.open

开发服务器启动时,自动在浏览器中打开应用程序。当该值为字符串时,它将被用作 URL 的路径名。如果你想在你喜欢的某个浏览器打开该开发服务器,你可以设置环境变量 process.env.BROWSER(例如 firefox)。欲了解更多细节,请参阅 open 包的源码

BROWSERBROWSER_ARGS是两个特殊的环境变量,你可以在 .env文件中设置它们用以配置本选项。查看 open 这个包 了解更多详情。

# preview.proxy

为开发服务器配置自定义代理规则。其值的结构为 { key: options }的对象。如果 key 以 ^开头,它将被识别为 RegExp,其中 configure选项可用于访问代理实例。

基于 http-proxy 实现,完整的参数列表参见 此链接

# preview.cors

为开发服务器配置 CORS。此功能默认启用并支持任何来源。可传递一个 options 对象 来进行配置,或者传递 false来禁用此行为。

# preview.headers

  • 类型:OutgoingHttpHeaders

指明服务器返回的响应头。

Last Updated: 6/17/2023, 6:57:19 PM