サーバオプション #

server.host #

• 型: string | boolean
• デフォルト: 'localhost'

サーバがリッスンすべき IP アドレスを指定します。 0.0.0.0 もしくは true に設定すると、LAN やパブリックアドレスを含むすべてのアドレスをリッスンします。

これは CLI で --host 0.0.0.0 や --host を使用して設定できます。

// vite.config.js
import { defineConfig } from 'vite'
import dns from 'dns'

dns.setDefaultResultOrder('verbatim')

export default defineConfig({
  // 省略
})

server.port #

• 型: number
• デフォルト: 5173

サーバのポートを指定します。このポートがすでに使用されている場合、Vite は次に使用可能なポートを自動的に試すので、サーバが最終的にリッスンする実際のポートとは異なる場合があることに注意してください。

server.strictPort #

• 型: boolean

true に設定すると、ポートがすでに使用されている場合に、次に使用可能なポートを自動的に試すことなく終了します。

server.https #

• 型: boolean | https.ServerOptions

TLS + HTTP/2 を有効にします。server.proxy オプションも使用されている場合にのみ TLS にダウングレードされるので注意してください。

この値は https.createServer() に渡されるオプションオブジェクトでも構いません。

有効な証明書が必要です。基本的なセットアップでは、自己署名証明書を自動的に作成しキャッシュする @vitejs/plugin-basic-ssl をプロジェクトのプラグインに追加することもできます。しかし、独自の証明書を作成することを推奨します。

server.open #

• 型: boolean | string

サーバ起動時に自動的にブラウザでアプリを開きます。値が文字列の場合、URL のパス名として使用されます。もしあなたの好きなブラウザでアプリを開きたい場合、環境変数 process.env.BROWSER（例: firefox）を定義できます。詳細は open パッケージ をご覧ください。また、process.env.BROWSER_ARGS を設定して、追加の引数を渡すこともできます（例: --incognito）。

また、BROWSER と BROWSER_ARGS は .env ファイルで設定できる特別な環境変数です。詳しくは open パッケージ を参照してください。

例:

export default defineConfig({
  server: {
    open: '/docs/index.html',
  },
})

server.proxy #

• 型: Record<string, string | ProxyOptions>

開発サーバのカスタムプロキシのルールを設定します。{ key: options } のペアのオブジェクトが必要です。リクエストパスがそのキーで始まるすべてのリクエストは、その指定されたターゲットにプロキシされます。キーが ^ で始まる場合は RegExp として解釈されます。プロキシのインスタンスにアクセスするには configure オプションを使用します。

相対的でない base を使用する場合、各キーの先頭に base を付けなければならないことに注意してください。

http-proxy を拡張します。他のオプションはこちら。

場合によっては、基盤となる開発サーバーを設定したいこともあるでしょう（例: 内部の connect アプリにカスタムミドルウェアを追加する場合など）。そのためには、独自の plugin を書き、configureServer 関数を使用する必要があります。

例:

export default defineConfig({
  server: {
    proxy: {
      // 文字列のショートハンド: http://localhost:5173/foo -> http://localhost:4567/foo
      '/foo': 'http://localhost:4567',
      // オプションを使用: http://localhost:5173/api/bar-> http://jsonplaceholder.typicode.com/bar
      '/api': {
        target: 'http://jsonplaceholder.typicode.com',
        changeOrigin: true,
        rewrite: (path) => path.replace(/^\/api/, ''),
      },
      // 正規表現を使用: http://localhost:5173/fallback/ -> http://jsonplaceholder.typicode.com/
      '^/fallback/.*': {
        target: 'http://jsonplaceholder.typicode.com',
        changeOrigin: true,
        rewrite: (path) => path.replace(/^\/fallback/, ''),
      },
      // プロキシインスタンスを使用
      '/api': {
        target: 'http://jsonplaceholder.typicode.com',
        changeOrigin: true,
        configure: (proxy, options) => {
          // プロキシは 'http-proxy' のインスタンスになります
        },
      },
      // Web ソケット か socket.io をプロキシ化: ws://localhost:5173/socket.io -> ws://localhost:5174/socket.io
      '/socket.io': {
        target: 'ws://localhost:5174',
        ws: true,
      },
    },
  },
})

server.cors #

• 型: boolean | CorsOptions

開発サーバの CORS を設定します。これはデフォルトで有効になっており、どんなオリジンも許可します。オプションオブジェクトを渡して微調整するか、false で無効にします。

server.headers #

• 型: OutgoingHttpHeaders

サーバのレスポンスヘッダを指定します。

server.hmr #

• 型: boolean | { protocol?: string, host?: string, port?: number, path?: string, timeout?: number, overlay?: boolean, clientPort?: number, server?: Server }

HMR 接続の無効化または設定（HMR WebSocket が http サーバと異なるアドレスを使用する必要がある場合）。

server.hmr.overlay を false に設定すると、サーバエラーのオーバレイが無効になります。

clientPort は、クライアント側のポートのみを上書きする高度なオプションで、クライアントコードが探すポートとは異なるポートで WebSocket を配信できます。

server.hmr.server を指定されている場合、Vite は指定されたサーバを通して HMR 接続要求を処理します。ミドルウェアモードでない場合、Vite は既存のサーバを通して HMR 接続要求を処理しようとします。これは、自己署名証明書を使用する場合や、Vite を単一ポートでネットワーク上に公開したい場合に役立ちます。

いくつかの例については、vite-setup-catalogueをご覧ください。

Direct websocket connection fallback. Check out https://vitejs.dev/config/server-options.html#server-hmr to remove the previous connection error.

server.watch #

• 型: object

chokidar に渡すファイルシステムウォッチャのオプションです。

Vite サーバのウォッチャは、デフォルトでは .git/ と node_modules/ ディレクトリをスキップします。もし node_modules/ 内のパッケージを監視したい場合は、server.watch.regard に否定の glob パターンを渡すことができます。つまり:

export default defineConfig({
  server: {
    watch: {
      ignored: ['!**/node_modules/your-package-name/**'],
    },
  },
  // 監視するパッケージは、最適化から除外する必要があります。
  // これにより、依存関係グラフに現れ、ホットリロードをトリガーできるようになります。
  optimizeDeps: {
    exclude: ['your-package-name'],
  },
})

server.middlewareMode #

• 型: boolean
• デフォルト: false

ミドルウェアモードで Vite サーバを作成します。

• 関連: appType, SSR - 開発サーバのセットアップ

• 例:

import express from 'express'
import { createServer as createViteServer } from 'vite'

async function createServer() {
  const app = express()

  // ミドルウェアモードで Vite サーバを作成
  const vite = await createViteServer({
    server: { middlewareMode: true },
    appType: 'custom', // ViteのデフォルトのHTMLを処理するミドルウェアを含めない
  })
  // vite の接続インスタンスをミドルウェアとして使用
  app.use(vite.middlewares)

  app.use('*', async (req, res) => {
    // `appType` が `'custom'` なので、ここでレスポンスを返すべきです。
    // 注: `appType` が `'spa'` または `'mpa'` の際は、Vite に HTML リクエスト と 404 になる
    // リクエストを処理するミドルウェアが含まれます。したがって、ユーザーのミドルウェアが
    // 動作するためにはViteのミドルウェアよりも前に追加されるべきです。
  })
}

createServer()

server.base #

• 型: string | undefined

Vite をサブフォルダとしてプロキシする場合に使用するため、http リクエストの前にこのフォルダを追加します。先頭は / の文字にする必要があります。

server.fs.strict #

• 型: boolean
• デフォルト: true（Vite 2.7 以降、デフォルトで有効）

ワークスペースのルート以外のファイルの配信を制限します。

server.fs.allow #

• 型: string[]

/@fs/ 経由で配信可能なファイルを制限します。server.fs.strict が true に設定されている場合、このディレクトリリストの外にある、許可されたファイルからインポートされていないファイルにアクセスすると、403 が返されます。

Vite は、潜在的なワークスペースのルートを検索し、それをデフォルトとして使用します。有効なワークスペースは以下の条件を満たすもので、そうでない場合はプロジェクトのルートにフォールバックします。

• package.json に workspaces フィールドが含まれている
• 以下のファイルのいずれかを含んでいる
  • lerna.json
  • pnpm-workspace.yaml

カスタムワークスペースのルートを指定するパスを受け取ります。絶対パスか、プロジェクトのルートからの相対パスを指定します。例えば:

export default defineConfig({
  server: {
    fs: {
      // プロジェクトルートの 1 つ上の階層からファイルを配信できるようにする
      allow: ['..'],
    },
  },
})

server.fs.allow を指定すると、ワークスペースルートの自動検出が無効になります。本来の動作を拡張するために、ユーティリティーの searchForWorkspaceRoot が公開されています:

import { defineConfig, searchForWorkspaceRoot } from 'vite'

export default defineConfig({
  server: {
    fs: {
      allow: [
        // ワークスペースルートの検索
        searchForWorkspaceRoot(process.cwd()),
        // あなたのカスタムルール
        '/path/to/custom/allow',
      ],
    },
  },
})

server.fs.deny #

• 型: string[]
• デフォルト: ['.env', '.env.*', '*.{crt,pem}']

Vite 開発サーバでの配信が制限されている機密ファイルのブロックリスト。これは server.fs.allow よりも優先度が高くなります。picomatch パターンがサポートされています。

server.origin #

• 型: string

開発時に生成されるアセット URL のオリジンを定義します。

export default defineConfig({
  server: {
    origin: 'http://127.0.0.1:8080',
  },
})

server.sourcemapIgnoreList #

• 型: false | (sourcePath: string, sourcemapPath: string) => boolean
• デフォルト: (sourcePath) => sourcePath.includes('node_modules')

サーバのソースマップにあるソースファイルを無視するかどうか。x_google_ignoreList ソースマップ拡張を設定するため使用されます。

server.sourcemapIgnoreList は、開発サーバの build.rollupOptions.output.sourcemapIgnoreList に相当します。2 つの設定オプションの違いは、rollup の関数が sourcePath の相対パスで呼び出されるのに対して、server.sourcemapIgnoreList は絶対パスで呼び出されることです。開発中、ほとんどのモジュールはマップとソースが同じフォルダにあるため、sourcePath の相対パスはファイル名そのものになります。このような場合、代わりに絶対パスを使用するのが便利です。

デフォルトでは node_modules を含むすべてのパスを除外します。この動作を無効にするには false を渡します。もしくは、完全に制御するには、ソースパスとソースマップパスを受け取り、ソースパスを無視するかどうかを返す関数を指定します。

export default defineConfig({
  server: {
    // これはデフォルトの値であり、パスに node_modules を含むすべての
    // ファイルを無視リストに追加します。
    sourcemapIgnoreList(sourcePath, sourcemapPath) {
      return sourcePath.includes('node_modules')
    }
  }
};