跳轉到內容

預覽選項

除非另有說明,本節中的選項僅應用於預覽。

preview.host

指定伺服器應監聽的 IP 地址。將其設定為 0.0.0.0true 以監聽所有地址,包括區域網和公共地址。

這可以透過 CLI 使用 --host 0.0.0.0--host 進行設定。

注意

在某些情況下,其他伺服器可能會代替 Vite 響應。詳情請參閱 server.host

preview.allowedHosts

允許 Vite 響應的主機名。

詳情請參閱 server.allowedHosts

preview.port

  • 型別: number
  • 預設值: 4173

指定伺服器埠。請注意,如果該埠已被佔用,Vite 會自動嘗試下一個可用埠,因此這可能不是伺服器最終監聽的實際埠。

示例

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

preview.strictPort

設為 true 時,如果埠已被佔用,則直接退出,而不是自動嘗試下一個可用埠。

preview.https

啟用 TLS + HTTP/2。

詳情請參閱 server.https

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 } 對的物件。如果 key 以 ^ 開頭,它將被解釋為 RegExp。可以使用 configure 選項來訪問代理例項。

使用了 http-proxy-3。完整選項請見此處

preview.cors

  • 型別: boolean | CorsOptions
  • 預設值: server.cors

為預覽伺服器配置 CORS。

詳情請參閱 server.cors

preview.headers

  • 型別: OutgoingHttpHeaders

指定伺服器響應頭。