WSL의 UBUNTU에 N8N설치하고 윈도우11에서 접속하여 운영하는 방법

 

WSL2(Ubuntu)에 n8n을 설치하고 윈도우 11 웹 브라우저에서 접속하는 가장 정석적인 방법은 Docker Compose를 사용하는 방식입니다. 환경 관리가 깔끔하고 데이터 유실 우려가 없으며 유지보수가 쉽습니다.

티스토리

🚀 1단계: WSL2 Ubuntu 기본 준비

윈도우 터미널(또는 Ubuntu 앱)을 열고, 최신 패키지 업데이트 및 필요 도구를 설치합니다.

Bash

# 패키지 목록 업데이트

sudo apt update && sudo apt upgrade -y

 

# 기본 필수 도구 설치

sudo apt install -y curl git

🐳 2단계: Docker 및 Docker Compose 설치

Ubuntu 내부에서 n8n을 컨테이너로 띄우기 위해 Docker를 설치합니다. (윈도우용 Docker Desktop을 WSL 연동으로 써도 되지만, Ubuntu 내부 전용 Docker를 쓰는 것이 훨씬 가볍습니다.)

티스토리+ 1

Bash

# Docker 공식 설치 스크립트 실행

curl -fsSL https://get.docker.com -o get-docker.sh

sudo sh get-docker.sh

 

# 현재 사용자(Ubuntu 계정)에게 Docker 실행 권한 부여

sudo usermod -aG docker $USER

 

# 설정 적용을 위해 터미널 재시작 권장 (또는 newgrp docker 명령어 실행)

newgrp docker

설치 및 권한이 정상 적용되었는지 확인합니다:

Bash

docker --version

docker compose version

⚙️ 3단계: n8n 프로젝트 디렉토리 및 설정 구성

1.    작업 폴더 생성 및 이동

DEV Community

Bash

mkdir ~/n8n-docker && cd ~/n8n-docker

2.    docker-compose.yml 파일 작성 nano docker-compose.yml 명령어를 실행하고 아래 내용을 붙여넣습니다 (저장: Ctrl+O -> Enter, 종료: Ctrl+X).

YAML

services:

  n8n:

    image: docker.n8n.io/n8nio/n8n:latest

    container_name: n8n

    restart: always

    ports:

      - "5678:5678"

    environment:

      - N8N_HOST=localhost

      - N8N_PORT=5678

      - N8N_PROTOCOL=http

      - NODE_ENV=production

      - WEBHOOK_URL=http://localhost:5678/

      - GENERIC_TIMEZONE=Asia/Seoul

      - TZ=Asia/Seoul

    volumes:

      - n8n_data:/home/node/.n8n

 

volumes:

  n8n_data:

▶️ 4단계: n8n 실행하기

작성한 폴더(~/n8n-docker)에서 컨테이너를 백그라운드 데몬으로 실행합니다.

DEV Community

Bash

docker compose up -d

• 상태 확인: docker ps 입력 시 n8n 컨테이너가 Up 상태인지 확인합니다.
• 로그 확인 (오류 발생 시): docker compose logs -f

🌐 5단계: 윈도우 11 브라우저에서 접속 및 초기 설정

WSL2는 윈도우 11과 localhost 포트 포워딩이 기본 연결되어 있습니다.

DEV Community

1.    윈도우 11에서 Chrome, Edge 등 웹 브라우저를 열어줍니다.

2.    주소창에 아래 주소를 입력하여 접속합니다:

Plaintext

http://localhost:5678

3.    처음 접속하면 n8n 계정 생성(Owner Account) 화면이 나타납니다. 이메일과 비밀번호를 등록하면 윈도우 11에서 완전히 운영 가능한 n8n 대시보드가 열립니다.

💡 추가 팁 & 대안 (npm direct 설치)

Docker 대신 npm으로 직접 설치하고 싶다면?

Docker 설치 없이 Node.js 환경에서 직접 실행하는 것도 가능합니다.

Bash

# 1. Node.js (v20+ 또는 v22+) 설치

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

sudo apt install -y nodejs

 

# 2. n8n 전역 설치

sudo npm install n8n -g

 

# 3. n8n 실행

n8n

주의: npm 직접 실행 시에는 터미널 창을 닫으면 n8n이 종료되므로, 백그라운드 지속 실행을 위해서는 PM2(npm install -g pm2) 패키지를 추가로 활용하는 것을 권장합니다.

윈도우 재부팅 후 n8n 자동 실행 설정

Docker 방식(restart: always)을 적용해 두면, WSL이 켜지거나 Docker 서비스가 시작될 때 n8n이 자동으로 재개됩니다.