{"id":608,"date":"2026-10-13T13:07:45","date_gmt":"2026-10-13T13:07:45","guid":{"rendered":"https:\/\/gilnas.synology.me\/wordpress\/608\/"},"modified":"2026-10-13T13:07:45","modified_gmt":"2026-10-13T13:07:45","slug":"nuxt-4-6-1-%ea%b0%9c%eb%b0%9c-%ec%84%9c%eb%b2%84%c2%b7ssr%c2%b7%eb%b0%b0%ed%8f%ac-%ea%b2%bd%ea%b3%84%eb%a5%bc-%ec%a0%90%ea%b2%80%ed%95%a0-%ec%97%85%eb%8d%b0%ec%9d%b4%ed%8a%b8-nuxt-4-6-1-operations","status":"publish","type":"post","link":"https:\/\/gilnas.synology.me\/wordpress\/608\/","title":{"rendered":"Nuxt 4.6.1: \uac1c\ubc1c \uc11c\ubc84\u00b7SSR\u00b7\ubc30\ud3ec \uacbd\uacc4\ub97c \uc810\uac80\ud560 \uc5c5\ub370\uc774\ud2b8 | Nuxt 4.6.1 Operations"},"content":{"rendered":"
\"Nuxt<\/figure>\n

\ud575\uc2ec \ub2f5\ubcc0:<\/strong> Nuxt 4.6\uacfc 4.6.1\uc740 \ub2e8\uc21c\ud55c \uae30\ub2a5 \ubb36\uc74c\uc774 \uc544\ub2d9\ub2c8\ub2e4. 10\uc6d4 5\uc77c \uacf5\uac1c\ub41c 4.6\uc740 nuxt\/server<\/code>\ub97c \uc911\uc2ec\uc73c\ub85c \uc11c\ubc84\uc5d0 \ub35c \ubb36\uc774\ub294 \ubc29\ud5a5\uc744 \uc5f4\uc5c8\uace0, 10\uc6d4 9\uc77c\uc758 4.6.1\uc740 \uac1c\ubc1c \uc11c\ubc84 \ud578\ub4e4\ub7ec\u00b7\ud0c0\uc785\u00b7Nitro \uacbd\ub85c\uc5d0\uc11c \uadf8 \uacbd\uacc4\ub97c \ub2e4\ub4ec\uc5c8\uc2b5\ub2c8\ub2e4. \uc9c0\uae08 Nuxt \ud504\ub85c\uc81d\ud2b8\uc5d0\uc11c \ud560 \uc77c\uc740 \uc989\uc2dc \uc804\uba74 \uc5c5\uadf8\ub808\uc774\ub4dc\uac00 \uc544\ub2c8\ub77c Node \ubc84\uc804, dev server, SSR \ub370\uc774\ud130 \uc694\uccad, server\/api\uc640 \ubc30\ud3ec \uc5b4\ub311\ud130\ub97c \ud55c PR\ub85c \ubb36\uc9c0 \uc54a\uace0 \uac80\uc99d<\/strong>\ud558\ub294 \uac83\uc785\ub2c8\ub2e4.<\/p>\n

Nuxt\ub97c \uc6b4\uc601\ud558\ub2e4 \ubcf4\uba74 \ud504\ub808\uc784\uc6cc\ud06c \uc5c5\ub370\uc774\ud2b8\uc758 \uc9c4\uc9dc \uc704\ud5d8\uc740 \uc0c8 API\ub97c \uc4f0\ub294 \ud654\uba74\ubcf4\ub2e4 \uac1c\ubc1c \ud658\uacbd\uacfc \ubc30\ud3ec \ud658\uacbd\uc774 \uc11c\ub85c \ub2e4\ub974\uac8c \uc6c0\uc9c1\uc774\ub294 \ub370\uc11c \uc0dd\uae41\ub2c8\ub2e4. \ub85c\uceec nuxt dev<\/code>\uc5d0\uc11c\ub294 \uc798 \ub418\ub294\ub370 CI\uc758 \ud0c0\uc785 \uac80\uc0ac\ub098 \uc11c\ubc84\ub9ac\uc2a4 \ubc30\ud3ec\uc5d0\uc11c\ub9cc \uae68\uc9c0\uac70\ub098, SSR\uc5d0\uc11c \uc4f0\ub294 $fetch<\/code> \ud0c0\uc785\uc774 \uc2e4\uc81c \uc751\ub2f5\uacfc \uc5b4\uae0b\ub098\ub294 \uc2dd\uc785\ub2c8\ub2e4. Nuxt 4.6.1\uc758 \uc218\uc815 \ubaa9\ub85d\uc740 \ubc14\ub85c \uc774\ub7f0 \uacbd\uacc4\uc5d0 \uc9d1\uc911\ub3fc \uc788\uc2b5\ub2c8\ub2e4. \uadf8\ub7ec\ub2c8 \ub9b4\ub9ac\uc2a4 \ub178\ud2b8\ub97c \uc77d\uc740 \ub4a4\uc5d0\ub294 \ud648 \ud654\uba74\uc744 \ud074\ub9ad\ud558\ub294 \uac83\ubcf4\ub2e4 \uc2e4\uc81c \uc11c\ubc84 API, \uc778\uc99d \ubbf8\ub4e4\uc6e8\uc5b4, preview \ubc30\ud3ec\ub97c \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n

\uc774 \uae00\uc740 Nuxt\uc758 \uacf5\uc2dd 4.6 \ubc1c\ud45c\uc640 GitHub\uc758 4.6.1 \ud328\uce58 \ub9b4\ub9ac\uc2a4\ub97c \uae30\uc900\uc73c\ub85c \uc815\ub9ac\ud588\uc2b5\ub2c8\ub2e4. \ud2b9\ud788 Nuxt CLI v4\uc758 \uac1c\ubc1c \uc11c\ubc84 \ubcc0\ud654, server-agnostic \ubc29\ud5a5, typed $fetch<\/code>, Nitro \uac1c\ubc1c \ud578\ub4e4\ub7ec\uc758 \uc601\ud5a5\uc744 \ud604\uc2e4\uc801\uc778 nuxt.config.ts<\/code>\u00b7server\/api<\/code>\u00b7CI \uc7a5\uba74\uc5d0\uc11c \uc0b4\ud3b4\ubd05\ub2c8\ub2e4. \uc544\uc9c1 4.5.x\ub97c \uc548\uc815\uc801\uc73c\ub85c \uc4f0\ub294 \ud300\ub3c4 \uc774\ubc88 \ubcc0\uacbd\uc744 \uc5c5\uadf8\ub808\uc774\ub4dc \uacc4\ud68d\uacfc \ud68c\uadc0 \ud14c\uc2a4\ud2b8\uc758 \ucd9c\ubc1c\uc810\uc73c\ub85c \uc0bc\uc744 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n

\ubb34\uc2a8 \uc77c\uc774 \uc788\uc5c8\ub098<\/h2>\n

Nuxt \ud300\uc740 2026\ub144 10\uc6d4 5\uc77c Nuxt 4.6<\/a>\uc744 \uacf5\uac1c\ud588\uc2b5\ub2c8\ub2e4. \uacf5\uc2dd \ubc1c\ud45c\uc758 \ud575\uc2ec\uc740 nuxt\/server<\/code>\ub97c \ud1b5\ud574 Nuxt\ub97c \ud2b9\uc815 \uc11c\ubc84 \uad6c\ud604\uc5d0 \ub35c \ubb36\ub294 \uccab \ub2e8\uacc4, \uc7ac\uad6c\uc131\ud55c typed $fetch<\/code>, \uc138\uc158, Vue Vapor \uc9c0\uc6d0, \uc0c8 \uac1c\ubc1c \uc624\ub958 \ud398\uc774\uc9c0, \uadf8\ub9ac\uace0 Nuxt CLI v4\uc785\ub2c8\ub2e4. 4.5.2 \uc774\ud6c4 420\uac1c\uac00 \ub118\ub294 \ucee4\ubc0b\uc774 \ud3ec\ud568\ub41c \ud070 \ub9c8\uc774\ub108 \ub9b4\ub9ac\uc2a4\ub77c\uace0 \uc124\uba85\ud569\ub2c8\ub2e4.<\/p>\n

CLI v4\ub294 nuxt dev<\/code> \ud130\ubbf8\ub110\uc5d0 URL\u00b7\uc2dc\uc791 \uc9c4\ud589\u00b7\ub85c\uadf8\u00b7\uc694\uccad\u00b7\ud398\uc774\uc9c0\/\uc11c\ubc84 \ub77c\uc6b0\ud2b8\ub97c \ubcf4\ub294 \ud328\ub110\uc744 \ucd94\uac00\ud558\uace0, \uc694\uccad\ub9c8\ub2e4 ID\ub97c \ubd99\uc5ec \ub85c\uadf8\uc640 \uc624\ub958\ub97c \uc5f0\uacb0\ud569\ub2c8\ub2e4. \uae30\uc874 \ucd9c\ub825\uc774 \ud544\uc694\ud558\uba74 --no-tui<\/code>\ub97c \uc4f8 \uc218 \uc788\uc2b5\ub2c8\ub2e4. .nuxt\/<\/code>\uc758 \uc7a0\uae08 \ud30c\uc77c\uc740 \ub450 \ubc88\uc9f8 \uac1c\ubc1c \uc11c\ubc84\uac00 \uae30\uc874 \uc11c\ubc84\ub97c \uc778\uacc4\ubc1b\uac70\ub098 \uae30\ub2e4\ub9ac\uac8c \ud558\uba70, \uac19\uc740 \uc2e4\ud589 \uc911 \uc11c\ubc84\uc5d0 \uc5f0\uacb0\ud558\ub294 nuxt curl<\/code>, nuxt task<\/code> \uba85\ub839\ub3c4 \uc774 \uae30\ubc18\uc744 \uc0ac\uc6a9\ud569\ub2c8\ub2e4. \uacf5\uc2dd \uc218\uce58\ub294 CLI \uc124\uce58 \ud06c\uae30\uc640 \uac1c\ubc1c \uc11c\ubc84 \ucd08\uae30 \ud45c\uc2dc \uc2dc\uac04\uc744 \uac1c\uc120\ud588\ub2e4\uace0 \uc81c\uc2dc\ud558\uc9c0\ub9cc, \uc774\ub294 Nuxt \ud300\uc758 \uce21\uc815\uac12\uc774\ubbc0\ub85c \uac01 \ud504\ub85c\uc81d\ud2b8 CI \uc2dc\uac04\uacfc \uac19\ub2e4\uace0 \ub2e8\uc815\ud560 \uc218\ub294 \uc5c6\uc2b5\ub2c8\ub2e4.<\/p>\n

\uc774\uc5b4 10\uc6d4 9\uc77c Nuxt 4.6.1<\/a>\uc774 \ud328\uce58 \ub9b4\ub9ac\uc2a4\ub85c \ub098\uc654\uc2b5\ub2c8\ub2e4. Nitro portable event\uc758 web view\ub97c \uccab \uc811\uadfc \ub54c \ub9cc\ub4e4\ub3c4\ub85d \uc870\uc815\ud588\uace0, Vite 8.1+ optimizer \uba54\uc2dc\uc9c0, \ube44 SSR \ud658\uacbd\uc758 outDir<\/code> \uacf5\uac1c \ub514\ub809\ud130\ub9ac, \uac00\uc0c1 import\uac00 \uc788\ub294 \uc124\uce58 \ud328\ud0a4\uc9c0\uc758 \uc758\uc874\uc131 \uc2a4\uce94, \uac1c\ubc1c \uc624\ub958 \ubcf4\uace0\uc5d0 \uc694\uccad \ud3ec\ud568, \uac1c\ubc1c \ud578\ub4e4\ub7ec \uc911\ubcf5 \ub4f1\ub85d \ubc29\uc9c0, RequestEvent<\/code> \uc804\ub2ec \ub4f1\uc744 \uc218\uc815\ud588\uc2b5\ub2c8\ub2e4. typed $fetch<\/code>\uc640 async data\uc5d0\uc11c \uc811\uadfc \uac00\ub2a5\ud55c \ud0c0\uc785 export\ub3c4 \uc815\ub9ac\ub410\uc2b5\ub2c8\ub2e4.<\/p>\n

\uc65c \uc911\uc694\ud55c\uac00<\/h2>\n

\uc11c\ubc84\uc5d0 \ub35c \ubb36\uc774\ub294 \uad6c\uc870\ub294 \ubc30\ud3ec \uc120\ud0dd\uc9c0\ub97c \ub113\ud790 \uc218 \uc788\uc9c0\ub9cc, \ub3d9\uc2dc\uc5d0 \u201c\uc6b0\ub9ac \ucf54\ub4dc\ub294 \uc5b4\ub290 \uc2e4\ud589 \ud658\uacbd\uc744 \uac00\uc815\ud558\ub294\uac00\u201d\ub97c \ub354 \uba85\ud655\ud788 \ud574\uc57c \ud569\ub2c8\ub2e4. server\/api<\/code>\uc5d0\uc11c Node \uc804\uc6a9 \ubaa8\ub4c8\uc774\ub098 \ud30c\uc77c \uc2dc\uc2a4\ud15c\uc744 \ubc14\ub85c \uc77d\ub294 \ucf54\ub4dc, reverse proxy \ud5e4\ub354\ub97c \uc804\uc81c\ub85c \ud55c \uc778\uc99d, \uc11c\ubc84\ub9ac\uc2a4\uc640 \uc7a5\uae30 \uc2e4\ud589 \uc11c\ubc84\uc5d0\uc11c \ub2e4\ub974\uac8c \ub3d9\uc791\ud558\ub294 \uce90\uc2dc\ub294 \ubaa8\ub450 \uc5c5\uadf8\ub808\uc774\ub4dc \uc804 \ud655\uc778 \ub300\uc0c1\uc785\ub2c8\ub2e4. \uc544\ud0a4\ud14d\ucc98 \ubcc0\ud654\uc758 \uc774\uc810\uc740 \ucd94\uc0c1\ud654 \uc790\uccb4\uac00 \uc544\ub2c8\ub77c \uc774\ub7f0 \uc758\uc874\uc131\uc744 \uba3c\uc800 \ub4dc\ub7ec\ub0b4\ub294 \ub370 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n

4.6.1\uc758 \ubcc0\uacbd\uc740 \ub300\uccb4\ub85c \uac1c\ubc1c\u00b7\ud0c0\uc785\u00b7\ubc88\ub4e4 \uacbd\uacc4\uc758 \uc548\uc815\ud654\uc785\ub2c8\ub2e4. \uc0ac\uc6a9\uc790\uc5d0\uac8c \uc0c8 \ubc84\ud2bc\uc774 \ubcf4\uc774\uc9c0 \uc54a\ub354\ub77c\ub3c4, \uac00\uc0c1 \ubaa8\ub4c8\uc744 \uc4f0\ub294 Nuxt \ubaa8\ub4c8, \ubc30\ud3ec \ud0c0\uae43 \ud50c\ub7ec\uadf8\uc778, \ubaa8\ub178\ub808\ud3ec\uc758 \uc870\uac74\ubd80 export, SSR \uc624\ub958 \ucd94\uc801\uc774 \uc788\ub294 \uc571\uc740 \uccb4\uac10\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ud328\uce58 \ubc84\uc804\uc774\ubbc0\ub85c \uc790\ub3d9\uc73c\ub85c \ubb34\uc704\ud5d8\uc774\ub77c\ub294 \ub73b\uc740 \uc544\ub2c8\uba70, \ud2b9\ud788 lockfile\uacfc Node \ub7f0\ud0c0\uc784\uc774 \uc2e4\uc81c \ubc30\ud3ec \uc774\ubbf8\uc9c0\uc5d0 \uac19\uc740\uc9c0\ubd80\ud130 \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n

Nuxt CLI v4: \uac1c\ubc1c \ud3b8\uc758 \uae30\ub2a5\uc744 CI \uc2e0\ud638\uc640 \uc11e\uc9c0 \uc54a\uae30<\/h3>\n

\uc0c8 CLI \ud328\ub110\uc740 \ub290\ub9b0 \uc2dc\uc791 \uc2dc\uac04, \uc7ac\uc2dc\uc791 \uc774\uc720, \ubaa8\ub4c8 \uc124\uc815 \uc2dc\uac04\uc744 \ubcf4\uc5ec \uc8fc\ubbc0\ub85c \ub85c\uceec\uc5d0\uc11c \ubb38\uc81c\ub97c \uc881\ud788\ub294 \ub370 \uc720\uc6a9\ud569\ub2c8\ub2e4. \uc608\ub97c \ub4e4\uc5b4 nuxt.config.ts<\/code>\ub97c \ubc14\uafbc \ub4a4 \uc608\uc0c1\uce58 \ubabb\ud55c hard restart\uac00 \ub09c\ub2e4\uba74, \uc5b4\ub5a4 \ud0a4\uac00 \ubcc0\ud654\ub97c \ub9cc\ub4e4\uc5c8\ub294\uc9c0 \ud655\uc778\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ud558\uc9c0\ub9cc \ud130\ubbf8\ub110 \ud654\uba74\uc758 \uccb4\uac10 \uc18d\ub3c4\ub97c CI \uc131\ub2a5\uc758 \uc99d\uac70\ub85c \uc4f0\uba74 \uc548 \ub429\ub2c8\ub2e4. CI\uc5d0\uc11c\ub294 nuxi build<\/code> \uc2dc\uac04, \uba54\ubaa8\ub9ac, \uc0b0\ucd9c\ubb3c \ud06c\uae30, \uce90\uc2dc \uc801\uc911\uc744 \ubcc4\ub3c4 \uc218\uc9d1\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n

\uac1c\ubc1c\uc790\uac00 \uc5d0\uc774\uc804\ud2b8\ub098 \ub2e4\ub978 \ud130\ubbf8\ub110\uc5d0\uc11c \ub450 \ubc88\uc9f8 nuxt dev<\/code>\ub97c \ub744\uc6b0\ub294 \ud300\uc774\ub77c\uba74 .nuxt<\/code> \uc7a0\uae08 \ub3d9\uc791\ub3c4 smoke test\uc5d0 \ub123\uc73c\uc138\uc694. \uae30\uc874 \ud3ec\ud2b8\ub97c \ube8f\uac70\ub098 \uc11c\ub85c \ub2e4\ub978 \ud658\uacbd\ubcc0\uc218\ub85c \uc2e4\ud589\ub418\ub294 \uc0ac\uace0\ub97c \uc904\uc77c \uc218 \uc788\uc9c0\ub9cc, \ud300\uc758 \ub3c4\uad6c\uac00 \uc7a0\uae08 \ud30c\uc77c\uc744 \uc9c1\uc811 \uc9c0\uc6b0\uac70\ub098 \ucee8\ud14c\uc774\ub108 \ubcfc\ub968\uc744 \uacf5\uc720\ud55c\ub2e4\uba74 \uc2e4\uc81c \ub3d9\uc791\uc744 \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4. \ubb38\uc81c\uac00 \ub098\uba74 --no-tui<\/code>\ub85c \ud654\uba74\ub9cc \ub418\ub3cc\ub9ac\ub294 \uac83\uc774 \uc544\ub2c8\ub77c \uc2e4\ud589 \ud504\ub85c\uc138\uc2a4\uc640 \uc791\uc5c5 \ub514\ub809\ud130\ub9ac \uacf5\uc720 \ubc29\uc2dd\uc744 \uba3c\uc800 \ubd84\ub9ac\ud569\ub2c8\ub2e4.<\/p>\n

typed $fetch: \uc751\ub2f5 \ud0c0\uc785\uacfc \ub7f0\ud0c0\uc784 \uc751\ub2f5\uc744 \ud568\uaed8 \ud14c\uc2a4\ud2b8\ud558\uae30<\/h3>\n

Nuxt 4.6\uc740 typed $fetch<\/code>\ub97c \ub2e4\uc2dc \uad6c\uc131\ud588\uace0, 4.6.1\uc740 \uc804\uc5ed $fetch<\/code> \ud0c0\uc785\uc744 Nuxt\uc758 TypedFetch<\/code>\ub85c \ub9de\ucd94\uace0 \uba85\uba85\ub41c \uc751\ub2f5 \ud0c0\uc785\uc5d0\uc11c \uc5b4\ub5a4 baseURL<\/code>\ub3c4 \uc218\uc6a9\ud558\ub3c4\ub85d \uc218\uc815\ud588\uc2b5\ub2c8\ub2e4. \uc2e4\uc81c \uc571\uc5d0\uc11c\ub294 server\/api\/profile.get.ts<\/code>\uac00 \ubc18\ud658\ud558\ub294 JSON\uacfc useFetch('\/api\/profile')<\/code>\uc758 \ucd94\ub860\uc774 \ub9de\ub294\uc9c0\ub97c \ubcf4\ub294 \ubb38\uc81c\uc785\ub2c8\ub2e4. \ud0c0\uc785 \uc5d0\ub7ec\uac00 \uc0ac\ub77c\uc84c\ub2e4\uace0 API \uacc4\uc57d\uc774 \ub9de\ub294 \uac83\uc740 \uc544\ub2d9\ub2c8\ub2e4.<\/p>\n

\uac00\uc7a5 \uc791\uc740 \uac80\uc99d\uc740 API \ub77c\uc6b0\ud2b8\uc758 \uc131\uacf5\u00b7\uad8c\ud55c \uc5c6\uc74c\u00b7\ube48 \uac12 \uc751\ub2f5\uc744 Playwright\ub098 Vitest\ub85c \uace0\uc815\ud558\ub294 \uac83\uc785\ub2c8\ub2e4. SSR\uc5d0\uc11c \ub85c\uadf8\uc778 \ucfe0\ud0a4\ub97c \ud3ec\ud568\ud55c \uc694\uccad, \ud074\ub77c\uc774\uc5b8\ud2b8 hydration \ub4a4\uc758 \uc7ac\uc694\uccad, baseURL\uc774 \ud504\ub85d\uc2dc \uacbd\ub85c\uc77c \ub54c\uc758 \uc751\ub2f5\uae4c\uc9c0 \ud655\uc778\ud558\uc138\uc694. runtimeConfig.public.apiBase<\/code>\ub97c \ubc14\uafb8\ub294 \ud658\uacbd\uc774\ub77c\uba74 \ub85c\uceec\uacfc preview\uc5d0\uc11c \uac19\uc740 \uacbd\ub85c\uac00 \ub418\ub294\uc9c0\ub3c4 \ubd10\uc57c \ud569\ub2c8\ub2e4.<\/p>\n

server\/api\uc640 Nitro \uac1c\ubc1c \ud578\ub4e4\ub7ec: \uc911\ubcf5 \ub4f1\ub85d\uacfc \uc694\uccad \ucd94\uc801 \ud655\uc778<\/h3>\n

4.6.1\uc740 Nitro\uac00 \uac01 \uac1c\ubc1c \uc11c\ubc84 \ud578\ub4e4\ub7ec\ub97c \ud55c \ubc88\ub9cc \ub4f1\ub85d\ud558\ub3c4\ub85d \ud558\uace0, Nuxt \uac1c\ubc1c \uc11c\ubc84 \ud578\ub4e4\ub7ec\uc5d0 RequestEvent<\/code>\ub97c \uc804\ub2ec\ud558\ub3c4\ub85d \uace0\ucce4\uc2b5\ub2c8\ub2e4. \uc774 \ubcc0\uacbd\uc740 \uac1c\ubc1c \uc911 \ubbf8\ub4e4\uc6e8\uc5b4\uac00 \ub450 \ubc88 \uc2e4\ud589\ub418\uac70\ub098 \ub85c\uadf8\uac00 \uc5b4\ub290 \uc694\uccad\uc5d0\uc11c \uc654\ub294\uc9c0 \ubaa8\ud638\ud55c \ubb38\uc81c\uc640 \ub9de\ub2ff\uc544 \uc788\uc2b5\ub2c8\ub2e4. \uc608\ub97c \ub4e4\uc5b4 server\/middleware\/auth.ts<\/code>\uc5d0\uc11c \uc694\uccad ID\uc640 \uc0ac\uc6a9\uc790 \uc0c1\ud0dc\ub97c \uae30\ub85d\ud558\ub294 \uc571\uc740, \uc5c5\uadf8\ub808\uc774\ub4dc \ub4a4 \ud55c \uc694\uccad\uc5d0 \ub85c\uadf8\uac00 \ud55c \ubc88\ub9cc \ub0a8\ub294\uc9c0 \ud655\uc778\ud560 \uac00\uce58\uac00 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n

\ub2e4\ub9cc \ub85c\uadf8\uac00 \uc904\uc5c8\ub2e4\uace0 \uc778\uc99d\uc774 \uc548\uc804\ud574\uc84c\ub2e4\ub294 \uacb0\ub860\uc740 \uae08\ubb3c\uc785\ub2c8\ub2e4. \uc2a4\ud14c\uc774\uc9d5\uc5d0\uc11c \ub85c\uadf8\uc778, \ub85c\uadf8\uc544\uc6c3, \ub9cc\ub8cc\ub41c \uc138\uc158, OPTIONS<\/code> \uc694\uccad, \uc624\ub958 \uc751\ub2f5\uc744 \uc7ac\ud604\ud558\uace0 reverse proxy\uc758 x-forwarded-*<\/code> \ud5e4\ub354\uae4c\uc9c0 \ud3ec\ud568\ud574 \uc0b4\ud3b4\ubcf4\uc138\uc694. SSR \uc624\ub958 \ud654\uba74\uc5d0 \uc694\uccad \uc815\ubcf4\uac00 \ub098\uc624\ub354\ub77c\ub3c4 \uc0ac\uc6a9\uc790 \ud1a0\ud070\u00b7\ucfe0\ud0a4\u00b7\uac1c\uc778\uc815\ubcf4\uac00 \ud654\uba74\uc774\ub098 \uc5d0\ub7ec \uc218\uc9d1 \uc11c\ube44\uc2a4\uc5d0 \ub178\ucd9c\ub418\uc9c0 \uc54a\ub294\uc9c0 \ub9c8\uc2a4\ud0b9 \uaddc\uce59\ub3c4 \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n

\ubc30\ud3ec \uc5b4\ub311\ud130\uc640 outDir: \uc815\uc801 \uc790\uc0b0 \uacbd\ub85c\ub97c preview\uc5d0\uc11c \uac80\uc0ac\ud558\uae30<\/h3>\n

\ub9b4\ub9ac\uc2a4\uc5d0\ub294 \ube44 SSR \ud658\uacbd\uc5d0\uc11c \uc124\uc815\ud55c outDir<\/code>\ub97c public directory\ub85c \uc4f0\ub3c4\ub85d \ud558\ub294 \uc218\uc815\uacfc, \uac1c\ubc1c\uc5d0\uc11c deploy target \ud50c\ub7ec\uadf8\uc778\uc774 \ub3d9\uc791\ud558\ub3c4\ub85d \ud558\ub294 \uc218\uc815\uc774 \ub4e4\uc5b4 \uc788\uc2b5\ub2c8\ub2e4. \uc774\uac83\uc740 routeRules<\/code>\ub85c ISR\u00b7\uce90\uc2dc\u00b7\ub9ac\ub2e4\uc774\ub809\ud2b8\ub97c \uc124\uc815\ud558\uac70\ub098 Cloudflare\/Vercel \uac19\uc740 \ud0c0\uae43\uc744 \uc4f0\ub294 \uc571\uc5d0\uc11c \uc911\uc694\ud569\ub2c8\ub2e4. \ub85c\uceec \ube4c\ub4dc\uac00 \uc131\uacf5\ud574\ub3c4 preview URL\uc5d0\uc11c CSS, dynamic import chunk, \uc774\ubbf8\uc9c0, 404 fallback\uc774 \ubaa8\ub450 \uac19\uc740 base path\ub97c \uc4f0\ub294\uc9c0 \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4.<\/p>\n

nuxt.config.ts<\/code>\uc758 nitro<\/code> preset, app.baseURL<\/code>, routeRules<\/code>\ub97c \ud55c \ubc88\uc5d0 \ubc14\uafb8\uc9c0 \ub9d0\uace0, \uba3c\uc800 \uae30\uc874 \uc124\uc815 \uadf8\ub300\ub85c 4.6.1 \ube4c\ub4dc \uc0b0\ucd9c\ubb3c\uacfc \ubc30\ud3ec manifest\ub97c \ube44\uad50\ud558\uc138\uc694. \uc790\uc0b0 404\ub098 \uc798\ubabb\ub41c \uce90\uc2dc \ud5e4\ub354\uac00 \ub098\uc624\uba74 \ud504\ub808\uc784\uc6cc\ud06c\ub97c \uc989\uc2dc \ub418\ub3cc\ub9ac\uace0 lockfile\u00b7\ubc30\ud3ec \ub85c\uadf8\u00b7\uc0dd\uc131\ub41c .output<\/code> \ucc28\uc774\ub97c \ubcf4\uad00\ud558\uba74 \uc6d0\uc778\uc744 \uc881\ud788\uae30 \uc27d\uc2b5\ub2c8\ub2e4.<\/p>\n

Node \ubc84\uc804\uacfc \ubaa8\ub178\ub808\ud3ec: \uc5c5\uadf8\ub808\uc774\ub4dc \uc804\uc81c \uc870\uac74\uc744 CI\uc5d0\uc11c \uac15\uc81c\ud558\uae30<\/h3>\n

Nuxt CLI v4\ub294 Node.js 22.21+, 24.11+ \ub610\ub294 26+\ub97c \uc694\uad6c\ud55c\ub2e4\uace0 \uacf5\uc2dd \ubc1c\ud45c\uc740 \ubc1d\ud799\ub2c8\ub2e4. \uac1c\ubc1c\uc790\uc758 \ub85c\uceec Node\ub9cc \uc62c\ub9ac\uace0 CI\uc640 \ub7f0\ud0c0\uc784 \uc774\ubbf8\uc9c0\ub97c \uadf8\ub300\ub85c \ub450\uba74 \uc124\uce58 \ub610\ub294 \uc2e4\ud589 \ub2e8\uacc4\uc5d0\uc11c \uc608\uc0c1 \ubc16\uc758 \ubb38\uc81c\uac00 \ub0a9\ub2c8\ub2e4. .nvmrc<\/code>, package.json<\/code>\uc758 engines<\/code>, GitHub Actions setup-node, Docker base image\ub97c \uac19\uc740 \uc9c0\uc6d0 \ubc94\uc704\ub85c \ub9de\ucd94\uc138\uc694.<\/p>\n

\ubaa8\ub178\ub808\ud3ec\uc5d0\uc11c\ub294 \uc870\uac74\ubd80 export\uc640 \ud0c0\uc785 \ud574\uc11d\ub3c4 \ud655\uc778\ud574\uc57c \ud569\ub2c8\ub2e4. 4.6.1\uc740 nodenext<\/code> \uc544\ub798\uc5d0\uc11c nitropack\/types<\/code> \uc120\uc5b8\uc744 \ud574\uc11d\ud558\ub294 \uc218\uc815, \uc6cc\ud06c\uc2a4\ud398\uc774\uc2a4\/\ud328\ud0a4\uc9c0 \ub9e4\ub2c8\uc800 \ucc98\ub9ac\ub97c \ud3ec\ud568\ud569\ub2c8\ub2e4. \uc571 \ud558\ub098\ub9cc pnpm install<\/code>\ud574 \ubcf4\ub294 \ub300\uc2e0 \ub8e8\ud2b8 install, typecheck, production build\ub97c \ubaa8\ub450 \uc2e4\ud589\ud574\uc57c \uc2e4\uc81c \uacbd\ub85c \ubb38\uc81c\uac00 \ub4dc\ub7ec\ub0a9\ub2c8\ub2e4.<\/p>\n

\uac1c\ubc1c\uc790 \uc2e4\ud589 \uacc4\ud68d<\/h2>\n