[11] AWS EC2에 Node.js & 애플리케이션 설치하기

• 목표 : AWS EC2 인스턴스에 Express.js 기반 Node.js 애플리케이션을 배포하고, 외부에서 80/3000 포트로 접속
• 주요 기술: EC2, AMI, 보안 그룹, SSH 키 페어, Node.js(22.x), npm, Express, PM2, Nginx

환경:
 Amazon Linux 2023 (ap-northeast-2)

앱:
 Express.js 기반 간단한 “Hello from EC2 Express!” 서버

운영 도구:
 PM2(프로세스 매니저), Nginx(리버스 프록시), Let’s Encrypt SSL

 

 

 

 

---

 

AWS EC2에 Node.js(Express) 앱 배포하기: A to Z

이 게시물의 목차를 먼저 정리해둔다.

1. EC2 인스턴스 준비 (이건 전 게시물에 이미 올려서 스킵)

2025.06.12 - [🇰🇷 한국어 (Korean)/AWS] - [9] EC2 인스턴스 연결

2. Node.js & 애플리케이션 설치
  2.1 Node.js 설치 (NodeSource)
  2.2 프로젝트 초기화 및 Express 설치
  2.3 package.json 설정
  2.4 index.js 작성
  2.5 테스트 실행

3. PM2로 백그라운드 실행

4. Nginx 리버스 프록시 설정
   4.1 설치
   4.2 설정 파일 /etc/nginx/conf.d/my-node-app.conf 생성
   4.3 검증 & 재시작
   4.4 확인


5. 도메인(Route 53) 연결
  5.1 Route 53 → 호스팅 영역(Hosted zones) → trill-server.com 선택
  5.2 레코드 생성(Create record)
  5.3 저장 후 dig +short trill-server.com → IP 확인


6. HTTPS 적용 (Let’s Encrypt)
  6.1 보안 그룹: HTTPS(443) → 0.0.0.0/0 추가
  6.2 Certbot 설치
  6.3 인증서 발급 & 설치
  6.4 자동 갱신
  6.5 확인

[9] EC2 인스턴스 연결

 

---

이 게시물은 
목차에서 보이는 

2. Node.js & 애플리케이션 설치
  2.1 Node.js 설치 (NodeSource)
  2.2 프로젝트 초기화 및 Express 설치
  2.3 package.json 설정
  2.4 index.js 작성
  2.5 테스트 실행

를 차근차근 하면서 겪은 시행착오들까지 모두 기록한 것이다.

---

< 배포 단계에서 Node.js 설치와 애플리케이션(Express 코드) 배치가 반드시 필요한 이유 >


1. 런타임 환경(provisioning) 확보
Node.js는 JavaScript 코드를 실행해 주는 서버 측 런타임이다.
EC2는 단지 “빈 컴퓨터”이기 때문에, 내가 쓴 서버 코드(Express, TypeScript 등)를 실행하려면
그에 맞는 런타임(Node.js)과 패키지 관리자(npm)가 반드시 설치되어 있어야 한다.


2. 의존성(dependencies) 설치
 package.json에 명시된 Express, CORS, dotenv 같은 외부 라이브러리들을
npm install 명령으로 실제 서버에 내려받고 설치해야만,
서버 코드에서 import express from 'express' 같은 구문이 에러 없이 동작한다.


3. 애플리케이션 코드 배치 & 실행
  3.1 코드 복사 - 로컬 코드(또는 빌드 산출물)를 EC2로 전송 
  3.2 환경 구성 - .env 파일, 로그 디렉터리, 실행 스크립트 등 앱 실행에 필요한 설정 추가
  3.3 서버 실행 - node index.js 또는 PM2/systemd로 백그라운드 실행


이 과정을 “애플리케이션 레이어(Application Layer)” 를 EC2 인스턴스 위에 올려 주는 단계라고 볼 수 있다.




정리
1. Node.js 설치 → JavaScript 서버 코드 실행 기반 마련
2. npm install → 외부 라이브러리(Express 등) 설치
3. 코드 배치 & 실행 → 실제 HTTP 서버 / API 서버 가동
   이 세 가지가 없으면, EC2에 아무리 인스턴스를 띄워도 나의 서버 코드는 “해석할 환경” 자체가 없어서 단 한 줄도 실행되지 않는다. 따라서 배포 단계의 핵심 필수 작업으로 반드시 수행해야 한다.



그럼 나는 왜 Spring Boot 앱을 배포할 목적인데 Node.js/Express 앱 배포 과정을 선행할까?

AWS 인프라 구성, 보안 그룹, Nginx 리버스 프록시, 도메인·SSL 연결 같이 “어떻게 클라우드 위에서 웹 서비스를 띄우고 운영하는지”의 기본기를 다지는게 목표이기 때문이다. 

 

 

자, 그럼 시작해보자

---

1. Node.js 설치하는 법.

 

Amazon Linux 2023에서 Node.js를 설치하는 방법은 크게 두 가지가 있다.

아래 예시를 참고해서 편한 쪽을 골라 진행하면 된다.

하지만 나는 첫번째 방법에서 실패를 겪었기 때문에 두번째를 따라하는것을 권장한다.

---

방법 1. DNF 모듈을 이용한 설치 (Amazon Linux 2023 기본 방식) - 이건 실패 방법이니 바로 방법2를 따라하세요!

 

1. 시스템 패키지 최신화

sudo dnf update -y

 

 

 

 

 

 

2. 사용 가능한 Node.js 모듈 스트림 확인

sudo dnf module list nodejs

로 치니

 

[ec2-user@ip-172-31-44-167 ~]$ sudo dnf module list nodejs
Last metadata expiration check: 0:41:47 ago on Thu Jun 12 09:03:32 2025.
Error: No matching Modules to list라고 나왔다.

Amazon Linux 2023에서는 RHEL 계열처럼 dnf module을 통한 Module Stream 방식이 아니라, 
기본 레포지토리에 Node.js 패키지가 바로 들어있거나, 외부 RPM 저장소를 추가해서 설치하는 형태로 배포된다.

 

 

그래서 방법 2를 선택하여야 한다. 

---

방법 2. NodeSource RPM 저장소 이용 (Red Hat 계열 공통)

 

1. 시스템 패키지 최신화

sudo dnf update -y

 

 

업데이트 메시지에 “A newer release of Amazon Linux is available” 경고가 뜨지만, 현재 시스템에 설치된 패키지에는 할 일이 없다는 뜻이니 그냥 넘어가도 된다.

 

 

 

 

2. NodeSource 설치 스크립트 다운로드 & 실행

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -

 

NodeSource 레포지토리만 추가된 상태이다.이제 실제로 Node.js 패키지를 설치하면 된다!

 

 

 

 

 

 

 

다음 단계로!

 

 

---

< 이제 여기서 하게 될  하는 과정의 이유와 목적 설명 >

1. 런타임 설치 확인 → “Node.js가 EC2에서 문제없이 동작한다”
2. 앱 환경 구성 → “의존성 관리(package.json), ES 모듈 설정(type:module)”
3. 최소 웹 서버 띄우기 → “네트워크 레이어(Nginx→3000포트)까지 연동하기에 앞서 순수 Node.js 서비스가 정상 작동”


이렇게 “런타임 → 의존성 → 코드 → 실행”의 흐름 전체를 한 번 점검해 두면,
다음 단계인 PM2/NGINX/SSL 설정이나 CI/CD 자동화로 넘어갔을 때
“어디서 문제가 생겨도 원인이 런타임인지, 코드인지, 배포 파이프라인인지”를
빠르게 구분할 수 있다.

즉, 이 과정은 “배포 전 검증” 겸 “앱 부트스트랩” 단계이다.

 

 

2. Node.js & 애플리케이션 설치

 

2.1 Node.js 설치

sudo dnf install -y nodejs

node -v
npm -v

설치 확인된 명령어를 실행해보자. 

 

 

 

제대로 설치가 되었다.

 

---

이제 간단히 “[Hello, EC2!]” 찍어보면서 테스트 해 보자!

 

 

1) 터미널에서 바로 확인하기

node -e 'console.log("✅ Node.js is working!");'

 

위 명령어를 입력하면 터미널에 ✅ Node.js is working! 이 출력된다.

 

 

 

---

 

2) 간단한 Express 서버 띄워 보기

1. 새 디렉터리 생성 & 진입

mkdir ~/my-node-app && cd ~/my-node-app

 

 

 

 

2. 프로젝트 초기화 & Express 설치

npm init -y
npm install express

 

---

문제 발생!! 문제 해결하고 가기!

 

지금 터미널 로그를 보니, 두 가지가 섞여 있다.

 

1. 에러 없이 npm init·npm install express 까진 잘 실행 → package.json 파일이 생성됐고, express 모듈도 설치됨
2. 그 다음에 “node index.js”를 실행했지만, index.js 파일이 없어서 아래와 같은 오류 메시지가 뜬다. 

Error: Cannot find module '/home/ec2-user/my-node-app/index.js'

 

즉,

문제 요약

문제: index.js 파일이 없어서 Node가 실행할 진입점(엔트리) 모듈을 찾을 수 없음.
발생 단계: “애플리케이션 코드 작성 단계” — 런타임(환경) 준비가 끝나고 실제 서버 코드를 만들어서 실행해 보는 단계이다.

 

해결책

1. 프로젝트 디렉터리로 이동

cd ~/my-node-app

 

 

 

  2. index.js 파일 생성 & 코드 작성 - 편집기(예: vi, nano)로 열고 아래 코드를 붙여 넣어야 한다.

vi index.js

를 입력하면

이러한 창이 뜨고 아래의 명령어를 입력해주면 된다. 

import express from 'express';

const app = express();
const PORT = 3000;

app.get('/', (req, res) => {
  res.send('Hello from EC2 Express!');
});

app.listen(PORT, () => {
  console.log(`🚀 Server listening on http://localhost:${PORT}`);
});

Vi 사용법 :
1) i 눌러 INSERT 모드 진입코드를 붙여넣기
2)  Esc → :wq → Enter 로 저장 후 종료


Nano 사용법:
1) 코드 붙여넣기
2) Ctrl+O → Enter (저장)
3) Ctrl+X (종료)

 

 

 

 

3. package.json에 ES 모듈 타입 지정

package.json에 다음 한 줄을 추가해야 import 문법이 먹힌다.

 

또 아래의 명령어를 쳐서  package.json 파일 내용을 수정해야 한다. 

vi package.json

 

 

{
  "name": "my-node-app",
  "version": "1.0.0",
  "type": "module",           // ES 모듈 사용 선언
  "main": "index.js",         // 진입 파일
  "scripts": {
    "start": "node index.js"  // 나중에 npm start 로 실행 가능
  },
  "dependencies": {
    "express": "^4.18.2"      // 이미 설치된 express 버전
  }
}

 

 

 

정상 실행 되어서 터미널에 아래와 같은 메시지가 나타났다. 

🚀 Server listening on http://localhost:3000

 

 

한눈에 단계 정리


1. vi index.js (또는 nano index.js)
2. JS 코드 붙여넣기 → 저장
3. package.json에 "type":"module" 추가
4. node index.js로 실행


이렇게 하시면 Bash가 아니라 Node가 코드를 실행하게 되어 에러 없이 서버가 뜬다.

---