跳至內容

預覽選項

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

preview.host

指定伺服器應監聽的 IP 位址。設定為 0.0.0.0true 以監聽所有位址,包括 LAN 和公開位址。

這可以使用 CLI 命令 --host 0.0.0.0--host 來設定。

注意

在某些情況下,其他伺服器可能會回應而不是 Vite。請參閱 server.host 了解更多詳細資訊。

preview.port

  • 類型: number
  • 預設值: 4173

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

範例

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

preview.strictPort

設定為 true,如果埠號已被使用,則退出,而不是自動嘗試下一個可用的埠號。

preview.https

啟用 TLS + HTTP/2。請注意,當同時使用 server.proxy 選項時,會降級為僅使用 TLS。

該值也可以是傳遞給 https.createServer()選項物件

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。完整選項請見 此處

preview.cors

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

為預覽伺服器設定 CORS。預設情況下啟用此功能,並允許任何來源。傳遞一個 選項物件以微調行為或 false 以停用。

preview.headers

  • 類型: OutgoingHttpHeaders

指定伺服器回應標頭。

根據 MIT 許可發布。(ccee3d7c)