n8n 클라이언트 사용 설명

Tom Cha

Nov 21, 2024 — 5 min read

1. n8n 서버 접속 방법

1.1 로컬에서 접속

n8n 서버가 로컬 컴퓨터에서 실행 중인 경우:
- 브라우저 주소창에 다음 URL을 입력:

http://localhost:5678

기본 포트는 5678입니다. 실행 시 포트를 변경한 경우, 해당 포트를 사용합니다.
- 예: http://localhost:8080

1.2 내부 네트워크에서 접속

같은 네트워크의 다른 컴퓨터에서 접속하려면 n8n 서버의 내부 IP 주소를 사용합니다:
- 내부 IP 주소 확인 (Linux 예시):

ip addr

예: http://192.168.1.50:5678

1.3 외부에서 접속

n8n 서버를 외부에서 접속하려면 공인 IP 주소 또는 도메인 이름과 포트를 사용합니다:

공인 IP 주소를 사용하는 경우:

http://123.45.67.89:5678

여기서 123.45.67.89는 공인 IP 주소입니다.
포트 5678은 기본 설정이며, 변경한 경우 해당 포트를 사용하세요.

HTTPS를 설정한 경우 도메인 이름으로 접속:

https://your-domain.com

Let’s Encrypt 등으로 SSL 인증서를 설정한 경우 HTTPS를 통해 안전하게 접속할 수 있습니다.

참고:
외부 접속을 위해 공유기에서 포트 포워딩(5678 → n8n 서버의 내부 IP)을 설정해야 하며, 공인 IP 주소가 동적인 경우 DDNS(Dynamic DNS)를 활용할 수 있습니다.

2. 로그인 및 인증

2.1 기본 인증

n8n 기본 인증이 활성화된 경우, 로그인 화면에서 사용자 이름과 비밀번호를 입력해야 합니다.

설정 시 지정된 사용자 이름과 비밀번호를 입력합니다:
- 사용자 이름: admin
- 비밀번호: 설정한 비밀번호 (예: securepassword)

2.2 인증 활성화 확인

인증이 활성화되지 않았다면, 서버 실행 명령에 환경 변수를 추가하여 설정할 수 있습니다:

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=securepassword \
  n8nio/n8n

3. n8n 대시보드 사용 방법

3.1 워크플로 작성

새 워크플로 생성:
- 화면 상단의 "New Workflow" 버튼 클릭.
- 빈 워크플로 편집 화면이 열립니다.
노드 추가:
- 워크플로 영역에서 "+" 버튼을 클릭하여 원하는 노드를 추가합니다.
- 예: HTTP Request, Email, Webhook 등.
노드 설정:
- 각 노드의 설정 창에서 입력값을 설정합니다.
- 예: HTTP Request 노드에서 API URL, 메서드(GET/POST) 등을 입력.

3.2 워크플로 실행

워크플로 저장:
- 상단 메뉴의 "Save" 버튼을 클릭하여 워크플로를 저장합니다.
워크플로 실행:
- 화면 상단의 "▶ (Play)" 버튼을 클릭하여 워크플로를 실행합니다.
결과 확인:
- 실행 결과는 UI 하단의 **"Execution Log"**에서 확인할 수 있습니다.
- 각 노드의 출력 데이터와 상태를 상세히 검토할 수 있습니다.

4. 워크플로 자동 실행 설정

4.1 주기적 실행

Cron Trigger 노드를 사용하여 일정 시간 간격으로 워크플로를 실행합니다:
- 예: 매일 오전 9시에 실행
  - 설정: 0 9 * * *

4.2 이벤트 기반 실행

Webhook Trigger 노드를 사용하여 외부 요청이 발생했을 때 워크플로를 실행합니다:
- Webhook URL은 n8n 서버의 주소에 기반합니다:
  - 예: http://your-domain.com/webhook-name

5. 데이터 저장 및 외부 API 연결

5.1 데이터 저장소 사용

기본적으로 n8n은 실행 데이터를 메모리에 저장하며, 데이터베이스를 설정하여 영구 저장이 가능합니다:
Docker로 실행 시 데이터베이스 연결 설정 예:

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -e DB_TYPE=postgresdb \
  -e DB_POSTGRESDB_HOST=your-db-host \
  -e DB_POSTGRESDB_DATABASE=n8n \
  -e DB_POSTGRESDB_USER=your-user \
  -e DB_POSTGRESDB_PASSWORD=your-password \
  n8nio/n8n

5.2 외부 API와 통합

HTTP Request 노드를 사용해 외부 API와 연결합니다:
1. URL 입력 (예: https://api.example.com/data).
2. 인증 정보 입력 (API 키 또는 OAuth).
3. 요청 메서드 선택 (GET, POST 등).

6. 문제 해결

6.1 서버 연결 문제

1.서버 상태 확인: Docker 컨테이너가 정상적으로 실행 중인지 확인:

docker ps

*n8n 컨테이너가 목록에 표시되지 않으면 다시 실행해야 합니다.

2.포트 허용 확인: 로컬 방화벽에서 n8n의 포트를 허용:

sudo ufw allow 5678

3.포트 포워딩 확인:

외부 네트워크에서 접속하려면 공유기(라우터)에서 포트 포워딩이 올바르게 설정되었는지 확인

-외부 포트 5678 → 내부 n8n 서버 IP (192.168.x.x)의 포트 5678

6.2 인증 오류

1.인증 활성화 여부 확인: 환경 변수로 인증이 활성화되어 있는지 확인

docker exec n8n env | grep N8N_BASIC_AUTH_ACTIVE

2.잘못된 비밀번호 변경: 서버를 재실행하여 새로운 비밀번호로 설정

docker rm -f n8n
docker run -d \
  --name n8n \
  -p 5678:5678 \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=newpassword \
  n8nio/n8n

6.3 로그 확인

n8n 실행 중 오류가 발생하면 로그를 확인하여 문제를 진단합니다:

-Docker 컨테이너 로그 확인:

docker logs n8n

6.4 외부 연결 문제

1.공인 IP 주소 확인: 서버가 실행 중인 네트워크의 공인 IP 주소를 확인

https://whatismyipaddress.com

2.DDNS 설정 확인: 공인 IP가 동적으로 변경되는 경우 DDNS를 활용하여 고정 도메인으로 접근

*예: http://n8n.mydomain.ddns.net:5678

3.HTTPS 설정 문제: HTTPS 인증서가 제대로 작동하지 않을 경우

-Nginx 설정 파일을 다시 확인:

sudo nano /etc/nginx/sites-available/n8n

-Nginx 로그 확인:

sudo journalctl -u nginx

참고

n8n 공식 문서: https://n8n.io