预览选项
除非另有说明,否则本节中的选项仅适用于预览。
preview.host
- 类型:
string | boolean
- 默认值:
server.host
指定服务器应监听的 IP 地址。 将此设置为 0.0.0.0
或 true
以侦听所有地址,包括 LAN 和公共地址。
可以通过 CLI 使用 --host 0.0.0.0
或 --host
设置此项。
注意
在某些情况下,其他服务器可能会响应而不是 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
。 完整选项此处。
preview.cors
- 类型:
boolean | CorsOptions
- 默认值:
server.cors
为预览服务器配置 CORS。
有关更多详细信息,请参见 server.cors
。
preview.headers
- 类型:
OutgoingHttpHeaders
指定服务器响应头。