n8n 초보자를 위한 설치 및 기본 세팅 방법

n8n은 오픈소스 워크플로우 자동화 도구로, 개발 지식 없이도 다양한 서비스 연동이 가능합니다. 이 가이드에서는 Docker·npm 설치부터 기본 세팅까지 단계별로 설명합니다.

1. n8n 설치 방법 3가지

추천 방식: Docker 설치 (가장 간단하고 무결성 보장)

① Docker로 설치하기
docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n
- 포트 매핑: 5678 포트 사용
- 데이터 보존: ~/.n8n 디렉토리에 설정 저장

② npm으로 설치하기

npm install -g n8n

  n8n

- Node.js 16.x 이상 필요
- 로컬에서 빠르게 테스트 시 적합

③ 수동 설치 (Ubuntu 서버)

sudo apt-get update

  sudo apt-get install docker.io

  sudo systemctl start docker

이후 Docker 설치 방법과 동일

2. 초기 접속 및 계정 설정

1. 웹 브라우저에서 http://localhost:5678 접속
2. 첫 화면에서 관리자 계정 생성
3. 이메일/비밀번호 입력 후 저장
4. 대시보드 진입 시 워크플로우 생성 가능 상태

주의: 외부 접속 시 반드시 HTTPS 설정 필요

3. 필수 보안 설정

기본 인증 활성화 (Docker 예시):

docker run -d \

  -e N8N_BASIC_AUTH_ACTIVE=true \

  -e N8N_BASIC_AUTH_USER="사용자명" \

  -e N8N_BASIC_AUTH_PASSWORD="비밀번호" \

  n8nio/n8n

환경변수 추가 설정:
- N8N_ENCRYPTION_KEY: 데이터 암호화 키 설정
- N8N_HOST: 공개 IP/도메인 지정

4. 첫 워크플로우 만들기

1. 대시보드에서 [New Workflow] 클릭
2. Manual 트리거 노드 추가
3. Slack/Discord 노드 연결해 메시지 전송 테스트
4. [Execute Workflow] 버튼으로 동작 확인

초보자 추천 템플릿:
- 구글 시트 → 이메일 자동 발송
- RSS 피드 → 슬랙 알림
- 웹훅 수신 → 데이터 저장

5. 자주 발생하는 오류 해결

문제 1: 포트 충돌 발생 시
- 해결: -p 5678:5678에서 앞의 포트 번호 변경

문제 2: Docker 권한 오류
- 해결: sudo chmod -R 755 ~/.n8n 실행

문제 3: 노드 실행 실패
- 해결: 노드 설정에서 [Retry] 옵션 활성화

6. 고급 설정 팁

- 백업: ~/.n8n 디렉토리 정기 백업
- 확장: 커스텀 노드 마켓플레이스 활용
- 모니터링: Prometheus/Grafana 연동
- 스케일링: Kubernetes 클러스터 배포

마무리

n8n은 초보자도 30분 내에 설치부터 기본 워크플로우 구축까지 가능한 도구입니다. Docker 설치를 우선 추천하며, 보안 설정과 데이터 백업만 주의하면 안정적으로 장기 운영 가능합니다.

n8n 초보자를 위한 설치 및 기본 세팅 방법

n8n 초보자를 위한 설치 및 기본 세팅 방법

1. n8n 설치 방법 3가지

2. 초기 접속 및 계정 설정

3. 필수 보안 설정

4. 첫 워크플로우 만들기

5. 자주 발생하는 오류 해결

6. 고급 설정 팁

마무리

연관글 추천