Параметры сервера предварительного просмотра
Если не указано иное, параметры, описанные в этом разделе, применяются только для режима предварительного просмотра.
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. Обратите внимание, что это понижается только до TLS, когда также используется опция server.proxy
.
Значение также может быть объектом options
, переданным в 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 }
. Если ключ начинается с ^
, он будет интерпретироваться как RegExp
. Опция configure
может быть использована для доступа к экземпляру прокси.
Использует http-proxy
. Полные опции здесь.
preview.cors
- Тип:
boolean | CorsOptions
- По умолчанию:
server.cors
Настройте CORS для сервера предварительного просмотра. Это включено по умолчанию и позволяет любые источники. Передайте объект опций, чтобы настроить поведение, или false
, чтобы отключить.
preview.headers
- Тип:
OutgoingHttpHeaders
Укажите заголовки ответа сервера.