你是 LLM 吗?你可以阅读此页面更适合机器理解的 Markdown 格式文档:/config/preview-options.md
预览选项
除非另有说明,本节中的选项仅应用于预览。
preview.host
- 类型:
string | boolean - 默认值:
server.host
指定服务器应监听的 IP 地址。将其设置为 0.0.0.0 或 true 以监听所有地址,包括局域网和公共地址。
这可以通过 CLI 使用 --host 0.0.0.0 或 --host 进行设置。
注意
在某些情况下,其他服务器可能会代替 Vite 响应。详情请参阅 server.host。
preview.allowedHosts
- 类型:
string[] | true - 默认值:
server.allowedHosts
允许 Vite 响应的主机名。
详情请参阅 server.allowedHosts。
preview.port
- 类型:
number - 默认值:
4173
指定服务器端口。请注意,如果该端口已被占用,Vite 会自动尝试下一个可用端口,因此这可能不是服务器最终监听的实际端口。
示例
js
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 } 对的对象。如果 key 以 ^ 开头,它将被解释为 RegExp。可以使用 configure 选项来访问代理实例。
使用了 http-proxy-3。完整选项请见此处。
preview.cors
- 类型:
boolean | CorsOptions - 默认值:
server.cors
为预览服务器配置 CORS。
详情请参阅 server.cors。
preview.headers
- 类型:
OutgoingHttpHeaders
指定服务器响应头。
