预览选项

除非另有说明，本节选项仅应用于预览。

preview.host

• 类型： string | boolean
• 默认值： server.host

指定服务器应监听的 IP 地址。
将此设置为 0.0.0.0 或 true 以监听所有地址，包括局域网和公共地址。

可以通过 CLI 使用 --host 0.0.0.0 或 --host 进行设置。

::: tip 提示

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

:::

preview.allowedHosts

• 类型： string[] | true
• 默认值： server.allowedHosts

允许 Vite 响应的主机名。

有关更多详细信息，请参阅 server.allowedHosts。

preview.port

• 类型： number
• 默认值： 4173

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

示例：

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

preview.strictPort

• 类型： boolean
• 默认值： server.strictPort

设置为 true 时，如果端口已被占用，则直接退出，而不是自动尝试下一个可用端口。

preview.https

• 类型： https.ServerOptions
• 默认值： server.https

启用 TLS + HTTP/2。

有关更多详细信息，请参阅 server.https。

preview.open

• 类型： boolean | string
• 默认值： server.open

服务器启动时自动在浏览器中打开应用。当值为字符串时，它将用作 URL 的路径名。如果希望在特定的浏览器中打开服务器，可以设置环境变量 process.env.BROWSER（例如 firefox）。还可以设置 process.env.BROWSER_ARGS 来传递额外的参数（例如 --incognito）。

BROWSER 和 BROWSER_ARGS 也是在 .env 文件中可以设置的特殊环境变量，用于配置此项。有关更多详细信息，请参阅 open 包。

preview.proxy

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

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

使用 http-proxy-3。完整选项请参见此处。

preview.cors

• 类型： boolean | CorsOptions
• 默认值： server.cors

为预览服务器配置 CORS。

有关更多详细信息，请参阅 server.cors。

preview.headers

• 类型： OutgoingHttpHeaders

指定服务器响应头。