02642025년 8월 7일

[Node.js] Node.js + Express 입문: 설치부터 서버 실행까지 따라하기

프론트엔드 개발을 하다 보면 백엔드 서버와 연결할 일이 종종 생긴다.

그럴 때 가장 쉽고 빠르게 시작할 수 있는 백엔드 환경이 바로 Node.js + Express 조합이다.

이번 포스팅에서는 Node.js 설치부터, Express 서버를 띄우는 전 과정을 아주 쉽게 정리해보겠다.

1단계: Node.js 설치하기

Node.js는 자바스크립트를 브라우저 밖, 즉 컴퓨터 환경에서도 실행할 수 있게 만들어주는 런타임이다.

원래 자바스크립트는 크롬이나 사파리 같은 브라우저 안에서만 작동했지만, Node.js를 설치하면 브라우저가 아닌 터미널(명령창)에서도 자바스크립트로 백엔드 프로그램을 만들 수 있다.

1. 공식 사이트에서 설치

Node.js 공식 웹사이트 접속
권장 LTS 버전 다운로드 및 설치 (예: 20.x.x LTS)
- LTS는 안정적으로 오래 지원되는 버전이므로 가장 추천된다.

2. 설치 확인

: 설치가 완료되면 터미널(명령 프롬프트)에서 아래 명령어로 확인할 수 있다:

code

node -v    # node 버전 확인
npm -v     # npm (패키지 관리자) 버전 확인

node는 자바스크립트를 실행시키는 명령어
npm은 Node.js에서 라이브러리나 툴을 설치할 수 있게 해주는 패키지 관리자

2단계: 프로젝트 디렉토리 만들기

이제 우리가 만들 서버 코드를 넣을 폴더를 만들고, Node.js 프로젝트로 초기화해보자.

code

mkdir my-server    # 폴더 생성
cd my-server       # 폴더 이동
npm init -y        # 기본 package.json 생성

npm init은 현재 폴더를 Node.js 프로젝트로 등록해주는 명령어이다.
실행 후 자동으로 package.json이라는 파일이 생긴다.
- 이 파일은 앞으로 설치하게 될 모든 라이브러리 정보와 실행 스크립트 등을 담는 프로젝트의 설정 파일이다.
-y는 기본 설정값으로 모두 ‘Yes’를 선택하는 옵션이라, 빠르게 설정할 수 있다.

3단계: Express 설치하기

이제 우리가 사용할 웹 서버 프레임워크인 Express를 설치해보자.

code

npm install express

express는 HTTP 요청, 응답을 쉽게 처리할 수 있게 도와주는 백엔드 프레임워크다.
설치가 완료되면 package.json의 dependencies에 자동으로 등록된다.
node_modules 폴더도 생기는데, 이 안에는 express를 포함한 많은 라이브러리 파일들이 들어있다.

4단계: 기본 서버 코드 작성

이제 실제로 서버를 만드는 자바스크립트 파일을 만들어보자.

index.js 파일을 만들고 아래 코드를 입력하자:

JavaScript

// index.js
const express = require('express');       // express 불러오기
const app = express();                    // express 앱 생성
const PORT = 3000;                        // 사용할 포트 번호

// 기본 라우팅 (홈페이지 접속 시 보여줄 응답 설정)
app.get('/', (req, res) => {
  res.send('Hello Express + Node.js!');   // 문자열 응답
});

// 서버 실행
app.listen(PORT, () => {
  console.log(`✅ 서버가 http://localhost:${PORT} 에서 실행 중입니다.`);
});

app.get()은 사용자가 특정 경로로 접속했을 때 어떤 응답을 줄지 정의하는 함수다.
app.listen()은 이 서버를 실제로 실행시켜주는 함수로, 포트 번호를 지정해야 한다.
- 예: http://localhost:3000은 로컬 컴퓨터의 3000번 포트를 뜻함

5단계: 서버 실행하기

작성한 서버 코드를 실행하려면 아래 명령어를 터미널에 입력한다:

code

node index.js

정상적으로 실행되면 콘솔에 다음과 같은 메시지가 출력된다:

code

✅ 서버가 http://localhost:3000 에서 실행 중입니다.

이제 브라우저에서 http://localhost:3000에 접속해보면, Hello Express + Node.js! 메시지를 확인할 수 있다.

자주 쓰는 개발 편의 도구 : nodemon

서버 코드를 수정할 때마다 node index.js를 다시 입력하는 건 꽤 번거롭다.

이를 자동으로 해주는 툴이 바로 nodemon이다.

bash

npm install -D nodemon    # 개발용(Dev)으로 nodemon 설치

그 후 package.json 파일의 scripts 항목을 수정하자:

code

// package.json
"scripts": {
  "start": "node index.js",
  "dev": "nodemon index.js"
}

이제 서버 실행은 아래처럼 간단히 할 수 있다:

bash

npm run dev

코드를 수정하면 자동으로 서버가 재시작되어, 편리한 개발이 가능해진다.

마무리

지금까지의 흐름을 정리하면 다음과 같다:

Node.js 설치
프로젝트 폴더 생성 및 초기화
Express 설치
기본 서버 코드 작성
서버 실행
nodemon을 통한 자동 재시작 설정

이제 여러분도 간단한 API 서버를 직접 만들어볼 수 있게 되었다!

최근 글