n8n 로컬에 설치한 경우 웹훅 사용하려면 외부접속 설정

node.js 설치 확인

cmd 창에서

node --version

npm --version

 

ngrok 설치

npm install -g ngrok

 

 

✅ ngrok을 이용해 n8n 웹훅 사용하기 (윈도우 기준)

---

📦 1단계: ngrok 설치

1. https://ngrok.com/download 에 접속
2. Windows용 다운로드 → 압축 풀기 → ngrok.exe가 나옴
3. ngrok.exe를 편한 위치에 두고, 그 위치에서 명령 프롬프트(cmd) 실행

(선택: ngrok.exe 폴더를 시스템 PATH에 등록하면 어디서든 명령어로 실행 가능)

---

🔐 2단계: ngrok 회원가입 및 인증 토큰 발급

1. https://dashboard.ngrok.com/signup 에서 무료 회원가입
2. 로그인 후 "Auth Token" 복사
3. 명령 프롬프트에 붙여넣기:

bash

복사편집

ngrok config add-authtoken <여기에_당신의_토큰_붙여넣기>

---

🚀 3단계: n8n 실행

보통 이렇게 실행하셨을 거예요:

bash

복사편집

n8n start

기본적으로 http://localhost:5678에서 동작합니다.

---

🌐 4단계: ngrok으로 포트 5678 노출시키기

bash

복사편집

ngrok http 5678

 

결과 예시:

nginx

복사편집

Forwarding https://abcd1234.ngrok.io -> http://localhost:5678

이제 외부에서 https://abcd1234.ngrok.io/webhook/your-path 같은 주소로 접근 가능합니다!

---

🔁 5단계: n8n에서 웹훅 트리거 테스트

1. n8n 워크플로우에 Webhook 노드 추가
2. Webhook URL 확인 (예: /webhook/test)
3. ngrok 주소와 결합:

bash

복사편집

https://abcd1234.ngrok.io/webhook/test

1. Postman 또는 외부 앱에서 해당 주소로 요청 보내면 n8n이 정상 반응합니다.

---

📌 주의 사항

항목설명

ngrok는 무료 플랜에서 일정 시간(2시간) 후 자동 종료됩니다
주소는 실행할 때마다 바뀝니다 (유료 플랜은 고정 가능)
n8n에서 Webhook 노드는 ‘Listen for Request’ 모드에서 대기 상태여야 함

 

---

✅ 정리

작업명령어

ngrok 설치	공식 사이트
인증	ngrok config add-authtoken <your_token>
포트 노출	ngrok http 5678

 

---

필요하시면:

• n8n Webhook 설정법
• Postman 테스트 방법
• ngrok 자동 재시작 스크립트

도 도와드릴 수 있어요. 추가로 원하시는 게 있다면 말씀 주세요!

 

나의 말:

npm install ngrok -g 로 설치했어

 

ChatGPT의 말:

좋습니다! npm install ngrok -g로 설치하셨다면, ngrok CLI 명령어를 바로 사용할 수 있습니다. 👍

---

✅ 다음 단계: ngrok 실행해서 n8n 웹훅 주소 만들기

이제 아래처럼 n8n이 실행 중인 포트(보통 5678) 를 외부로 노출시키면 됩니다:

🔁 Step-by-step

1. n8n이 실행 중인지 확인

bash

복사편집

n8n start

기본적으로 로컬 주소는:

arduino

복사편집

http://localhost:5678

---

2. ngrok으로 5678 포트를 노출

bash

복사편집

ngrok http 5678

실행 결과 예시:

nginx

복사편집

Forwarding https://abcd1234.ngrok.io -> http://localhost:5678

이제 외부에서도 이 주소를 통해 n8n에 접근할 수 있게 됩니다!

---

🔗 예: Webhook 노드 연결하기

만약 n8n에서 webhook 노드의 주소가 /webhook/test라면,

• 로컬에서는:
• bash
  복사편집
  http://localhost:5678/webhook/test
• ngrok으로 외부에 노출된 주소는:
• bash
  복사편집
  https://abcd1234.ngrok.io/webhook/test

이 주소를 외부 앱이나 브라우저, Postman에서 호출하면 n8n이 응답합니다.

---

🔐 참고: ngrok 인증 토큰 설정 (처음 1회만)

혹시 아직 ngrok에 로그인하거나 토큰 설정을 하지 않았다면 아래도 해주세요:

1. https://dashboard.ngrok.com/get-started/setup 에서 로그인 → 인증 토큰 복사
2. 아래 명령어로 등록:

bash

복사편집

ngrok config add-authtoken <당신의_토큰>

---

✅ 요약

단계명령어

n8n 실행	n8n start
ngrok 실행	ngrok http 5678
외부 주소 확인	ex) https://abcd1234.ngrok.io/webhook/xxx
(선택) 토큰 설정	ngrok config add-authtoken <토큰>

 

---

필요하시면 웹훅 테스트용 워크플로우 샘플도 만들어 드릴게요.
더 궁금한 점 있으시면 언제든지 질문 주세요!

 

나의 말:

ERROR: authentication failed: Usage of ngrok requires a verified account and authtoken. ERROR: ERROR: Sign up for an account: https://dashboard.ngrok.com/signup ERROR: Install your authtoken: https://dashboard.ngrok.com/get-started/your-authtoken ERROR: ERROR: ERR_NGROK_4018 ERROR: https://ngrok.com/docs/errors/err_ngrok_4018 ERROR:

 

ChatGPT의 말:

좋습니다, 에러 메시지를 보면 정확히 이렇게 말하고 있죠:

authentication failed: Usage of ngrok requires a verified account and authtoken

즉, ngrok 계정 인증(authtoken)이 필요하다는 뜻입니다. 아주 간단하게 해결할 수 있어요!

---

✅ 해결 방법: ngrok 인증 토큰 등록

🔧 1단계: ngrok 회원가입 및 로그인

👉 https://dashboard.ngrok.com/signup

• 계정 만들고 이메일 인증까지 완료하세요.
• 가입 후 자동으로 대시보드로 이동합니다.

---

🔑 2단계: Authtoken 복사

👉 https://dashboard.ngrok.com/get-started/your-authtoken

여기서 아래와 같이 생긴 authtoken을 복사하세요:

arduino

복사편집

ngrok config add-authtoken 2Zx6nxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

---

💻 3단계: 명령어 실행

복사한 명령어를 터미널(cmd, PowerShell, bash 등)에 붙여넣고 실행하세요:

bash

복사편집

ngrok config add-authtoken 2Zx6nxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

---

🚀 4단계: 다시 ngrok 실행

bash

복사편집

ngrok http 5678

이제 오류 없이 실행되고, 다음과 같은 화면이 나올 것입니다:

nginx

복사편집

Forwarding https://abcd1234.ngrok.io -> http://localhost:5678

이 주소를 이용해 n8n 웹훅을 외부에서 호출할 수 있습니다.

---

✅ 요약

순서작업

1	ngrok 회원가입 + 이메일 인증
2	authtoken 복사
3	ngrok config add-authtoken <복사한 토큰> 실행
4	ngrok http 5678 실행

 

---

완료 후 webhook 연결이 안 되는 경우도 도와드릴게요. 진행하다 막히는 부분이 있으면 바로 알려주세요!

 

나의 말:

외부에서 접속할려면 어떻게 해야 돼?

 

ChatGPT의 말:

좋습니다! 이제 ngrok으로 외부에서 접속할 수 있도록 준비되었으니, 정확히 어떻게 외부에서 n8n에 접속하는지 단계별로 설명드릴게요.

---

✅ 외부에서 ngrok으로 n8n에 접속하는 방법

---

1️⃣ n8n 실행

bash

복사편집

n8n start

• 기본적으로 http://localhost:5678 에서 실행됩니다.

---

2️⃣ ngrok 실행

bash

복사편집

ngrok http 5678

실행하면 아래처럼 임시 외부 주소가 하나 생깁니다:

nginx

복사편집

Forwarding https://abcd1234.ngrok.io -> http://localhost:5678

여기서 https://abcd1234.ngrok.io 가 외부에서 접근할 수 있는 주소입니다.

---

3️⃣ 외부 접속 테스트

이제 다른 컴퓨터, 모바일, 또는 인터넷 환경에서 브라우저를 열고 아래 주소에 접속하면 됩니다:

arduino

복사편집

https://abcd1234.ngrok.io

접속하면 n8n 워크플로우 에디터가 열립니다.

---

4️⃣ Webhook 주소 외부에서 사용하기

만약 n8n 워크플로우 안에 Webhook 노드가 있고, URL이 /webhook/test라면:

• 로컬에서는:
  http://localhost:5678/webhook/test
• 외부에서는:
  https://abcd1234.ngrok.io/webhook/test

이 주소를 외부 시스템(예: Slack, Notion, Google Apps Script, Postman 등)에서 호출하면 n8n에서 트리거됩니다.

---

📌 참고 사항

항목설명

주소 바뀜	무료 ngrok는 실행할 때마다 주소가 바뀝니다
자동 종료	무료 버전은 약 2시간 후 자동 종료됩니다
보안 경고	외부 노출이기 때문에 민감한 정보는 주의하세요

 

---

✅ 예시: 외부에서 webhook 테스트하기

1. n8n에 webhook 노드 하나 만들기
2. Webhook URL 확인 (예: /webhook/test)
3. 외부에서 아래 주소 호출 (브라우저나 Postman 이용):

bash

복사편집

https://abcd1234.ngrok.io/webhook/test

→ n8n이 반응하면 성공입니다!

---

필요하시면 n8n 워크플로우 예제도 만들어 드릴게요.
추가로 도와드릴 부분 있으면 편하게 말씀해주세요!

 

나의 말:

정리하면 cmd 첫 번째 창에서 n8n 실행하고 cmd 두 번째 창에서 ngrok http 5678 실행하고 웹브라우져에서 https://abcd1234.ngrok.io 접속하고 로그인 하면 경고문 확인 하면 n8n 외부접속화면이 뜨는 거네

 

ChatGPT의 말:

네! 딱 정확하게 정리하셨어요! 👏👏
다시 한 번 정리해 드리면:

---

✅ 외부에서 n8n 접속 요약 정리

단계설명

✅ CMD 창 1	n8n start 실행 (n8n 로컬 서버 켜기)
✅ CMD 창 2	ngrok http 5678 실행 (ngrok으로 외부 공개)
✅ 웹브라우저에서	https://abcd1234.ngrok.io 접속 (ngrok가 알려준 주소)
✅ n8n 첫 접속 시	로그인 or 경고 메시지 → 확인
✅ 성공 화면	n8n 워크플로우 에디터가 외부에서 보임 🎉

 

---

💡 추가 팁

• https://abcd1234.ngrok.io 는 ngrok 켤 때마다 바뀔 수 있어요. (유료 계정이면 고정 가능)
• Webhook URL 도 이 주소 기준으로 자동 생성됩니다.
• 접속 안 되면 윈도우 방화벽이나 백신에서 포트를 막고 있는지도 확인!

 

배치파일 만들기

@echo off
start cmd /k "n8n start"
start cmd /k "ngrok http 5678"

 

@echo off
REM n8n 실행
start "n8n" cmd /k "n8n start"

REM ngrok 실행
start "ngrok" cmd /k "ngrok http 5678"