Next.js は next start
で起動される独自のサーバーをデフォルトで含んでいます。もし既存のバックエンドがある場合でも、それを Next.js において利用し続けられます(これはカスタムサーバーではありません)。カスタム Next.js サーバーはカスタムされたサーバーパターンを利用するために 100% プログラムで制御してサーバーを起動することを可能にします。ほとんどの場合必要ではありませんが、完全なカスタマイズのために利用可能です。
注意: カスタムサーバーは Vercel へとデプロイすることができません。
カスタムサーバーの使用を決定する前に、Next.js の統合ルーターがアプリの要件を満たせない場合にのみ使用すべきことを気に留めてください。カスタムサーバーでは、サーバーレス関数や Automatic Static Optimization. などの重要なパフォーマンス最適化が削除されます。
次のカスタムサーバーの例を見てください:
// server.js
const { createServer } = require('http')
const { parse } = require('url')
const next = require('next')
const dev = process.env.NODE_ENV !== 'production'
const hostname = 'localhost'
const port = 3000
// ミドルウェアを利用する場合、 `hostname` と `port` を以下のように提供する必要があります。
const app = next({ dev, hostname, port })
const handle = app.getRequestHandler()
app.prepare().then(() => {
createServer(async (req, res) => {
try {
// `url.parse` の2番目の引数として必ず `true` を渡してください。
// これは、URLのクエリ部分を解析するように指示します。
const parsedUrl = parse(req.url, true)
const { pathname, query } = parsedUrl
if (pathname === '/a') {
await app.render(req, res, '/a', query)
} else if (pathname === '/b') {
await app.render(req, res, '/b', query)
} else {
await handle(req, res, parsedUrl)
}
} catch (err) {
console.error('Error occurred handling', req.url, err)
res.statusCode = 500
res.end('internal server error')
}
}).listen(port, (err) => {
if (err) throw err
console.log(`> Ready on http://${hostname}:${port}`)
})
})
server.js
は babel や webpack を経由しません。このファイルに必要な構文とソースが、現在実行中の node バージョンと互換性があることを確認してください。
次に、カスタムサーバーを実行するには、このように、package.json
の scripts
を更新する必要があります:
"scripts": {
"dev": "node server.js",
"build": "next build",
"start": "NODE_ENV=production node server.js"
}
カスタムサーバーは、次のようにインポートして、サーバーを Next.js アプリケーションに接続します:
const next = require('next');
const app = next({});
上記の next
インポートは、次のオプションを持つオブジェクトを受け取る関数です:
dev
: Boolean
- Next.js を開発モードで起動するかどうか。デフォルトは false
ですdir
: String
- Next.js プロジェクトの場所。デフォルトは '.'
ですquiet
: Boolean
- サーバー情報を含むエラーメッセージを非表示にします。デフォルトは false
ですconf
: object
- next.config.js で使用するのと同じオブジェクト。デフォルトは {}
です返された app
を使用して、必要に応じて Next.js でリクエストを処理できます。
デフォルトでは、Next
はファイル名と一致するパス名の下の pages
フォルダー内の各ファイルを提供します。プロジェクトでカスタムサーバーを使用する場合、この挙動で同じコンテンツが複数のパスから提供される恐れがあり、SEO と UX に問題を起こす可能性があります。
この動作を無効にし、 pages
内のファイルに基づくルーティングを防ぐには、 next.config.js
を開いて useFileSystemPublicRoutes
設定を無効にします:
module.exports = {
useFileSystemPublicRoutes: false
};
useFileSystemPublicRoutes
は SSR のファイル名ルートのみを無効にすることに注意してください。クライアント側のルーティングは、これらのパスに引き続きアクセスできます。このオプションを使用する場合は、プログラム上で不要なルートへのナビゲーションを防ぐ必要があります。
クライアント側ルーターを構成して、ファイル名ルートへのクライアント側リダイレクトを禁止することもできます。これについては、
Router.beforePopState
を参照してください。