{"id":901,"date":"2026-05-20T09:54:46","date_gmt":"2026-05-20T01:54:46","guid":{"rendered":"https:\/\/junai.ai\/blog\/nodejs-env-dotenv-17\/"},"modified":"2026-05-20T09:54:46","modified_gmt":"2026-05-20T01:54:46","slug":"nodejs-env-dotenv-17","status":"publish","type":"post","link":"https:\/\/junai.ai\/blog\/nodejs-env-dotenv-17\/","title":{"rendered":"\ud658\uacbd\ubcc0\uc218\uc640 dotenv \u2014 .env\ub85c \ube44\ubc00 \ubd84\ub9ac"},"content":{"rendered":"\n<!-- WordPress REST API \ubc1c\ud589\uc6a9 HTML (\uc790\ub3d9 \uc0dd\uc131) -->\n<!-- WP-FEATURED-MEDIA-ID: 848 -->\n<div style=\"max-width:800px;margin:0 auto;\">\n<style>\n:root {--color-primary:#059669;--color-accent:#10b981;--color-bg:#fafbfc;--color-bg-card:#fff;--color-text:#1a202c;--color-text-muted:#64748b;--hero-start:#064e3b;--hero-end:#059669;}\n*{box-sizing:border-box;}\n.container{max-width:760px;margin:0 auto;padding:0 24px 80px;}\n.hero{background:linear-gradient(135deg,var(--hero-start) 0%,var(--hero-end) 100%);color:#fff;padding:80px 24px 60px;text-align:center;}\n.hero .eyebrow{display:inline-block;font-size:14px;color:#6ee7b7;font-weight:700;letter-spacing:0.1em;text-transform:uppercase;margin-bottom:14px;}\n.hero h1{font-size:36px;margin:0 0 16px;line-height:1.3;font-weight:800;}\n.hero p{color:#d1fae5;font-size:18px;max-width:640px;margin:0 auto;line-height:1.6;}\n.hero img{width:100%;max-width:640px;height:auto;margin:32px auto 0;border-radius:10px;display:block;}\narticle{padding-top:48px;}\narticle h2{font-size:26px;margin:56px 0 20px;padding-left:14px;border-left:5px solid var(--color-accent);line-height:1.4;}\narticle h3{font-size:19px;margin:32px 0 12px;color:var(--color-primary);}\narticle p{margin:16px 0;}\narticle strong{color:var(--color-primary);font-weight:700;}\narticle code{background:#d1fae5;padding:2px 8px;border-radius:4px;font-family:'SF Mono',Menlo,Consolas,monospace;font-size:14px;color:#065f46;}\n.databox{background:#d1fae5;border-left:4px solid var(--color-accent);padding:16px 20px;margin:24px 0;border-radius:0 8px 8px 0;font-size:15.5px;}\n.databox strong{color:var(--color-primary);}\n.warnbox{background:linear-gradient(135deg,#fef3c7 0%,#fde68a 100%);padding:16px 20px;margin:24px 0;border-radius:8px;font-size:15.5px;}\n.tablewrap{overflow-x:auto;-webkit-overflow-scrolling:touch;margin:22px 0;}\ntable{width:100%;border-collapse:collapse;font-size:15px;background:var(--color-bg-card);}\nth,td{padding:11px 12px;text-align:left;border-bottom:1px solid #e2e8f0;vertical-align:top;}\nth{background:#f1f5f9;font-weight:700;color:#0f172a;}\ntd:first-child,th:first-child{font-weight:700;}\n@media (max-width:560px){.tablewrap table,.tablewrap thead,.tablewrap tbody,.tablewrap tr,.tablewrap th,.tablewrap td{display:block;width:auto;}.tablewrap thead{display:none;}.tablewrap tr{margin:0 0 14px;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden;}.tablewrap td{border:none;border-bottom:1px solid #f1f5f9;padding:9px 14px;}.tablewrap td:first-child{background:#f1f5f9;font-weight:800;font-size:15.5px;}.tablewrap td:last-child{border-bottom:none;}.tablewrap td[data-label]::before{content:attr(data-label) \" \u2014 \";font-weight:700;color:var(--color-primary);}}\n.code-block{background:#0f172a;color:#e2e8f0;padding:16px 20px;border-radius:8px;font-family:'SF Mono',Menlo,Consolas,monospace;font-size:14px;line-height:1.6;margin:20px 0;overflow-x:auto;white-space:pre;}\n.cta{background:linear-gradient(135deg,#059669 0%,#10b981 100%);color:#fff;padding:28px 24px;border-radius:12px;margin:48px 0 0;text-align:center;}\n.cta h3{color:#fff;margin:0 0 8px;font-size:20px;}\n.cta p{color:#d1fae5;margin:0;font-size:15.5px;}\n.footer-nav{margin-top:32px;padding-top:20px;border-top:1px solid #e2e8f0;font-size:14px;color:var(--color-text-muted);}\n.footer-nav a{color:var(--color-primary);text-decoration:none;}\n@media (max-width:480px){.hero h1{font-size:26px;}.hero p{font-size:16px;}article h2{font-size:21px;}article h3{font-size:17px;}body{font-size:16px;}}\n<\/style>\n<section class=\"hero\">\n  <span class=\"eyebrow\">Node.js \uad50\uc7ac \u00b7 17\ud3b8 \u00b7 \ud658\uacbd\ubcc0\uc218<\/span>\n  <h1>\ud658\uacbd\ubcc0\uc218\uc640 dotenv \u2014 .env\ub85c \ube44\ubc00 \ubd84\ub9ac<\/h1>\n  <p>DB \ube44\ubc00\ubc88\ud638\ub97c \ucf54\ub4dc\uc5d0 \ubc15\uc9c0 \ub9d0 \uac83. .env \ud55c \uc904\uc774 \ud3c9\uc0dd \uc0ac\uace0 \ubc29\uc9c0.<\/p>\n  <img decoding=\"async\" src=\"https:\/\/junai.ai\/blog\/wp-content\/uploads\/2026\/05\/hero-5-79.jpg\" alt=\"env \ud30c\uc77c\uc5d0\uc11c \ube44\ubc00 \uc124\uc815\uc774 \ud504\ub85c\uc138\uc2a4\ub85c \ud750\ub974\ub294 \ucee8\uc149 \uc77c\ub7ec\uc2a4\ud2b8\">\n<\/section>\n\n<div class=\"container\">\n<article>\n\n<p>\uc2e4\uc218 1\uc704 \u2014 DB \ube44\ubc00\ubc88\ud638\u00b7API \ud0a4\ub97c \ucf54\ub4dc\uc5d0 \ubc15\uc544 GitHub \uc5d0 \uc62c\ub9ac\ub294 \uac83. \uacf5\uac1c \uc800\uc7a5\uc18c\uba74 1\ubd84 \ub0b4 \ubd07\uc774 \uc2a4\uce94\ud574 \uac00\uc838\uac04\ub2e4. \ube44\uacf5\uac1c\ub77c\ub3c4 \ud300\uc6d0\u00b7\uc678\ubd80 \uacc4\uc57d\uc790\uac00 \ubaa8\ub450 \ubcf4\uac8c \ub428.<\/p>\n\n<p>\ud574\ub2f5\uc740 \ub2e8\uc21c \u2014 <strong>\uc124\uc815\uac12\uc744 \ucf54\ub4dc\uc640 \ubd84\ub9ac<\/strong>. \ud658\uacbd\ubcc0\uc218\uac00 \ud45c\uc900 \ub3c4\uad6c. <code>.env<\/code> \ud30c\uc77c\ub85c \ub85c\uceec \uad00\ub9ac, production \uc740 \ud638\uc2a4\ud305 \ud658\uacbd \ubcc0\uc218\ub85c. Node 22 \ubd80\ud130\ub294 dotenv \ud328\ud0a4\uc9c0\ub3c4 \ud544\uc694 \uc5c6\uc774 <strong>\ub0b4\uc7a5<\/strong>\uc73c\ub85c \uac00\ub2a5.<\/p>\n\n<h2>1. process.env \u2014 Node \uc758 \uae30\ubcf8 \ucc3d\uad6c<\/h2>\n\n<p>Node \uac00 \uc790\ub3d9\uc73c\ub85c \uc81c\uacf5\ud558\ub294 \uac1d\uccb4. OS \ud658\uacbd\ubcc0\uc218\uc640 \ubd80\ubaa8 \ud504\ub85c\uc138\uc2a4\uc5d0\uc11c \ubc1b\uc740 \uac12\uc774 \ub2e4 \ub4e4\uc5b4 \uc788\ub2e4.<\/p>\n\n<div class=\"code-block\">\/\/ server.js\nconsole.log(process.env.HOME);    \/\/ &#8216;\/home\/user&#8217;\nconsole.log(process.env.PATH);    \/\/ &#8216;\/usr\/bin:\/bin:&#8230;&#8217;\nconsole.log(process.env.PORT);    \/\/ undefined (\uc124\uc815 \uc548 \ud588\uc73c\uba74)\n\nconst port = Number(process.env.PORT ?? 3000);\napp.listen(port);<\/div>\n\n<p>\uc8fc\uc758 \u2014 <strong>\ubaa8\ub4e0 \uac12\uc774 \ubb38\uc790\uc5f4<\/strong>. \uc22b\uc790\uac00 \ud544\uc694\ud558\uba74 <code>Number()<\/code>, \ubd88\ub9ac\uc5b8\uc774\uba74 <code>=== 'true'<\/code> \ube44\uad50. \ud658\uacbd\ubcc0\uc218\uac00 \uc5c6\uc73c\uba74 <code>undefined<\/code>. <code>??<\/code> \ub610\ub294 <code>||<\/code> \ub85c \uae30\ubcf8\uac12.<\/p>\n\n<h2>2. .env \ud30c\uc77c \u2014 \ub85c\uceec \ube44\ubc00 \ubd84\ub9ac<\/h2>\n\n<p>\ud504\ub85c\uc81d\ud2b8 \ub8e8\ud2b8\uc5d0 <code>.env<\/code> \ud30c\uc77c:<\/p>\n\n<div class=\"code-block\"># .env\nDATABASE_URL=postgres:\/\/user:pass@localhost:5432\/mydb\nJWT_SECRET=super-long-random-string-at-least-32-chars\nAPI_KEY_OPENAI=sk-abc123&#8230;\nNODE_ENV=development\nPORT=3000<\/div>\n\n<p>\uaddc\uc57d \u2014 <code>KEY=value<\/code>, \ud55c \uc904 \ud55c \ubcc0\uc218, \ub530\uc634\ud45c \ubcf4\ud1b5 \uc548 \uc500. \uac19\uc740 \uc904 \uc8fc\uc11d\uc740 <code>#<\/code>.<\/p>\n\n<div class=\"warnbox\">\n<strong>.gitignore \uc5d0 \ubb34\uc870\uac74 \ucd94\uac00<\/strong> \u2014 <code>.env<\/code> \ub294 \uc808\ub300 git \uc5d0 \ucee4\ubc0b \uae08\uc9c0. <code>.gitignore<\/code> \uccab \uc904\uc5d0 <code>.env*<\/code> \ubc15\uc544\ub450\uae30. \ub300\uc2e0 <code>.env.example<\/code> (\uac12 \ube48 \ud0a4 \ubaa9\ub85d)\uc740 \ucee4\ubc0b\ud574\uc11c \ud300\uc6d0\uc774 \uc5b4\ub5a4 \ubcc0\uc218\uac00 \ud544\uc694\ud55c\uc9c0 \uc54c\uac8c.\n<\/div>\n\n<h2>3. Node 22 \ub0b4\uc7a5 dotenv \u2014 \ud328\ud0a4\uc9c0 \uc5c6\uc774<\/h2>\n\n<p>\uc61b\ub0a0\uc5d4 <code>dotenv<\/code> npm \ud328\ud0a4\uc9c0\uac00 \ud45c\uc900\uc774\uc5c8\ub294\ub370 Node 20.6 \ubd80\ud130 \ub0b4\uc7a5. 22 \uc5d0\uc120 \uc815\uc2dd stable.<\/p>\n\n<div class=\"code-block\">$ node &#8211;env-file=.env server.js<\/div>\n\n<p>\uc774 \ud55c \uc904\ub85c <code>.env<\/code> \uc758 \ubaa8\ub4e0 \uac12\uc774 <code>process.env<\/code> \uc5d0 \uc790\ub3d9 \uc8fc\uc785. \ud328\ud0a4\uc9c0 import \ub3c4 \ucf54\ub4dc \ubcc0\uacbd\ub3c4 \ud544\uc694 \uc5c6\ub2e4. <code>package.json<\/code> scripts \uc5d0 \ubc15\uc544\ub450\uba74 \ub354 \ud3b8\ud568.<\/p>\n\n<div class=\"code-block\">\/\/ package.json\n{\n  &#8220;scripts&#8221;: {\n    &#8220;dev&#8221;:   &#8220;node &#8211;env-file=.env &#8211;watch server.js&#8221;,\n    &#8220;start&#8221;: &#8220;node &#8211;env-file=.env server.js&#8221;\n  }\n}<\/div>\n\n<p>\uc5ec\ub7ec \ud30c\uc77c\ub3c4 \uac00\ub2a5 \u2014 <code>--env-file=.env --env-file=.env.local<\/code>. \ub4a4 \ud30c\uc77c\uc774 \ub36e\uc5b4\uc4f4\ub2e4. \uc61b dotenv \ud328\ud0a4\uc9c0\uc758 <code>NODE_ENV<\/code> \uc790\ub3d9 \ub9e4\ud551\uc774 \ud544\uc694\ud558\uba74 \uc544\uc9c1 \uadf8\uac78 \uc368\ub3c4 \ub428.<\/p>\n\n<h2>4. NODE_ENV \u2014 \ud658\uacbd \ubd84\uae30\uc758 \ud45c\uc900 \ud0a4<\/h2>\n\n<p>Node \uc0dd\ud0dc\uacc4\uc758 \uc57d\uc18d\ub41c \ubcc0\uc218. <code>development<\/code> \u00b7 <code>production<\/code> \u00b7 <code>test<\/code> \uc138 \uac12\uc774 \ud45c\uc900.<\/p>\n\n<div class=\"code-block\">if (process.env.NODE_ENV === &#8216;production&#8217;) {\n  \/\/ \uc5d0\ub7ec \uc2a4\ud0dd \uc228\uae40\u00b7\ub85c\uadf8 \ucd5c\uc18c\ud654\u00b7\uce90\uc2dc \uc801\uadf9 \uc0ac\uc6a9\n  app.use(compression());\n} else if (process.env.NODE_ENV === &#8216;test&#8217;) {\n  \/\/ \ud14c\uc2a4\ud2b8 DB \uc0ac\uc6a9\n  db = new TestDatabase();\n} else {\n  \/\/ \uac1c\ubc1c: \uc790\uc138\ud55c \ub85c\uadf8\u00b7hot reload\n  app.use(morgan(&#8216;dev&#8217;));\n}<\/div>\n\n<p>\ub9ce\uc740 \ub77c\uc774\ube0c\ub7ec\ub9ac(Express\u00b7React\u00b7Vue)\uac00 \uc790\ub3d9\uc73c\ub85c NODE_ENV \ub97c \ud655\uc778\ud574 production \ucd5c\uc801\ud654\ub97c \ucf20\ub2e4. <strong>\ubc30\ud3ec \ud658\uacbd\uc5d0\uc120 \ubb34\uc870\uac74 <code>NODE_ENV=production<\/code><\/strong> \uc124\uc815 \u2014 \uc548 \ud558\uba74 \ub77c\uc774\ube0c\ub7ec\ub9ac\ub4e4\uc774 dev \ubaa8\ub4dc\ub85c \ub3cc\uc544 \ub290\ub9bc.<\/p>\n\n<h2>5. \uac80\uc99d \u2014 Zod \ub85c \uc2dc\uc791\ud560 \ub54c \ud55c \ubc88<\/h2>\n\n<p>\uac00\uc7a5 \ud070 \uc0ac\uace0 \u2014 <strong>\ud544\uc218 \ud658\uacbd\ubcc0\uc218 \ub204\ub77d<\/strong>\uc778\ub370 \ubaa8\ub974\uace0 \uc11c\ubc84 \uc2dc\uc791. \uccab \uc694\uccad\uc5d0\uc11c\uc57c <code>undefined.length<\/code> \uac19\uc740 \uc5d0\ub7ec\ub85c \uae68\uc9d0. \uc0c8\ubcbd \uc0ac\uace0.<\/p>\n\n<p>\ub300\ube44 \u2014 \uc11c\ubc84 \uc2dc\uc791 \uc2dc\uc810\uc5d0 \ubaa8\ub4e0 \ud658\uacbd\ubcc0\uc218\ub97c \ud55c \ubc88\uc5d0 \uac80\uc99d.<\/p>\n\n<div class=\"code-block\">\/\/ env.js\nimport { z } from &#8216;zod&#8217;;\n\nconst Env = z.object({\n  NODE_ENV: z.enum([&#8216;development&#8217;, &#8216;production&#8217;, &#8216;test&#8217;]),\n  DATABASE_URL: z.string().url(),\n  JWT_SECRET: z.string().min(32),\n  PORT: z.string().regex(\/^\\\\d+$\/).transform(Number).default(&#8216;3000&#8217;),\n  API_KEY_OPENAI: z.string().startsWith(&#8216;sk-&#8216;),\n});\n\nconst parsed = Env.safeParse(process.env);\nif (!parsed.success) {\n  console.error(&#8216;\u274c \ud658\uacbd\ubcc0\uc218 \uc624\ub958:&#8217;);\n  console.error(parsed.error.flatten().fieldErrors);\n  process.exit(1);\n}\n\nexport const env = parsed.data;   \/\/ \ud0c0\uc785 \ucd94\ub860\uae4c\uc9c0 \uc790\ub3d9\nconsole.log(&#8216;\u2705 \ud658\uacbd\ubcc0\uc218 OK&#8217;);<\/div>\n\n<p>\uc774\uc81c \ucf54\ub4dc\uc5d0\uc11c <code>process.env.PORT<\/code> \ub300\uc2e0 <code>env.PORT<\/code> \u2014 \ud0c0\uc785 \uc548\uc804 + \ub204\ub77d \uac80\ucd9c. \uc11c\ubc84\ub294 \uc798\ubabb\ub41c \uc124\uc815\uc73c\ub85c \uc808\ub300 \uc2dc\uc791\ud558\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n<div class=\"databox\">\n<strong>\uc65c \uac80\uc99d\uc774 \uc911\uc694\ud55c\uac00<\/strong> \u2014 \ud658\uacbd\ubcc0\uc218 \uc624\ud0c0\u00b7\ub204\ub77d\uc740 production \uc5d0\uc11c \uac00\uc7a5 \uc790\uc8fc \uc77c\uc5b4\ub098\ub294 \uc0ac\uace0. \uc0c8 \uc11c\ubc84 \ubc30\ud3ec \uc2dc \ud658\uacbd\ubcc0\uc218 \ud55c \uc904 \ube7c\uba39\uc5b4 \uc77c\uc694\uc77c \uc0c8\ubcbd \ud638\ucd9c \ubc1b\uae30 \uc2eb\uc73c\uba74, Zod \uac80\uc99d 12\uc904\uc774 \uac00\uc7a5 \uc2fc \ubcf4\ud5d8. \ud68c\uc0ac \ucf54\ub4dc\ub77c\uba74 \ubb34\uc870\uac74.\n<\/div>\n\n<h3>\uc694\uc57d \u2014 17\ud3b8 \uc88c\ud45c<\/h3>\n\n<p>\uc5ec\uae30\uae4c\uc9c0 \uc815\ub9ac. <strong><code>process.env<\/code><\/strong> \ub294 \ubaa8\ub4e0 \uac12\uc774 \ubb38\uc790\uc5f4 \u2192 \ubcc0\ud658 \ud544\uc694. \ub85c\uceec \ube44\ubc00\uc740 <strong><code>.env<\/code><\/strong> \ud30c\uc77c + <strong><code>.gitignore<\/code><\/strong> \ud544\uc218, \ud300 \uacf5\uc720\ub294 <code>.env.example<\/code>. Node 22 \ubd80\ud130 <strong><code>--env-file=.env<\/code><\/strong> \ud55c \uc904\ub85c \ud328\ud0a4\uc9c0 \uc5c6\uc774 \ub3d9\uc791. <strong>NODE_ENV<\/strong> \ub294 \ud45c\uc900 \ubd84\uae30 \ud0a4 \u2014 production \uc5d0\uc120 \ubc18\ub4dc\uc2dc \uc124\uc815. \uc11c\ubc84 \uc2dc\uc791 \uc2dc <strong>Zod \ub85c \uac80\uc99d<\/strong> \ud55c \ubc88\uc774\uba74 \ub204\ub77d \uc0ac\uace0 \ubc29\uc9c0. \ub2e4\uc74c \ud3b8\uc5d0\uc11c \uc9c4\uc9dc DB \uc5f0\ub3d9 \u2014 <strong>node-postgres<\/strong>.<\/p>\n\n<div class=\"cta\">\n<h3>\ub2e4\uc74c \ud3b8 \uc608\uace0 \u2014 PostgreSQL \uc5f0\ub3d9<\/h3>\n<p>node-postgres(pg) \ub85c CRUD. 18\ud3b8.<\/p>\n<\/div>\n\n<div class=\"footer-nav\">\n\uc2dc\ub9ac\uc988 \u00b7 <a href=\"https:\/\/junai.ai\/blog\/category\/nodejs\/\">\uc27d\uac8c \ubc30\uc6b0\ub294 Node.js<\/a> \u00b7 \uc774\uc804: <a href=\"https:\/\/junai.ai\/blog\/nodejs-error-handling-16\/\">Ch.16 \uc5d0\ub7ec \ucc98\ub9ac<\/a>\n<\/div>\n\n<\/article>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Node \ud658\uacbd\ubcc0\uc218 \u2014 .env \ubd84\ub9ac\u00b7Node 22 \ub0b4\uc7a5 dotenv\u00b7NODE_ENV\u00b7Zod \uac80\uc99d. \ube44\ubc00 \ub204\ucd9c \ubc29\uc9c0. \uad50\uc7ac 17\ud3b8.<\/p>\n","protected":false},"author":1,"featured_media":848,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[24],"tags":[],"class_list":["post-901","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-nodejs"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/901","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/comments?post=901"}],"version-history":[{"count":0,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/901\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media\/848"}],"wp:attachment":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media?parent=901"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/categories?post=901"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/tags?post=901"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}