Server Options

server.host

  • 类型： string

    指定服务器主机名。

server.port

  • 类型： number

    指定服务器端口。注意：如果端口已经被使用，Vite 会自动尝试下一个可用的端口，所以这可能不是服务器最终监听的实际端口。

server.strictPort

  • 类型： boolean

    设为 true 时若端口已被占用则会直接退出，而不是尝试下一个可用端口。

server.https

  • 类型： boolean | https.ServerOptions

    启用 TLS + HTTP/2。注意当 server.proxy option 也被使用时，将会仅使用 TLS。

    这个值也可以是一个传递给 https.createServer() 的 选项对象。

server.open

  • 类型： boolean | string

    在服务器启动时自动在浏览器中打开应用程序。当此值为字符串时，会被用作 URL 的路径名。

    示例：

    1. export default {
    2.   server: {
    3.     open: '/docs/index.html'
    4.   }
    5. }

server.proxy

  • 类型： Record<string, string | ProxyOptions>

    为开发服务器配置自定义代理规则。期望接收一个 { key: options } 对象。如果 key 值以 ^ 开头，将会被解释为 RegExp。

    使用 http-proxy。完整选项详见 此处.

    示例：

    1. export default {
    2.   server: {
    3.     proxy: {
    4.       // 字符串简写写法
    5.       '/foo': 'http://localhost:4567/foo',
    6.       // 选项写法
    7.       '/api': {
    8.         target: 'http://jsonplaceholder.typicode.com',
    9.         changeOrigin: true,
    10.         rewrite: (path) => path.replace(/^\/api/, '')
    11.       },
    12.       // 正则表达式写法
    13.       '^/fallback/.*': {
    14.         target: 'http://jsonplaceholder.typicode.com',
    15.         changeOrigin: true,
    16.         rewrite: (path) => path.replace(/^\/fallback/, '')
    17.       }
    18.     }
    19.   }
    20. }

server.cors

  • 类型： boolean | CorsOptions

    为开发服务器配置 CORS。默认启用并允许任何源，传递一个 选项对象 来调整行为或设为 false 表示禁用。

server.force

server.hmr

  • 类型： boolean | { protocol?: string, host?: string, port?: number, path?: string, timeout?: number, overlay?: boolean }

    禁用或配置 HMR 连接（用于 HMR websocket 必须使用不同的 http 服务器地址的情况）。

    设置 server.hmr.overlay 为 false 可以禁用服务器错误遮罩层。

server.watch

  • 类型： object

    传递给 chokidar 的文件系统监视器选项。