你是 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
指定伺服器響應頭。
