Node.js에서 환경 변수를 설정하는 방법

최신 소프트웨어에는 유연성, 확장성 및 강력한 보안이 필요합니다. 환경 변수는 이러한 균형을 달성하는 데 중요한 역할을 합니다. 이 가이드에서는 보안 및 유지 관리에 대한 모범 사례를 강조하면서 Node.js 애플리케이션 내에서 환경 변수를 설정하고 관리하는 다양한 방법을 살펴봅니다. 시작 검증부터 민감한 데이터 노출 방지까지 모든 것을 다룹니다. 노련한 개발자이든 Node.js를 처음 접하는 개발자이든 이 정보는 안전하고 적응 가능한 애플리케이션을 구축하는 데 필수적입니다.

환경변수란 무엇인가요?

환경 변수는 애플리케이션의 코드베이스 외부, 일반적으로 구성 파일이나 시스템 설정에 저장되는 키-값 쌍입니다. API 키 및 데이터베이스 자격 증명과 같은 민감한 데이터를 보유하여 하드 코딩을 방지하고 보안을 향상시킵니다. 이 접근 방식은 다양한 환경(개발, 테스트, 생산) 전반에 걸쳐 관리를 단순화합니다.

Node.js에서는 환경 변수를 사용하면 코드 수정 없이 동적 애플리케이션 구성이 가능합니다. 동일한 코드베이스가 환경에 따라 다양한 데이터베이스 또는 API와 상호 작용하여 보안을 강화하고 배포를 단순화하며 적응성을 높일 수 있습니다.

표준 JavaScript 변수와 달리 환경 변수는 코드 내에 정의되지 않습니다. process.env을 통해 액세스하고 독립적으로 존재하며 잠재적으로 시스템의 여러 애플리케이션에 영향을 미칠 수 있습니다.

Node.js에서 환경 변수에 액세스

Node.js는 process.env 객체를 사용하여 환경 변수에 액세스하고 관리합니다. 변수의 값을 검색하려면 process.env.VARIABLE_NAME을 사용하세요. 예를 들어 process.env.API_KEY은 API_KEY과 연관된 값을 검색합니다. 코드 내에서 환경 변수를 설정하는 것은 기술적으로 가능하지만 일반적으로 권장되지 않습니다. 애초에 환경 변수 사용의 이점을 무효화합니다.

Express API에서 API_KEY를 사용하는 방법은 다음과 같습니다.

const express = require('express');
const app = express();

// Access API key from environment variables
const apiKey = process.env.API_KEY;

if (!apiKey) {
  console.error('Error: API key is not defined.');
  process.exit(1);
}

app.get('/', (req, res) => {
  res.send('API key successfully loaded.');
});

// Start the server
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

Node.js에서 환경 변수 설정

이제 환경 변수를 설정하는 다양한 방법을 살펴보겠습니다.

1. dotenv 사용: dotenv 패키지는 환경 변수를 코드에서 분리하여 관리를 단순화합니다. .env 파일에서 키-값 쌍을 정의합니다.

<code>PORT=3000
DB_USERNAME=dbuser</code>

다음과 같이 가져오고 사용하세요.

import * as dotenv from 'dotenv';
dotenv.config();

console.log(process.env.PORT); // Output: 3000
console.log(process.env.DB_USERNAME); // Output: dbuser

.env을 사용하여 대체 dotenv.config({ path: './path/to/another.env' }) 파일 경로를 지정할 수 있습니다. 개발에는 유용하지만 제작에는 다른 방법을 고려해 보세요.

2. 시스템 수준 설정: Unix 계열 시스템(Linux, macOS)에서는 셸 구성 파일에 변수를 추가합니다(예: ~/.bashrc, ~/.zshrc). 이는 해당 셸 세션의 모든 프로세스에 영향을 미칩니다. 예:

const express = require('express');
const app = express();

// Access API key from environment variables
const apiKey = process.env.API_KEY;

if (!apiKey) {
  console.error('Error: API key is not defined.');
  process.exit(1);
}

app.get('/', (req, res) => {
  res.send('API key successfully loaded.');
});

// Start the server
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

터미널을 다시 시작하거나 source ~/.bashrc을 실행하여 변경 사항을 적용하세요. 시스템 전체 액세스(시스템 프로세스)의 경우 /etc/environment.

를 사용하세요.

3. 스크립트 시작: 변수를 설정한 다음 Node.js 애플리케이션을 실행하는 스크립트를 만듭니다(예: launch.sh):

<code>PORT=3000
DB_USERNAME=dbuser</code>

실행 가능하게 만들고(chmod x launch.sh) 실행합니다(./launch.sh).

4. PM2(프로세스 관리자 2): PM2에서는 애플리케이션 시작 중에 환경 변수를 설정할 수 있습니다.

import * as dotenv from 'dotenv';
dotenv.config();

console.log(process.env.PORT); // Output: 3000
console.log(process.env.DB_USERNAME); // Output: dbuser

또는 환경별 구성을 위해 ecosystem.config.js 파일을 사용하세요.

5. Docker: Docker에서 Dockerfile:ENV를 사용하여
에 변수를 설정합니다.

# ~/.bashrc
export PORT=3000
export DB_USERNAME=myuser

-e PORT=5173을 사용하거나 docker-compose.yml 파일 내에서 컨테이너를 실행할 때 기본값을 재정의합니다.

환경 변수 사용 모범 사례

안전하고 유지 관리가 가능한 애플리케이션을 위해 다음 모범 사례를 따르세요.

• 설명적인 이름 및 문서: 명확하고 설명적인 이름을 사용하고 프로젝트의 README에 해당 목적을 기록하세요.

• 시작 유효성 검사: 애플리케이션 시작 시 환경 변수가 올바르게 설정되었는지 확인합니다. 누락된 변수를 적절하게 처리합니다(기본값 또는 오류 처리).

• .env 파일 제외: .env을 사용하여 버전 관리(Git)에서 .gitignore 파일을 제외합니다.

• KMS(키 관리 시스템) 고려: 특히 매우 민감한 데이터의 경우 보안을 강화하려면 KMS를 사용하여 환경 변수를 암호화하고 저장하세요.

• 기본값: 중요하지 않은 환경 변수에 기본값을 제공하여 변수가 누락된 경우에도 애플리케이션 기능을 보장합니다.

• 프런트엔드에 노출하지 마세요: 민감한 환경 변수를 클라이언트측 코드에 직접 노출하지 마세요.

서기의 환경변수 사용

Clerk SDK는 Clerk 대시보드 내의 구성 및 애플리케이션 연결을 위해 환경 변수를 활용합니다. 이를 통해 Express를 사용하여 보안 백엔드 요청 및 프런트엔드 검증이 가능해졌습니다. 예:

#!/bin/bash
export PORT=3000
export DB_USERNAME=myuser
node app.js

결론

환경변수를 안전하게 관리하는 것이 무엇보다 중요합니다. 이러한 모범 사례를 따르면 Node.js 애플리케이션의 보안과 유지 관리 가능성이 크게 향상되어 프로덕션 배포에 대비할 수 있습니다.

위 내용은 Node.js에서 환경 변수를 설정하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!