{"id":656,"date":"2026-10-22T13:24:45","date_gmt":"2026-10-22T13:24:45","guid":{"rendered":"https:\/\/gilnas.synology.me\/wordpress\/656\/"},"modified":"2026-10-22T13:24:45","modified_gmt":"2026-10-22T13:24:45","slug":"nuxt-4-6-1-%ec%84%9c%eb%b2%84-%ea%b2%bd%ea%b3%84-%ec%a0%90%ea%b2%80-nuxt-4-6-1-server-boundary-check","status":"publish","type":"post","link":"https:\/\/gilnas.synology.me\/wordpress\/656\/","title":{"rendered":"Nuxt 4.6.1 \uc11c\ubc84 \uacbd\uacc4 \uc810\uac80 | Nuxt 4.6.1 Server Boundary Check"},"content":{"rendered":"<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/gilnas.synology.me\/wordpress\/wp-content\/uploads\/2026\/10\/2026-10-22-nuxt.png\" alt=\"Nuxt 4.6.1 \uc11c\ubc84 \uacbd\uacc4 \uc810\uac80 | Nuxt 4.6.1 Server Boundary Check\" \/><\/figure>\n<p><strong>\ud575\uc2ec \ub2f5\ubcc0:<\/strong> Nuxt 4.6.0\uacfc 4.6.1\uc740 \ub2e8\uc21c\ud55c \uac1c\ubc1c \uc11c\ubc84 \ud3b8\uc758 \uc5c5\ub370\uc774\ud2b8\uac00 \uc544\ub2d9\ub2c8\ub2e4. \uc11c\ubc84 \ucf54\ub4dc\ub97c <code>h3<\/code>\uc640 <code>nitropack<\/code>\uc758 \uc9c1\uc811 \uc758\uc874\uc5d0\uc11c \uc870\uae08\uc529 \ub5bc\uc5b4 \ub0b4\ub294 <code>nuxt\/server<\/code>\uac00 \uc0dd\uacbc\uace0, 4.6.1\uc740 \uadf8 \uc0c8 \uacbd\ub85c\uc758 \uc131\ub2a5\u00b7\uac1c\ubc1c \uc11c\ubc84 \ubb38\uc81c\ub97c \ubcf4\uc644\ud588\uc2b5\ub2c8\ub2e4. Nuxt 5\uc640 Nitro v3\ub97c \ubc14\ub77c\ubcf4\ub294 \ud504\ub85c\uc81d\ud2b8\ub77c\uba74 \uc9c0\uae08 \ubb34\uc870\uac74 \ub9c8\uc774\uadf8\ub808\uc774\uc158\ud558\uae30\ubcf4\ub2e4, <code>server\/api<\/code>\uc758 \uacbd\uacc4\ub97c \ud558\ub098 \uace8\ub77c \uc0c8 import\ub85c \uc62e\uae30\uace0 SSR\u00b7\ud0c0\uc785 \uac80\uc0ac\u00b7\ubc30\ud3ec \ud504\ub9ac\ubdf0\uae4c\uc9c0 \ubb36\uc5b4 \uac80\uc99d\ud558\ub294 \uac83\uc774 \uc548\uc804\ud569\ub2c8\ub2e4.<\/p>\n<p>\ud3c9\uc18c\uc5d0\ub294 <code>defineEventHandler<\/code>\uac00 \uc790\ub3d9 import\ub418\ub2c8 \uc5b4\ub290 \ud328\ud0a4\uc9c0\uc5d0\uc11c \uc654\ub294\uc9c0 \uc0dd\uac01\ud558\uc9c0 \uc54a\uc544\ub3c4 \ub429\ub2c8\ub2e4. \uadf8\ub7ec\ub098 \uc11c\ubc84 \ub7f0\ud0c0\uc784\uc774 \ubc14\ub00c\ub294 \uc2dc\uae30\uc5d0\ub294 \uc774 \ud3b8\ub9ac\ud568\uc774 \ubc1c\ubaa9\uc744 \uc7a1\uc744 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uc624\ub798\ub41c h3 \uc774\ubca4\ud2b8 \ubaa8\uc591\uacfc \uc0c8 portable RequestEvent\ub97c \uac19\uc740 \ud30c\uc77c\uc5d0\uc11c \uc11e\uc73c\uba74 Nuxt\uac00 \uc624\ub958\ub97c \ub0b4\uba70, \ub9ac\ub2e4\uc774\ub809\ud2b8\u00b7\uc624\ub958 \uc0dd\uc131\u00b7\ud5e4\ub354 \uc124\uc815 \ubc29\uc2dd\uc5d0\ub3c4 \ucc28\uc774\uac00 \uc788\uc2b5\ub2c8\ub2e4. \uc774\ubc88 \ub9b4\ub9ac\uc2a4\uc758 \ud575\uc2ec\uc740 \ucf54\ub4dc\uac00 \uc9e7\uc544\uc9c0\ub294 \ub370 \uc788\uc9c0 \uc54a\uace0, \uc5b4\ub290 \uc11c\ubc84 \ube4c\ub354\uc5d0\uc11c \uc2e4\ud589\ud574\ub3c4 \uac19\uc740 \uacc4\uc57d\uc744 \uc720\uc9c0\ud560 \uc218 \uc788\uac8c \ud558\ub294 \ub370 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<p>\uc5ec\uae30\uc11c\ub294 10\uc6d4 \ucd08 \uacf5\uac1c\ub41c \uacf5\uc2dd \ub9b4\ub9ac\uc2a4 \ub178\ud2b8\ub97c \uae30\uc900\uc73c\ub85c, \uc2e4\uc81c Nuxt \uc11c\ube44\uc2a4\uc5d0\uc11c \uba3c\uc800 \ud655\uc778\ud560 \ud30c\uc77c\uacfc \ud14c\uc2a4\ud2b8\ub97c \uc815\ub9ac\ud569\ub2c8\ub2e4. \ud2b9\ud788 <code>server\/api<\/code>, <code>middleware<\/code>, <code>nuxt.config.ts<\/code>, CI\uc758 typecheck\uc640 preview \ubc30\ud3ec\uac00 \uc5b4\ub5bb\uac8c \uc5f0\uacb0\ub418\ub294\uc9c0\uc5d0 \ucd08\uc810\uc744 \ub9de\ucda5\ub2c8\ub2e4.<\/p>\n<h2>\ubb34\uc2a8 \uc77c\uc774 \uc788\uc5c8\ub098<\/h2>\n<p>Nuxt \ud300\uc740 <a href=\"https:\/\/github.com\/nuxt\/nuxt\/releases\/tag\/v4.6.0\" target=\"_blank\" rel=\"noopener\">2026\ub144 10\uc6d4 5\uc77c Nuxt v4.6.0<\/a>\uc744 \uacf5\uac1c\ud588\uc2b5\ub2c8\ub2e4. \uacf5\uc2dd \uc124\uba85\uc5d0 \ub530\ub974\uba74 4.5.2 \uc774\ud6c4 420\uac1c \uc774\uc0c1 \ucee4\ubc0b\uc774 \ub4e4\uc5b4\uac04 \ub9c8\uc774\ub108 \ub9b4\ub9ac\uc2a4\uc774\uba70, Nuxt 3\ub294 2026\ub144 7\uc6d4 31\uc77c\uc5d0 EOL(\uc9c0\uc6d0 \uc885\ub8cc)\uc5d0 \ub3c4\ub2ec\ud574 3.x \ub3d9\uc2dc \ub9b4\ub9ac\uc2a4\ub294 \uc5c6\uc2b5\ub2c8\ub2e4. \ub530\ub77c\uc11c \uc544\uc9c1 Nuxt 3\uc5d0 \uba38\ubb38 \uc11c\ube44\uc2a4\ub77c\uba74 \u201c\ub2e4\uc74c \ud328\uce58\uae4c\uc9c0 \uae30\ub2e4\ub9ac\uc790\u201d\uac00 \uc544\ub2c8\ub77c 4.x \uc5c5\uadf8\ub808\uc774\ub4dc \uacc4\ud68d\uc744 \ubcc4\ub3c4 \uc791\uc5c5\uc73c\ub85c \uc7a1\ub294 \ud3b8\uc774 \ub9de\uc2b5\ub2c8\ub2e4.<\/p>\n<p>\uac00\uc7a5 \ud070 \ubcc0\ud654\ub294 <a href=\"https:\/\/nuxt.com\/docs\/guide\/going-further\/server-imports\" target=\"_blank\" rel=\"noopener\"><code>nuxt\/server<\/code><\/a> import \ud45c\uba74\uc785\ub2c8\ub2e4. \ud578\ub4e4\ub7ec\u00b7\ubbf8\ub4e4\uc6e8\uc5b4\u00b7\uc11c\ubc84 \uc720\ud2f8\ub9ac\ud2f0\uac00 \ud734\ub300 \uac00\ub2a5\ud55c <code>RequestEvent<\/code> \ud0c0\uc785\uc744 \ud5a5\ud558\ub3c4\ub85d \ud558\uace0, \uae30\ubcf8 \uad6c\ud604\uc740 \uc5ec\uc804\ud788 Nitro\uc9c0\ub9cc \uc7a5\uae30\uc801\uc73c\ub85c Nitro v3, h3 v2, \uc2e4\ud5d8\uc801 Vite \uc11c\ubc84 \uc0ac\uc774\uc758 \uacb0\ud569\uc744 \uc904\uc785\ub2c8\ub2e4. \uac19\uc740 \ub9b4\ub9ac\uc2a4\uc5d0\ub294 <code>NUXT_APP_SECRET<\/code> \uae30\ubc18\uc758 \uc571 \uc2dc\ud06c\ub9bf\uacfc \uc138\uc158 \ub3c4\uc6b0\ubbf8, \ub300\ud615 \ub77c\uc6b0\ud2b8 \uc9d1\ud569\uc5d0\uc11c \ud0c0\uc785 \uae4a\uc774 \ubb38\uc81c\ub97c \uc904\uc778 typed <code>$fetch<\/code>, \uc0c8 CLI v4\ub3c4 \ud3ec\ud568\ub410\uc2b5\ub2c8\ub2e4.<\/p>\n<p>\uc774\uc5b4 <a href=\"https:\/\/github.com\/nuxt\/nuxt\/releases\/tag\/v4.6.1\" target=\"_blank\" rel=\"noopener\">10\uc6d4 9\uc77c v4.6.1<\/a> \ud328\uce58\uac00 \ub098\uc654\uc2b5\ub2c8\ub2e4. portable event\uc758 web view\ub97c \uccab \uc811\uadfc \uc2dc \ub9cc\ub4e4\ub3c4\ub85d \ud574 \uc131\ub2a5\uc744 \uc870\uc815\ud588\uace0, Vite 8.1 \uc774\uc0c1 \uc758\uc874\uc131 \ucd5c\uc801\ud654 \uba54\uc2dc\uc9c0, <code>baseURL<\/code>\uc774 \uc788\ub294 fetch \uc751\ub2f5 \ud0c0\uc785, nodenext\uc5d0\uc11c\uc758 Nitro \ud0c0\uc785 \ud574\uc11d, dev server \ud578\ub4e4\ub7ec \uc911\ubcf5 \ub4f1\ub85d \uac19\uc740 \ubb38\uc81c\ub97c \uace0\ucce4\uc2b5\ub2c8\ub2e4. 4.6.0\uc744 \uc2dc\ud5d8\ud588\ub2e4\uba74 4.6.1\uc744 \uae30\uc900\uc73c\ub85c \uc7ac\uac80\uc99d\ud558\ub294 \ud3b8\uc774 \ub0ab\uc2b5\ub2c8\ub2e4.<\/p>\n<h2>\uc65c \uc911\uc694\ud55c\uac00<\/h2>\n<p>\uc11c\ubc84 \uc758\uc874\uc131\uc740 \ubcf4\ud1b5 API \ud578\ub4e4\ub7ec\ubcf4\ub2e4 \ubaa8\ub4c8\uacfc \ud50c\ub7ec\uadf8\uc778\uc5d0\uc11c \ub354 \uae4a\uac8c \ud37c\uc9d1\ub2c8\ub2e4. <code>h3<\/code>\uc758 \ud0c0\uc785\uc744 \uc571 \uc804\uc5ed\uc73c\ub85c \ub04c\uc5b4\uc62c\ub9ac\uba74 Nitro\uc640 h3\uc758 \uba54\uc774\uc800 \ubc84\uc804 \ucc28\uc774\uac00 TypeScript \ucda9\ub3cc\ub85c \ub4dc\ub7ec\ub0a0 \uc218 \uc788\uc2b5\ub2c8\ub2e4. Nuxt\uac00 \uc790\uccb4 \uc11c\ubc84 \uacc4\uc57d\uc744 \uc81c\uacf5\ud558\uba74 \ud504\ub808\uc784\uc6cc\ud06c\uac00 \uc5c5\uc2a4\ud2b8\ub9bc \ubcc0\uacbd\uc744 \ud761\uc218\ud560 \uc5ec\uc9c0\uac00 \uc0dd\uae30\uace0, \uc571\uacfc \ubaa8\ub4c8\uc740 \ub354 \uc548\uc815\uc801\uc778 import \uacbd\uacc4\uc5d0 \uc124 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ub2e4\ub9cc \uc774\ub294 \uae30\uc874 API\uac00 \uc0ac\ub77c\uc9c4\ub2e4\ub294 \ub73b\uc774 \uc544\ub2d9\ub2c8\ub2e4. \uacf5\uc2dd \ub178\ud2b8\ub3c4 \ud2b9\uc218 \uae30\ub2a5\uc774 \ud544\uc694\ud558\uba74 \uae30\uc874 h3 \ub610\ub294 nitropack\/runtime import\uac00 \uadf8\ub300\ub85c \ub3d9\uc791\ud55c\ub2e4\uace0 \ubc1d\ud799\ub2c8\ub2e4.<\/p>\n<p>\uc6b4\uc601 \uad00\uc810\uc5d0\uc11c\ub294 \ubc30\ud3ec \ud50c\ub7ab\ud3fc\uc744 \ubc14\uafb8\uac70\ub098 preview \ud658\uacbd\uc744 \ub298\ub9b4 \ub54c \uac00\uce58\uac00 \ud07d\ub2c8\ub2e4. SSR \uc694\uccad\uc758 URL\u00b7\ud5e4\ub354\u00b7\uc751\ub2f5 \uc0c1\ud0dc\uac00 Web API \ubaa8\uc591\uc73c\ub85c \uc815\ub9ac\ub418\uba74, Cloudflare\u00b7Node\u00b7\ud5a5\ud6c4 \uc11c\ubc84 \uad6c\ud604 \uc0ac\uc774\uc5d0\uc11c \uc571 \ucf54\ub4dc\ub97c \ub35c \uace0\uce69\ub2c8\ub2e4. \ubc18\ub300\ub85c \uc5c5\ub85c\ub4dc multipart \ucc98\ub9ac\ucc98\ub7fc \uc0c8 \ud45c\uba74\uc5d0 \uc5c6\ub294 \uae30\ub2a5\uc744 \uc5b5\uc9c0\ub85c \uc62e\uae30\uba74 \ubc30\ud3ec \uc704\ud5d8\ub9cc \ucee4\uc9d1\ub2c8\ub2e4. \uc0c8 \uacbd\uacc4\ub294 \uc120\ud0dd\uc801\uc73c\ub85c \ub3c4\uc785\ud558\uace0, \uae30\uc874 \ub3d9\uc791\uc758 \ud68c\uadc0\ub97c \uc815\ud655\ud788 \uc7a1\ub294 \ubc29\uc2dd\uc774 \uc88b\uc2b5\ub2c8\ub2e4.<\/p>\n<h3><code>server\/api<\/code>: \ud55c \ud30c\uc77c\uc5d0\uc11c import \uacc4\uc5f4\uc744 \uc11e\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4<\/h3>\n<p>\uba3c\uc800 \ub2e8\uc21c\ud55c \uc77d\uae30 API \ud558\ub098\ub97c \uace0\ub974\uc2ed\uc2dc\uc624. \uc608\ub97c \ub4e4\uc5b4 <code>server\/api\/projects.get.ts<\/code>\ub77c\uba74 \ub2e4\uc74c\ucc98\ub7fc \uc0c8 import\ub97c \uba85\uc2dc\ud569\ub2c8\ub2e4.<\/p>\n<pre><code>import { defineEventHandler, getQuery } from 'nuxt\/server'\n\nexport default defineEventHandler((event) =&gt; {\n  const { team } = getQuery&lt;{ team?: string }&gt;(event)\n  return { team: team ?? 'default' }\n})<\/code><\/pre>\n<p>\uc5ec\uae30\uc11c \uc911\uc694\ud55c \uc810\uc740 \uc790\ub3d9 import\ub41c <code>defineEventHandler<\/code>\uc640 <code>nuxt\/server<\/code>\uc758 <code>defineEventHandler<\/code>\ub97c \ud55c \ud578\ub4e4\ub7ec\uc5d0\uc11c \uc11e\uc9c0 \uc54a\ub294 \uac83\uc785\ub2c8\ub2e4. Nuxt 4\uc758 \uc790\ub3d9 import\ub294 \uc5ec\uc804\ud788 h3 \ub3c4\uc6b0\ubbf8\uc774\uba70 \uc774\ubca4\ud2b8 \ud615\ud0dc\uac00 \ub2e4\ub985\ub2c8\ub2e4. \ud63c\uc6a9 \uc2dc <code>NUXT_E8012<\/code>\uac00 \ub098\ud0c0\ub0a0 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ud30c\uc77c \ub2e8\uc704\ub85c \uc0c8 \ud45c\uba74\uc744 \uc120\ud0dd\ud558\uace0, \ucf54\ub4dc \ub9ac\ubdf0\uc5d0\uc11c import\ub97c \ud655\uc778\ud558\ub294 \uaddc\uce59\uc744 \ub450\uba74 \uc6d0\uc778\uc744 \ucc3e\uae30 \uc27d\uc2b5\ub2c8\ub2e4.<\/p>\n<p>\ub9c8\uc774\uadf8\ub808\uc774\uc158 \uc804\ud6c4\uc5d0\ub294 <code>curl<\/code>\ub9cc \ud558\uc9c0 \ub9d0\uace0 \uc785\ub825 \uc5c6\ub294 \uc694\uccad, \uc798\ubabb\ub41c query, \uc778\uc99d \uc5c6\ub294 \uc694\uccad, \uc5d0\ub7ec \uc751\ub2f5\uc744 \ubaa8\ub450 \ud14c\uc2a4\ud2b8\ud558\uc2ed\uc2dc\uc624. \uc0c8 API\uc5d0\uc11c \uc751\ub2f5 \uc0c1\ud0dc\ub294 <code>event.res.status<\/code>\uc640 <code>event.res.statusText<\/code>, \ud5e4\ub354\ub294 <code>event.res.headers<\/code>\ub85c \ub2e4\ub8f9\ub2c8\ub2e4. \uae30\uc874 h3 \ubc29\uc2dd\uc758 \uc751\ub2f5 \uc81c\uc5b4\ub97c \ubb34\uc2ec\ucf54 \ubcf5\uc0ac\ud558\uba74 \ud0c0\uc785\uc740 \ud1b5\uacfc\ud574\ub3c4 SSR \ud504\ub9ac\ubdf0\uc5d0\uc11c \uacb0\uacfc\uac00 \ub2ec\ub77c\uc9c8 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<h3>\uac80\uc99d\ub41c \uc785\ub825\uacfc typed fetch: \ub300\ud615 API\uc5d0\uc11c CI \uc2dc\uac04\uc744 \uce21\uc815\ud569\ub2c8\ub2e4<\/h3>\n<p>4.6\uc740 route tree\ub97c \ubc14\ud0d5\uc73c\ub85c typed <code>$fetch<\/code>\ub97c \ub2e4\uc2dc \uad6c\uc131\ud588\uc2b5\ub2c8\ub2e4. \ub9b4\ub9ac\uc2a4 \ub178\ud2b8\uc758 \uce21\uc815\uc5d0\uc11c\ub294 \ub77c\uc6b0\ud2b8\uac00 \uc218\ubc31\u00b7\uc218\ucc9c \uac1c\uc77c \ub54c \uc774\uc804 \ubc29\uc2dd\uc758 \ud0c0\uc785 \uc778\uc2a4\ud134\uc2a4\ud654\uac00 \ud06c\uac8c \ub298\uace0 <code>TS2589<\/code>\uac00 \ubc1c\uc0dd\ud558\ub358 \ubb38\uc81c\uac00 \uc904\uc5c8\uc2b5\ub2c8\ub2e4. Nuxt 4\uc5d0\uc11c\ub294 \uae30\ubcf8\uac12\uc774 \uc544\ub2c8\ub77c opt-in\uc785\ub2c8\ub2e4. \ucc98\uc74c\ubd80\ud130 \uc804\uc5ed \ud65c\uc131\ud654\ud558\uc9c0 \ub9d0\uace0 <code>nuxt.config.ts<\/code>\uc758 \ube0c\ub79c\uce58\uc5d0\uc11c \ucf20 \ub4a4 CI \uc2dc\uac04\uc744 \ube44\uad50\ud558\uc2ed\uc2dc\uc624.<\/p>\n<pre><code>export default defineNuxtConfig({\n  experimental: {\n    routeTypedFetch: true,\n    strictRouteTypes: true\n  }\n})<\/code><\/pre>\n<p><code>strictRouteTypes<\/code>\ub294 \uc874\uc7ac\ud558\uc9c0 \uc54a\ub294 \uacbd\ub85c \ud638\ucd9c\uc744 \ub354 \ube68\ub9ac \uc7a1\uc744 \uc218 \uc788\uc9c0\ub9cc, \ub3d9\uc801\uc73c\ub85c \ub9cc\ub4dc\ub294 URL\uc774\ub098 \uc190\uc73c\ub85c \uc120\uc5b8\ud55c <code>ServerRoutes<\/code> \ud655\uc7a5\uc774 \uc788\ub294 \ud504\ub85c\uc81d\ud2b8\uc5d0\uc11c\ub294 \ud0c0\uc785 \uc218\uc815\uc774 \ud544\uc694\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. <code>server\/api\/orders.post.ts<\/code>\uc5d0\uc11c body \uc2a4\ud0a4\ub9c8\ub97c \uac80\uc99d\ud55c\ub2e4\uba74, \ud638\ucd9c\ud558\ub294 composable\uc758 \uc815\uc0c1\u00b7\ub204\ub77d\u00b7\uc798\ubabb\ub41c \ud0c0\uc785 \ucf00\uc774\uc2a4\ub97c \ub2e8\uc704 \ud14c\uc2a4\ud2b8\uc640 <code>nuxi typecheck<\/code>\ub85c \uac19\uc774 \ubcf4\uc2ed\uc2dc\uc624. \ud0c0\uc785\uc774 \uc88b\uc544\uc84c\ub2e4\uace0 \ub7f0\ud0c0\uc784 \uc778\uc99d\uc774 \uc0dd\uae30\ub294 \uac83\uc740 \uc544\ub2d9\ub2c8\ub2e4.<\/p>\n<h3>\uc138\uc158\uacfc <code>NUXT_APP_SECRET<\/code>: \ubc30\ud3ec \ud658\uacbd\uc758 \uc2dc\ud06c\ub9bf\uc744 \uba85\uc2dc\ud569\ub2c8\ub2e4<\/h3>\n<p>4.6\uc740 <code>runtimeConfig.appSecret<\/code>\uacfc <code>NUXT_APP_SECRET<\/code>\ub97c \ub3c4\uc785\ud558\uace0, \uc774\ub97c \ubc14\ud0d5\uc73c\ub85c \ubaa9\uc801\ubcc4 \ube44\ubc00\uc744 \ud30c\uc0dd\ud558\ub294 <code>deriveSecret<\/code> \ubc0f \ucfe0\ud0a4\uc5d0 \ubd09\uc778\ud558\ub294 \uc138\uc158 \ub3c4\uc6b0\ubbf8\ub97c \uc81c\uacf5\ud569\ub2c8\ub2e4. \uac1c\ubc1c \ud658\uacbd\uc5d0\uc11c\ub294 \uac12\uc774 \uc5c6\uc744 \ub54c \uc0dd\uc131\u00b7\ubcf4\uc874\ud560 \uc218 \uc788\uc9c0\ub9cc \ube4c\ub4dc\ub294 \uc2dc\ud06c\ub9bf\uc744 \ub9cc\ub4e4\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \uc989 \ub85c\uceec\uc5d0\uc11c \uc798 \ub410\ub2e4\ub294 \uc774\uc720\ub85c preview\uc640 production\uc774 \uc548\uc804\ud558\ub2e4\uace0 \ubcfc \uc218 \uc5c6\uc2b5\ub2c8\ub2e4.<\/p>\n<p>CI\/CD\uc758 \ubc30\ud3ec \ubcc0\uc218\uc5d0 <code>NUXT_APP_SECRET<\/code>\uc774 \ud658\uacbd\ubcc4\ub85c \uc124\uc815\ub410\ub294\uc9c0, \uad50\uccb4 \uc2dc \uae30\uc874 \uc138\uc158\uc744 \uc5b4\ub5bb\uac8c \ubb34\ud6a8\ud654\ud560\uc9c0 \uba3c\uc800 \uc815\ud558\uc2ed\uc2dc\uc624. \uac12\uc744 <code>nuxt.config.ts<\/code>\uc5d0 \ud558\ub4dc\ucf54\ub529\ud558\uac70\ub098 <code>runtimeConfig.public<\/code>\uc5d0 \ub123\uc5b4\uc11c\ub294 \uc548 \ub429\ub2c8\ub2e4. \ucfe0\ud0a4 \uae30\ubc18 \uc138\uc158\uc774 \uc800\uc7a5\uc18c \uc124\uc815\uc744 \uc904\uc5ec\ub3c4, \uad00\ub9ac\uc790 \ud654\uba74\uc5d0\uc11c \uc138\uc158 \ubb34\ud6a8\ud654\uc640 \uad8c\ud55c \ubcc0\uacbd\uc744 \ud655\uc778\ud558\ub294 \ud750\ub984\uc740 \ubcc4\ub3c4\ub85c \ud544\uc694\ud569\ub2c8\ub2e4.<\/p>\n<h3>CLI v4\uc640 \uac1c\ubc1c \uc11c\ubc84: \ube60\ub978 \uc2dc\uc791\ubcf4\ub2e4 \uc7ac\ud604 \uac00\ub2a5\ud55c \uc624\ub958 \ubcf4\uace0\uac00 \uba3c\uc800\uc785\ub2c8\ub2e4<\/h3>\n<p>Nuxt 4.6\uacfc \ud568\uaed8 <a href=\"https:\/\/github.com\/nuxt\/cli\/releases\/tag\/v4.0.0\" target=\"_blank\" rel=\"noopener\">@nuxt\/cli v4<\/a>\uac00 \ubc30\ud3ec\ub410\uc2b5\ub2c8\ub2e4. dev \ud130\ubbf8\ub110 UI, route\u00b7network\u00b7\uc624\ub958 \ud328\ub110, \ub290\ub9b0 \uc2dc\uc791 \uc6d0\uc778 \ud45c\uc2dc, \uc2e4\ud589 \uc911 \uc11c\ubc84\uc640 \ud1b5\uc2e0\ud558\ub294 \uba85\ub839\uc774 \ucd94\uac00\ub410\uc2b5\ub2c8\ub2e4. \uacf5\uc2dd \ub178\ud2b8\uc758 \uce21\uc815\uc5d0\uc11c\ub294 CLI \uc124\uce58 \ud06c\uae30\uc640 \uccab \ud654\uba74 \uc2dc\uac04\uc774 \uc904\uc5c8\uc9c0\ub9cc, \uc218\uce58\ub294 \uc790\uc2e0\uc758 \ubaa8\ub4c8\u00b7OS\u00b7\uce90\uc2dc \uc870\uac74\uacfc \ub2e4\ub97c \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<p>\uac1c\ubc1c\ud300\uc5d0\ub294 \uc624\ub958\uac00 \ud55c \ubc88\ub9cc \uc815\ud655\ud788 \ubcf4\uc774\ub294 \ucabd\uc774 \ub354 \uc911\uc694\ud569\ub2c8\ub2e4. 4.6\uc758 \uc0c8 \uc624\ub958 \ucc44\ub110\uc740 <code>nuxt.config.ts<\/code> \ubb38\ubc95 \uc624\ub958\ub97c \uace0\uce5c \ub4a4 \uac1c\ubc1c \ud398\uc774\uc9c0\ub97c \ub2e4\uc2dc \ub85c\ub4dc\ud558\ub294 \ud750\ub984\uc744 \uac1c\uc120\ud569\ub2c8\ub2e4. 4.6.1\uc740 dev handler \ub4f1\ub85d\uacfc Vite \uad00\ub828 \ubb38\uc81c\ub3c4 \uace0\ucce4\uc2b5\ub2c8\ub2e4. \uc5c5\uadf8\ub808\uc774\ub4dc PR\uc5d0\uc11c <code>pnpm dev<\/code>\ub9cc \uc5f4\uc5b4 \ubcf4\uc9c0 \ub9d0\uace0, \uc124\uc815 \ud30c\uc77c \uc624\ub958\ub97c \uc758\ub3c4\uc801\uc73c\ub85c \ub9cc\ub4e4\uc5c8\ub2e4 \uace0\uce5c \ub4a4 SSR \uc624\ub958 overlay\u00b7\ud130\ubbf8\ub110 \ub85c\uadf8\u00b7HMR \ubcf5\uad6c\uac00 \ubaa8\ub450 \uc815\uc0c1\uc778\uc9c0 \ud655\uc778\ud558\uc2ed\uc2dc\uc624.<\/p>\n<h3>\ubc30\ud3ec\uc640 \ub864\ubc31: \uc2e4\ud5d8\uc801 \uc11c\ubc84 \uc120\ud0dd\uc740 preview\uc5d0\uc11c\ub9cc \uc2dc\uc791\ud569\ub2c8\ub2e4<\/h3>\n<p>Nuxt\ub294 \uae30\ubcf8 Nitro\uac00 \ub300\ubd80\ubd84\uc758 \uacbd\uc6b0 \ub9de\ub2e4\uace0 \uba85\uc2dc\ud569\ub2c8\ub2e4. <code>@nuxt\/vite-server<\/code>\ub294 \uc2e4\ud5d8\uc801 \uad6c\ud604\uc774\ubbc0\ub85c, \uc0c8 \uc11c\ubc84 \ube4c\ub354\ub97c \uc6b4\uc601\uc5d0 \ubc14\ub85c \ub123\uae30\ubcf4\ub2e4 preview \ud658\uacbd\uc5d0\uc11c routeRules, \uc774\ubbf8\uc9c0, \ub9ac\ub2e4\uc774\ub809\ud2b8, \uc5d0\ub7ec \ud398\uc774\uc9c0, \uce90\uc2dc \ud5e4\ub354\ub97c \ube44\uad50\ud574\uc57c \ud569\ub2c8\ub2e4. \ud2b9\ud788 <code>routeRules<\/code>\ub85c ISR\uc774\ub098 \uce90\uc2dc\ub97c \uc124\uc815\ud55c \uc11c\ube44\uc2a4\ub294 SSR HTML\uacfc API \uc751\ub2f5\uc774 \ub3d9\uc77c\ud55c \ud5e4\ub354\ub97c \ub0b4\ub294\uc9c0 \ud655\uc778\ud558\uc2ed\uc2dc\uc624.<\/p>\n<p>\ub864\ubc31\uc740 package.json \ubc84\uc804\ub9cc \ub418\ub3cc\ub9ac\ub294 \uc77c\uc774 \uc544\ub2d9\ub2c8\ub2e4. lockfile, Node \ubc84\uc804, \ubc30\ud3ec \uc5b4\ub311\ud130, \uc0c8 \uc2dc\ud06c\ub9bf \ubcc0\uc218\uc640 \ud568\uaed8 \ub418\ub3cc\ub9b4 \uc9c0\uc810\uc744 \ubb38\uc11c\ud654\ud574\uc57c \ud569\ub2c8\ub2e4. 4.6.0\uc5d0\uc11c \uc2dc\uc791\ud588\ub2e4\uba74 4.6.1 \ud328\uce58\uc640 \ube44\uad50\ud574 dev\u00b7build\u00b7preview\ub97c \ub2e4\uc2dc \ub3cc\ub9ac\uace0, \uc7a5\uc560 \uc2dc\uc5d0\ub294 \uc0c8 <code>nuxt\/server<\/code> \ud30c\uc77c\ub9cc \uae30\uc874 h3 \uad6c\ud604\uc73c\ub85c \ub418\ub3cc\ub9b4 \uc218 \uc788\ub3c4\ub85d PR\uc744 \uc791\uac8c \uc720\uc9c0\ud558\ub294 \ud3b8\uc774 \ub0ab\uc2b5\ub2c8\ub2e4.<\/p>\n<h2>\uac1c\ubc1c\uc790 \uc2e4\ud589 \uacc4\ud68d<\/h2>\n<ul>\n<li><strong>1.<\/strong> <code>nuxi info<\/code>, Node \ubc84\uc804, lockfile\uc758 Nuxt\ub97c \uae30\ub85d\ud558\uace0 4.6.1 \uae30\uc900 \uc5c5\uadf8\ub808\uc774\ub4dc \ube0c\ub79c\uce58\ub97c \ub9cc\ub4ed\ub2c8\ub2e4.<\/li>\n<li><strong>2.<\/strong> <code>server\/api<\/code>\uc758 \ub2e8\uc21c GET \ud55c \uac1c\ub9cc <code>nuxt\/server<\/code>\ub85c \uc62e\uae30\uace0 import \ud63c\uc6a9\uc744 \uac80\uc0ac\ud569\ub2c8\ub2e4.<\/li>\n<li><strong>3.<\/strong> \ud574\ub2f9 API\uc758 \uc815\uc0c1\u00b7\uc624\ub958\u00b7\uc778\uc99d \uc2e4\ud328 \ud14c\uc2a4\ud2b8\ub97c \ucd94\uac00\ud558\uace0 SSR \ud398\uc774\uc9c0\uc5d0\uc11c \ud638\ucd9c\ud574 \ubd05\ub2c8\ub2e4.<\/li>\n<li><strong>4.<\/strong> <code>nuxi typecheck<\/code>, build, preview\ub97c CI \ud544\uc218 \ub2e8\uacc4\ub85c \uc2e4\ud589\ud574 \uc2dc\uac04\uacfc \uc624\ub958\ub97c \ube44\uad50\ud569\ub2c8\ub2e4.<\/li>\n<li><strong>5.<\/strong> <code>NUXT_APP_SECRET<\/code>\uc758 preview\/production \uc124\uc815\uacfc \uad50\uccb4 \uc808\ucc28\ub97c \ubc30\ud3ec \ubb38\uc11c\uc5d0 \uc801\uc2b5\ub2c8\ub2e4.<\/li>\n<li><strong>6.<\/strong> routeTypedFetch\ub294 \ubcc4\ub3c4 PR\uc5d0\uc11c \ucf1c\uace0 \ub3d9\uc801 URL\u00b7ServerRoutes \uc624\ub958\ub97c \uc815\ub9ac\ud569\ub2c8\ub2e4.<\/li>\n<li><strong>7.<\/strong> preview\uc5d0\uc11c routeRules, \ucfe0\ud0a4, \ub9ac\ub2e4\uc774\ub809\ud2b8, \uce90\uc2dc \ud5e4\ub354\ub97c \ucea1\ucc98\ud574 \uae30\uc874 \ubc30\ud3ec\uc640 \ube44\uad50\ud569\ub2c8\ub2e4.<\/li>\n<\/ul>\n<h2>\ub9ac\uc2a4\ud06c\uc640 \ud55c\uacc4<\/h2>\n<p><code>nuxt\/server<\/code>\ub294 \uc774\uc2dd\uc131 \uc788\ub294 \uae30\ubcf8 \ud45c\uba74\uc774\uc9c0 h3\uc758 \ubaa8\ub4e0 \uae30\ub2a5\uc744 \uc989\uc2dc \ub300\uccb4\ud55c\ub2e4\ub294 \uc120\uc5b8\uc774 \uc544\ub2d9\ub2c8\ub2e4. multipart\u00b7\ud2b9\uc815 Nitro \ud6c5\ucc98\ub7fc \uc0c8 \ud45c\uba74 \ubc16\uc758 \uae30\ub2a5\uc740 \uae30\uc874 import\ub97c \uc720\uc9c0\ud558\ub294 \ud3b8\uc774 \uc548\uc804\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ub610\ud55c routeTypedFetch\uc640 strictRouteTypes\ub294 Nuxt 4\uc5d0\uc11c \uc2e4\ud5d8\uc801 opt-in\uc774\ubbc0\ub85c, \ud0c0\uc785 \uc624\ub958\uac00 \ub298\uc5c8\ub2e4\uba74 \uc124\uc815\uc744 \ub418\ub3cc\ub9ac\uace0 \uc791\uc740 \ubc94\uc704\ubd80\ud130 \uc815\ub9ac\ud558\uc2ed\uc2dc\uc624.<\/p>\n<p>Nuxt 3 EOL\uc740 \uc911\uc694\ud55c \uc0ac\uc2e4\uc774\uc9c0\ub9cc, \ubaa8\ub4e0 \uc11c\ube44\uc2a4\uac00 \ub2f9\uc77c \ub300\uaddc\ubaa8 \uc5c5\uadf8\ub808\uc774\ub4dc\ub97c \ud574\uc57c \ud55c\ub2e4\ub294 \ub73b\uc740 \uc544\ub2d9\ub2c8\ub2e4. \ud604\uc7ac \ubcf4\uc548 \uc694\uad6c, \ubaa8\ub4c8 \ud638\ud658\uc131, Node \ub7f0\ud0c0\uc784\uc744 \ud655\uc778\ud558\uace0 \uc2a4\ud14c\uc774\uc9d5\uc5d0\uc11c \ub864\ubc31 \uac00\ub2a5\ud55c \ubc30\ud3ec\ub97c \uba3c\uc800 \ub9cc\ub4dc\uc2ed\uc2dc\uc624. \uacf5\uc2dd \ub9b4\ub9ac\uc2a4 \ub178\ud2b8\uc758 \uc131\ub2a5 \uc218\uce58\ub3c4 \uac01 \ud504\ub85c\uc81d\ud2b8\uc758 \uc808\ub300 \uc131\ub2a5 \ubcf4\uc7a5\uc740 \uc544\ub2c8\ubbc0\ub85c CI\uc640 \uc2e4\uc81c preview \uc9c0\ud45c\ub85c \ud310\ub2e8\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n<h2>FAQ<\/h2>\n<h3>Nuxt 4.6\uc73c\ub85c \uc62c\ub9ac\uba74 \ubaa8\ub4e0 server\/api\ub97c nuxt\/server\ub85c \ubc14\uafd4\uc57c \ud558\ub098\uc694?<\/h3>\n<p>\uc544\ub2d9\ub2c8\ub2e4. \uacf5\uc2dd \ub178\ud2b8\ub3c4 \uae30\uc874 h3\u00b7Nitro import\uac00 \uacc4\uc18d \ub3d9\uc791\ud55c\ub2e4\uace0 \uc124\uba85\ud569\ub2c8\ub2e4. Nuxt 5 \uc900\ube44\uac00 \ud544\uc694\ud55c \ud30c\uc77c\ubd80\ud130 \uba85\uc2dc\uc801\uc73c\ub85c \uc62e\uae30\uace0 \ud68c\uadc0 \ud14c\uc2a4\ud2b8\ub97c \ud1b5\uacfc\uc2dc\ud0a4\uc2ed\uc2dc\uc624.<\/p>\n<h3>Nuxt 4.6.0 \ub300\uc2e0 4.6.1\uc744 \uc124\uce58\ud574\uc57c \ud558\ub098\uc694?<\/h3>\n<p>\uc0c8 \ub3c4\uc785\uc774\ub77c\uba74 4.6.1\uc774 \ud569\ub9ac\uc801\uc785\ub2c8\ub2e4. 4.6.0 \ub4a4\uc5d0 \ub098\uc628 \ud328\uce58\ub85c \uac1c\ubc1c \uc11c\ubc84, \ud0c0\uc785 \ud574\uc11d, Vite \ud638\ud658\uc131, portable event \uc131\ub2a5 \uad00\ub828 \uc218\uc815\uc774 \ud3ec\ud568\ub410\uc2b5\ub2c8\ub2e4.<\/p>\n<h3>NUXT_APP_SECRET \uc5c6\uc774 \uc138\uc158 \uae30\ub2a5\uc744 \uc6b4\uc601\uc5d0 \uc368\ub3c4 \ub418\ub098\uc694?<\/h3>\n<p>\uad8c\uc7a5\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \uac1c\ubc1c \ud658\uacbd\uc758 \uc790\ub3d9 \uc0dd\uc131\uacfc \uc6b4\uc601 \ube4c\ub4dc\ub294 \ub2e4\ub985\ub2c8\ub2e4. \ubc30\ud3ec \ud658\uacbd\uc5d0 \ucda9\ubd84\ud788 \uae34 \ube44\ubc00\uac12\uc744 \uc124\uc815\ud558\uace0 \uad50\uccb4\u00b7\ubb34\ud6a8\ud654 \uc808\ucc28\ub97c \ub9c8\ub828\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n<h2>\ucd9c\ucc98 \ubc0f \ucd94\uac00 \uc77d\uae30<\/h2>\n<ul>\n<li><a href=\"https:\/\/github.com\/nuxt\/nuxt\/releases\/tag\/v4.6.0\" target=\"_blank\" rel=\"noopener\">Nuxt v4.6.0 \uacf5\uc2dd \ub9b4\ub9ac\uc2a4 \ub178\ud2b8<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/nuxt\/nuxt\/releases\/tag\/v4.6.1\" target=\"_blank\" rel=\"noopener\">Nuxt v4.6.1 \uacf5\uc2dd \ub9b4\ub9ac\uc2a4 \ub178\ud2b8<\/a><\/li>\n<li><a href=\"https:\/\/nuxt.com\/docs\/guide\/going-further\/server-imports\" target=\"_blank\" rel=\"noopener\">Nuxt Server Imports \uac00\uc774\ub4dc<\/a><\/li>\n<li><a href=\"https:\/\/nuxt.com\/docs\/getting-started\/upgrade#moving-to-nuxtserver\" target=\"_blank\" rel=\"noopener\">Nuxt upgrade: nuxt\/server\uc73c\ub85c \uc774\ub3d9<\/a><\/li>\n<li><a href=\"https:\/\/nuxt.com\/docs\/guide\/going-further\/experimental-features#routetypedfetch\" target=\"_blank\" rel=\"noopener\">Nuxt experimental routeTypedFetch \ubb38\uc11c<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/nuxt\/cli\/releases\/tag\/v4.0.0\" target=\"_blank\" rel=\"noopener\">Nuxt CLI v4 \uacf5\uc2dd \ub9b4\ub9ac\uc2a4<\/a><\/li>\n<\/ul>\n<h2>\ub354 \uae4a\uac8c \uc77d\uae30: \uc2e4\uc804 \uac00\uc774\ub4dc<\/h2>\n<p>\uc774 \ub9ac\ud3ec\ud2b8\ub294 \ucd5c\uadfc \ud750\ub984\uc744 \ube60\ub974\uac8c \ud30c\uc545\ud558\uae30 \uc704\ud55c \uc694\uc57d\uc785\ub2c8\ub2e4. \uc2e4\uc81c \ud504\ub85c\uc81d\ud2b8\uc5d0 \uc801\uc6a9\ud560 \ub54c\ub294 \uc544\ub798\uc758 \uae30\uc900 \uae00\uacfc \ud568\uaed8 \ud655\uc778\ud558\uba74 \ub354 \uc548\uc804\ud569\ub2c8\ub2e4.<\/p>\n<ul>\n<li><a href=\"https:\/\/gilnas.synology.me\/wordpress\/113\/\">AI \uc5d0\uc774\uc804\ud2b8\ub780 \ubb34\uc5c7\uc778\uac00?<\/a><\/li>\n<li><a href=\"https:\/\/gilnas.synology.me\/wordpress\/114\/\">\ud504\ub86c\ud504\ud2b8 \uc778\uc81d\uc158 \ubcf4\uc548 \uccb4\ud06c\ub9ac\uc2a4\ud2b8<\/a><\/li>\n<li><a href=\"https:\/\/gilnas.synology.me\/wordpress\/115\/\">AI \ucf54\ub529 \ub3c4\uad6c \uc548\uc804 \uc6cc\ud06c\ud50c\ub85c<\/a><\/li>\n<li><a href=\"https:\/\/gilnas.synology.me\/wordpress\/116\/\">Nuxt SEO \uc124\uc815 \ubc29\ubc95<\/a><\/li>\n<li><a href=\"https:\/\/gilnas.synology.me\/wordpress\/117\/\">Nuxt\uc640 WordPress Headless CMS \uad6c\uc870<\/a><\/li>\n<li><a href=\"https:\/\/gilnas.synology.me\/wordpress\/118\/\">\uac1c\ubc1c\uc790 \ube14\ub85c\uadf8 \uc560\ub4dc\uc13c\uc2a4 \uc2b9\uc778 \uc804\ub7b5<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Nuxt 4.6.1\uc758 nuxt\/server, typed fetch, appSecret\uc744 server\/api\u00b7CI\/CD\u00b7SSR \ubc30\ud3ec\uc5d0\uc11c \uc548\uc804\ud558\uac8c \uac80\uc99d\ud558\ub294 \ubc29\ubc95\uc744 \uc815\ub9ac\ud569\ub2c8\ub2e4.<\/p>\n","protected":false},"author":1,"featured_media":655,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-656","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-nuxt-trend"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/posts\/656","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/comments?post=656"}],"version-history":[{"count":0,"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/posts\/656\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/media\/655"}],"wp:attachment":[{"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/media?parent=656"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/categories?post=656"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gilnas.synology.me\/wordpress\/wp-json\/wp\/v2\/tags?post=656"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}