跳至内容

预览选项

preview.host

指定服务器应该监听的 IP 地址。将其设置为 0.0.0.0true 以监听所有地址,包括 LAN 和公共地址。

这可以通过 CLI 使用 --host 0.0.0.0--host 设置。

注意

在某些情况下,其他服务器可能会响应而不是 Vite。有关更多详细信息,请参阅 server.host

preview.port

  • 类型: number
  • 默认: 4173

指定服务器端口。请注意,如果端口已被使用,Vite 将自动尝试下一个可用端口,因此这可能不是服务器最终监听的实际端口。

示例

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

preview.strictPort

设置为 true 以在端口已被使用时退出,而不是自动尝试下一个可用端口。

preview.https

  • 类型: boolean | https.ServerOptions
  • 默认: server.https

启用 TLS + HTTP/2。请注意,当 server.proxy 选项 也被使用时,这将降级为仅 TLS。

该值也可以是传递给 https.createServer()选项对象

preview.open

在服务器启动时自动在浏览器中打开应用程序。当该值为字符串时,它将用作 URL 的路径名。如果您想在您喜欢的特定浏览器中打开服务器,您可以设置环境 process.env.BROWSER(例如 firefox)。您还可以设置 process.env.BROWSER_ARGS 以传递其他参数(例如 --incognito)。

BROWSERBROWSER_ARGS 也是您可以在 .env 文件中设置的特殊环境变量,以对其进行配置。有关更多详细信息,请参阅 open

preview.proxy

  • 类型: Record<string, string | ProxyOptions>
  • 默认: server.proxy

为预览服务器配置自定义代理规则。期望 { key: options } 对的对象。如果键以 ^ 开头,它将被解释为 RegExpconfigure 选项可用于访问代理实例。

使用 http-proxy。完整选项 在此

preview.cors

为预览服务器配置 CORS。默认情况下启用此功能,并允许任何来源。传递一个 选项对象 以微调行为或 false 以禁用。

preview.headers

  • 类型: OutgoingHttpHeaders

指定服务器响应头。