n8n WSL 설치부터 첫 워크플로우까지 — Windows 완전 가이드

n8n WSL 설치를 처음 시도하면 Docker나 클라우드 버전 안내만 나온다. Windows 환경에서 직접 돌리고 싶다면 WSL(Windows Subsystem for Linux)이 사실상 표준이다. 이 글에서 n8n WSL 설치부터 첫 워크플로우 실행까지 막히는 지점 없이 정리한다.

Windows에서 n8n을 왜 WSL로 설치해야 할까

n8n은 Node.js 기반 자동화 도구다. Windows 네이티브 환경에서도 npm으로 설치할 수는 있지만, 실제로 해보면 경로 문제와 권한 오류가 자주 발생한다. 특히 npm install -g n8n 후 n8n 명령어가 인식 안 되는 경우가 흔하다.

WSL2(Ubuntu)에서 설치하면 이런 문제가 없다. Linux 환경이라 npm 전역 설치 경로가 깔끔하고, n8n이 내부적으로 사용하는 파일 시스템 접근도 안정적이다. Docker보다 가볍고, 설치 후 바로 터미널에서 실행 가능하다는 것도 장점이다.

Windows 네이티브: 경로 문제, 권한 오류 잦음
Docker: 가능하지만 리소스 소비 큼, 설정 복잡
WSL2 + npm: 가장 가볍고 안정적

WSL2 + Ubuntu 설치 방법 (5분이면 충분)

Windows 10 버전 2004 이상, 또는 Windows 11이라면 명령어 한 줄로 WSL2와 Ubuntu를 동시에 설치할 수 있다.

1. 관리자 권한으로 PowerShell 실행 후 입력:

wsl --install

이 명령어 하나로 WSL2 활성화 + Ubuntu 설치가 자동으로 진행된다. 설치 후 재부팅하면 Ubuntu 초기 설정 화면이 뜬다. 사용자명과 비밀번호를 설정하면 완료.

이미 WSL이 설치된 상태라면 버전을 확인하자:

wsl --status

Default Version: 2가 나오면 정상이다. WSL1이면 아래 명령어로 전환:

wsl --set-default-version 2

nvm으로 Node.js 설치하는 이유

n8n은 Node.js가 필요하다. Ubuntu에 apt로 Node.js를 설치할 수도 있지만, apt 버전은 구버전인 경우가 많다. nvm(Node Version Manager)을 쓰면 최신 LTS 버전을 쉽게 설치하고 버전 전환도 자유롭다.

# nvm 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 터미널 재시작 또는 아래 실행
source ~/.bashrc

# 설치 확인
nvm --version

nvm이 설치됐으면 Node.js LTS 버전을 설치한다:

# Node.js LTS 설치
nvm install --lts

# 설치 확인
node -v
npm -v

v20.x.x 같은 버전이 나오면 정상이다.

n8n WSL 설치 및 첫 실행 — localhost:5678 접속까지

Node.js가 준비됐으면 n8n 설치는 한 줄이다:

npm install -g n8n

설치에 1~3분 정도 걸린다. 완료 후 실행:

n8n start

터미널에 아래와 같은 메시지가 뜨면 성공이다:

Editor is now accessible via:
http://localhost:5678/

Windows 브라우저에서 http://localhost:5678 접속하면 n8n 에디터 화면이 열린다. WSL 내부에서 실행 중이지만 Windows 브라우저에서 그대로 접근된다.

처음 접속 시 계정 생성 화면이 나온다. 이름, 이메일, 비밀번호를 입력하면 바로 사용 가능하다. 이 계정은 로컬에만 저장되므로 외부에서 접근되는 구조가 아니다.

첫 워크플로우 만들어보기 — HTTP Request 노드 연결

n8n의 핵심은 노드를 연결해서 자동화 흐름을 만드는 것이다. 처음에는 간단하게 Manual Trigger → HTTP Request 두 개만 연결해보자.

화면 중앙 + Add first step 클릭
Manual Trigger 선택 (수동으로 실행하는 트리거)
오른쪽 + 버튼 클릭 → HTTP Request 선택
URL에 https://jsonplaceholder.typicode.com/posts/1 입력
상단 Test workflow 클릭

JSON 응답이 노드 아래에 표시되면 첫 워크플로우 동작 성공이다. 이 구조를 이해하면 나머지는 응용이다. RSS 수집도, Claude API 호출도, WordPress 발행도 결국 같은 방식으로 노드를 연결하는 것뿐이다.

WSL 재시작 문제 — PM2로 백그라운드 실행 처리하기

n8n을 n8n start로 실행하면 터미널을 닫는 순간 종료된다. WSL을 재시작해도 마찬가지다. 매번 수동으로 켜는 게 번거롭다면 PM2를 사용하면 된다.

# PM2 설치
npm install -g pm2

# n8n을 PM2로 실행
pm2 start n8n

# 현재 실행 상태 저장 (재부팅 후 자동 복구용)
pm2 save

# WSL 시작 시 자동 실행 등록
pm2 startup

pm2 startup 실행 후 안내 명령어가 출력된다. 그 명령어를 복붙해서 실행하면 WSL 시작 시 n8n이 자동으로 켜진다.

상태 확인은 pm2 status, 로그 확인은 pm2 logs n8n으로 한다.

한 가지 주의할 점이 있다. WSL 자체는 Windows 재부팅 시 자동으로 시작되지 않는다. Windows 시작 시 WSL도 자동 실행되게 하려면 Windows 작업 스케줄러에 wsl -d Ubuntu 명령어를 등록해야 한다. 이 부분은 별도 글에서 다룬다.

설치 후 확인할 것들

n8n --version — 설치된 버전 확인
pm2 status — 실행 중인 프로세스 확인
브라우저 localhost:5678 — 에디터 접속 확인
Settings → Community Nodes — 추가 노드 설치 가능

여기까지 되면 n8n WSL 설치는 완료다. 다음 단계는 Claude API를 연결해서 실제로 뉴스 자동 요약을 만드는 것이다.

FAQ

Q. Docker로 설치하면 안 되나요?
가능합니다. 하지만 WSL 환경에서는 npm 직접 설치가 더 가볍고 관리가 쉽습니다. Docker는 컨테이너 관리, 볼륨 마운트 등 추가 개념이 필요해서 처음이라면 WSL + npm이 진입장벽이 낮습니다.

Q. WSL1과 WSL2 차이가 있나요?
WSL2 권장입니다. 내부적으로 실제 Linux 커널을 사용해서 파일 I/O 성능이 WSL1보다 훨씬 빠릅니다. n8n 데이터 저장 및 워크플로우 실행 시 안정적입니다.

Q. n8n은 무료로 계속 쓸 수 있나요?
자체 호스팅(self-hosted) 버전은 무료입니다. 워크플로우 수, 실행 횟수 제한이 없습니다. n8n Cloud(클라우드 버전)는 유료입니다. 이 블로그에서 다루는 방법은 모두 self-hosted 기준입니다.

Q. Windows 11에서도 동일하게 설치되나요?
네. Windows 10 2004 이상과 Windows 11 모두 wsl --install 명령어 하나로 설치 가능합니다.

Q. n8n 데이터는 어디에 저장되나요?
기본값은 ~/.n8n 디렉터리입니다. WSL 환경에서는 Ubuntu 홈 디렉터리 안에 저장됩니다. 워크플로우, 실행 이력, 크리덴셜이 여기 저장되므로 주기적으로 백업해두는 걸 권장합니다.