預覽選項
除非另有說明,本節中的選項僅適用於預覽。
preview.host
- 類型:
string | boolean
- 預設值:
server.host
指定伺服器應監聽的 IP 位址。設定為 0.0.0.0
或 true
以監聽所有位址,包括 LAN 和公開位址。
這可以使用 CLI 命令 --host 0.0.0.0
或 --host
來設定。
注意
在某些情況下,其他伺服器可能會回應而不是 Vite。請參閱 server.host
了解更多詳細資訊。
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.proxy
選項時,會降級為僅使用 TLS。
該值也可以是傳遞給 https.createServer()
的 選項物件。
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
。完整選項請見 此處。
preview.cors
- 類型:
boolean | CorsOptions
- 預設值:
server.cors
為預覽伺服器設定 CORS。預設情況下啟用此功能,並允許任何來源。傳遞一個 選項物件以微調行為或 false
以停用。
preview.headers
- 類型:
OutgoingHttpHeaders
指定伺服器回應標頭。