echo "코딩기록";

AI 기반 쇼츠, 영상 자동 생성 (n8n, OpenAI, Flux, Kling, ElevenLabs)

backend.log — Sun, 15 Jun 2025 16:54:25 +0900

이 작업은 OpenAI와 n8n을 활용하여 자동으로 영상을 생성하고,

Instagram, TikTok, Youtube등 소셜 네트워크에 업로드하는 시스템입니다.

해당 로직은 n8n에서 제공한 템플릿을 참고하였습니다.

무료로 사용할 수 있어 직접 사용해보면서 공부할 수 있다는게 너무 좋은 거 같아요!!!

쇼츠 매일 올리기 현실적으로 너무 힘들잖아요... ㅜㅜ (게으른 휴먼)

그래서 주제도 정해주고, 영상도 만들어주고, 자막도 생성해주고, 비디오도 생성해주고, 배경음악도 넣어주고, 업로드도 해주는거 없을까...? (AI 너가 다해주라!!!!)

있더라구요 ?.?

지금은 퀄리티가 전문가들이 만든 것보다 떨어지지만

1년 후 2년 후.. 생각해보면 얼마나 발전할지 Ai의 성장 속도 무시 못하겠더라구요.

오늘 포스팅 참고하셔서 쇼츠 자동 생성하고 수익화해보는 시스템!! 만들어봅시다.

영상 자동화 워크플로어

시작전에 필요한 것들

시작하기 전에 다음이 필요합니다. API를 사용하려면 Key가 필요해요. Key 발급 방법은 GPT한테 물어보면 너무 잘 설명해주니까, chatGPT한테 물어봅시다!!

n8n 설치
- 개발 필드와 DB에서 다른 n8n 버전과 다른 OS에서도 연동 가능
OpenAI API Key (무료 체험 크레딧 제공)
PiAPI (무료 체험 크레딧 제공)
ElevenLabs (무료 계정)
Creatomate API Key (무료 체험 크레딧 제공)
Google API 설정:
Discord Webhook URL (선택)
upload-post.com 계정 및 API 토큰

1단계. Google 시트에서 영상 주제 바탕으로 비디오 캡션 생성하기

1. PiAPI, Eleven Labs, Creatomate의 API 키를 먼저 세팅합니다.

Creatomate에 로그인한 후 새 템플릿을 만들고, 오른쪽 상단의 “source code”를 클릭한 뒤 JSON 코드를 붙여넣으세요. (JSON 코드 링크 참고)
"Use Template" 클릭 → "API Integration"을 눌러 template_id를 확인하고, n8n에서 해당 값을 사용합니다.

2. Google Sheet 템플릿을 복사합니다

Google Sheet 복사하기 → 파일 > 사본 만들기 선택 이후 n8n에서 연결하세요.

3. OpenAI를 통해 영상 아이디어 기반으로 자막 5개를 생성합니다.

이 노드의 프롬프트를 원하는 방식으로 수정할 수 있습니다.

4. 자바스크립트 노드 2개를 이용해 OpenAI 응답을 리스트로 변환하고, 실패 여부를 검증합니다.

1단계 워크플로어 상세 설명

✅ 전체 흐름 요약:

워크플로어 전체 흐름 이미지

Google Sheet 내용 불러온 결과

	노드명	설명
1	Schedule Trigger node	매일 한 번 워크플로우 자동 실행 (스케줄 트리거)
2	Set API Keys	OpenAI, PiAPI, Creatomate, ElevenLabs 등의 API 키 및 템플릿 ID 설정
3	Load Google Sheet	사전에 작성된 Google Sheet에서 오늘 사용할 콘텐츠 아이디어 불러오기
4	Generate Video Captions	OpenAI GPT를 사용해 아이디어 기반 자막 5개 생성 (Message Model 노드)
5	Create List	OpenAI의 응답을 자바스크립트로 파싱해 리스트 배열로 변환
6	Validate list formatting	리스트가 정상적으로 형성되었는지 검증 (예: 자막이 5개인지 확인)

1-1. Schedule Trigger node

Schedule Trigger 노드를 사용하여 고정된 간격과 시간에 워크플로를 실행할 수 있습니다. 이는 Unix 계열 시스템의 Cron 소프트웨어 유틸리티와 유사한 방식으로 작동합니다.

기능: 이 워크플로우가 매일 한 번 자동 실행되도록 예약합니다.
타입: Cron 트리거
예시 설정: 매일 오전 9시에 실행되도록 설정 (0 9 * * *)

사용자 지정(Cron) 간격

트리거 일정을 설정하려면 사용자 정의 Cron 표현식을 입력하세요.

Cron 표현식을 생성하려면 crontab guru를 사용할 수 있습니다 . crontab guru를 사용하여 생성한 Cron 표현식을 n8n의 표현식 필드에 붙여넣습니다.


유형	크론	설명
Every X Seconds	/10 * * * *	10초마다
Every X Minutes	/5 * * *	5분마다
Hourly	0 * * * *	매 시간 정각
Daily	0 6 * * *	매일 오전 6시
Weekly	0 12 * * 1	매주 월요일 정오
Monthly	0 0 1 * *	매월 1일 자정
Every X Days	0 0 /3 *	3일마다 자정에
Only Weekdays	0 9 * * 1-5	월요일부터 금요일까지 오전 9시
Custom Hourly Range	0 9-17 * * *	매일 오전 9시부터 오후 5시까지 매시간
Quarterly	0 0 1 1,4,7,10 *	At midnight on the 1st of January, April, July, and October.

1-2. Edit Fields (Set)

기능: OpenAI, PiAPI(Flux & Kling), Creatomate, ElevenLabs 등 모든 API 키를 환경변수로 설정합니다.
중요 이유: 이후 모든 API 호출에 필요한 Key들을 이 노드에서 세팅해야 하므로 *"시작 전에 꼭 설정"*해야 합니다.
설정 예시:

{
  "OPENAI_API_KEY": "sk-...",
  "PIAPI_KEY": "your-piapi-key",
  "CREATOMATE_API_KEY": "your-creatomate-key",
  "ELEVENLABS_API_KEY": "your-elevenlabs-key"
}

1-3. Google Sheets

기능: Google Sheet에서 영상 주제, 스크립트, 상태등 기본 정보를 불러옵니다.
동작 방식:
- 사전에 공유된 Google Sheet 템플릿을 복사해 사용
- 첫 번째 시트에서 "처리되지 않은" 아이디어 한 줄을 불러옴

1-4. OpenAI node

기능: OpenAI GPT 모델을 사용해 Google Sheet에서 불러온 아이디어를 바탕으로 쇼츠용 자막 5개 생성

1-5. Code node

기능: OpenAI로부터 받은 "자막 텍스트(예: numbered list)"를 n8n 내부에서 리스트 형태로 파싱합니다.

✅ 1-6. If

기능: 위 단계에서 생성된 리스트가 정확히 5개인지, 파싱이 잘 되었는지 검증합니다.
실패 시: 이후 단계로 진행되지 않음 (에러 처리 또는 Slack/Discord 알림 가능)
성공 시: 다음 단계 (이미지 생성)로 진행
Tip: 이 구조 덕분에 OpenAI 응답이 예상과 다를 경우에도 에러를 감지하고 중단할 수 있어, 전체 플로우가 망가지지 않도록 보장됩니다.

다음 단계 예고

내용이 너무 많아서 이후 플로우는 다음과 같은 순서로 블로그에 포스팅하겠습니다 :)

자막을 기반으로 이미지 프롬프트 생성 (OpenAI)
이미지 생성 (Flux by PiAPI)
이미지 → 비디오 생성 (Kling by PiAPI)
자막 기반 음성 생성 (ElevenLabs)
자막/음성/비디오 통합 → 최종 영상 생성 (Creatomate)
자동 업로드 (upload-post.com) 및 시트 업데이트

구독과 댓글, 좋아요는 포스팅에 힘이 됩니다

n8n으로 자동화 시작하기 9편 - Google Drive에 파일 자동 저장하기

backend.log — Sat, 14 Jun 2025 15:20:59 +0900

n8n으로 자동화 시작하기 9편 - Google Drive에 파일 자동 저장하기

이번 편에서는 n8n을 통해 특정 데이터를 자동으로 Google Drive에 파일로 저장하는 방법을 소개합니다. 크론 실행이나 이메일 첨부파일 저장, API 수집 데이터를 정기 백업하는 워크플로우에 활용할 수 있습니다.

사전 준비: Google Drive 인증

Google Cloud Console에 접속해 프로젝트를 생성합니다.
OAuth 동의 화면 설정 → 외부 사용자 허용
API 및 서비스 > OAuth 2.0 클라이언트 ID 생성 → 리디렉션 URL은 https://n8n.io/oauth2-redirect
n8n Credentials 메뉴에서 Google Drive 인증 추가

[이미지1] Google Cloud에서 OAuth 설정 화면

Google Drive 노드 구성

Google Drive 노드에서는 파일 업로드 작업을 자동화할 수 있습니다. 다음과 같이 설정합니다:

Authentication: 생성한 Google OAuth 자격
Operation: Upload
File Name: 저장할 파일 이름 지정 (예: exchange_{{ $now.format("YYYY-MM-DD") }}.json)
File Content: Set 노드 등에서 받아온 JSON 또는 텍스트 데이터

[이미지2] Google Drive 노드 구성 예시

실습 예제: 환율 데이터를 매일 백업

Cron: 매일 오전 10시 실행
HTTP Request: 환율 API 호출
Set: 파일로 저장할 JSON 구조 정의
Google Drive: 해당 데이터를 파일로 업로드

Set 노드 예시:

{
  "currency": "KRW",
  "rates": {
    "USD": {{$json["rates"]["USD"]}},
    "JPY": {{$json["rates"]["JPY"]}}
  },
  "date": "{{$now.format('YYYY-MM-DD')}}"
}

[이미지3] 전체 워크플로우 구성도

팁

파일 포맷은 .txt, .json, .csv 등 다양하게 지정 가능
Google Drive 내 특정 폴더에 저장하려면 폴더 ID를 지정
동일 파일명을 매번 덮어쓰기하거나, 날짜 기반 파일명을 사용해 누적 저장할 수도 있음

✅ 마무리

Google Drive 연동은 데이터 백업, 리포트 자동화 등에 매우 유용합니다. 다음 편에서는 이메일 첨부파일 자동 다운로드 및 저장 방법을 다뤄보겠습니다.

▶ 전체 시리즈 보기: n8n 시리즈 전체보기

n8n으로 자동화 시작하기 8편 - Slack으로 알림 메시지 전송하기

backend.log — Sat, 14 Jun 2025 12:34:18 +0900

n8n으로 자동화 시작하기 8편 - Slack으로 알림 메시지 전송하기

이번 편에서는 n8n에서 수집한 정보를 Slack 채널로 자동 전송하는 방법을 알아보겠습니다. 예를 들어 환율 정보, 에러 알림, 크론 기반 보고서 등 다양한 업무 자동화에 활용할 수 있습니다.

Slack API 사전 설정

Slack API 페이지에서 새 앱을 생성합니다.
OAuth & Permissions 메뉴에서 chat:write 권한을 추가합니다.
Install to Workspace → Bot User OAuth Token을 복사합니다.
n8n 내 Credentials 메뉴에서 Slack 인증을 생성하고 토큰을 등록합니다.

Slack 채널 ID도 확인이 필요합니다. 예: C01XXXXXXX

[이미지1] Slack API 설정 화면

⚙️ Slack 노드 구성하기

Slack 노드는 매우 간단하게 구성됩니다:

Authentication: 등록한 Slack Credential 선택
Channel: 메시지를 보낼 채널 ID 입력
Text: 전송할 메시지 내용을 템플릿 또는 변수로 작성

[이미지2] Slack 노드 설정 예시

실습 예제: 환율 정보를 Slack으로 전송

이전 7편에서 사용한 환율 API와 연동하여, 매일 오전 환율 정보를 Slack 채널에 자동 전송해보겠습니다.

워크플로우 구성

Cron 노드: 매일 오전 9시 실행
HTTP Request 노드: 환율 정보 API 호출
Slack 노드: 환율 정보를 채널로 전송

[이미지3] 전체 워크플로우 구성 예시

Slack 메시지 내용

  오늘의 환율 정보 (KRW 기준)
- USD: {{$json["rates"]["USD"]}}
- JPY: {{$json["rates"]["JPY"]}}

활용 팁

Slack 메시지에는 `코드블럭`, 굵은 글씨, 이모지 등을 사용할 수 있습니다.
Slack 채널에 봇이 초대되어 있어야 메시지를 전송할 수 있습니다. /invite @BotName 사용
Slack 외에 Discord, Telegram도 유사한 방식으로 연동 가능합니다.

✅ 마무리

Slack 연동은 정보 공유와 팀 커뮤니케이션 자동화에 큰 장점이 있습니다. 특히 알림, 경고, 보고서 자동화에 유용합니다.

다음 편에서는 외부에서 수집한 데이터를 Google Drive 또는 Dropbox에 자동 저장하는 방법을 알아보겠습니다.

▶ 전체 시리즈 보기: n8n 전체 시리즈

n8n으로 자동화 시작하기 7편 - HTTP Request 노드로 외부 API 호출하기

backend.log — Fri, 13 Jun 2025 19:35:32 +0900

n8n으로 자동화 시작하기 7편 - HTTP Request 노드로 외부 API 호출하기

n8n의 HTTP Request 노드는 외부 API와 연동하여 데이터를 가져오고, 가공하고, 자동화하는 데 필수적인 노드입니다. 이 기능을 활용하면 REST API 기반의 서비스와 자유롭게 통신할 수 있습니다.

HTTP Request 노드란?

HTTP Request 노드는 외부 API 서버에 GET / POST / PUT / DELETE 등의 HTTP 요청을 보낼 수 있습니다. 예를 들어:

환율 정보 API 호출
슬랙 메시지 보내기
공공데이터포털에서 날씨 정보 가져오기

아래는 예시 화면입니다:

실습 예시: 무료 환율 API 호출

예제에서는 exchangerate.host에서 제공하는 무료 환율 API를 활용합니다.

목표: 매일 원화(KRW)의 미국 달러(USD), 일본 엔화(JPY) 환율을 가져오기

1. Cron 노드로 매일 실행

0 9 * * * - 매일 오전 9시

2. HTTP Request 노드 설정

HTTP Method: GET
URL: https://api.exchangerate.host/latest?base=KRW&symbols=USD,JPY

요청 결과는 다음과 같이 JSON 형태로 반환됩니다:

{
  "base": "KRW",
  "rates": {
    "USD": 0.00072,
    "JPY": 0.11
  },
  "date": "2025-06-12"
}

3. Set 노드로 가공

HTTP Request 노드의 데이터를 가져와 가독성 좋게 변환합니다:

USD: {{$json["rates"]["USD"]}}
JPY: {{$json["rates"]["JPY"]}}

4. 결과 출력

Webhook Response 또는 Slack 등 원하는 곳에 출력할 수 있습니다.

활용 팁

Headers 설정: 인증 토큰(Bearer Token) 등이 필요할 경우 Headers 탭에 추가 가능
POST 요청: POST 방식으로 JSON 데이터를 전송할 수 있음
API Key: 보안이 필요한 API는 API Key를 `.env` 또는 Credential에 등록하는 것이 안전

✅ 정리

n8n의 HTTP Request 노드를 통해 외부 API를 쉽게 연동할 수 있으며, 이를 다양한 자동화 시나리오에 연결하면 업무 효율을 크게 높일 수 있습니다.

다음 편에서는 가져온 데이터를 Slack, Discord 등 알림 메시지

전체 시리즈 보기: n8n시리즈

n8n으로 자동화 시작하기 6편 - Cron 트리거로 정해진 시간마다 워크플로우 실행하기

backend.log — Thu, 12 Jun 2025 10:28:11 +0900

n8n의 강력한 기능 중 하나는 Cron 트리거를 통해 특정 시간에 자동으로 워크플로우를 실행할 수 있다는 점입니다. 서버 관리, 리포트 전송, 데이터 백업 등 다양한 자동화를 시간 기반으로 수행할 수 있죠.

Cron 트리거란?

Cron은 유닉스/리눅스 기반의 작업 스케줄러로, 특정 시간이나 주기에 따라 명령어 또는 스크립트를 실행하는 데 사용됩니다. n8n에서는 이를 시각적으로 설정할 수 있어 훨씬 편리합니다.

예를 들어:

매일 오전 9시에 메일 전송

매주 월요일 데이터 백업

매월 1일 매출 리포트 정리

⚙️ Cron 노드 설정 방법

1. 노드 추가 → "Cron" 검색 → 선택

2. "Trigger Times" 섹션에서 다음과 같이 설정합니다:

Mode: Every Minute, Every Hour, Every Day 중 선택 가능

Custom: 필요시 Cron 표현식 직접 입력 가능 (예: 0 9 * * 1 = 매주 월요일 9시)

예시: 매일 오전 9시에 구글 시트에 데이터 적재

아래 워크플로우는 매일 9시에 데이터를 Set 노드로 설정한 뒤, Google Sheets에 저장합니다.

Cron - 매일 9시 트리거

Set - 수동 데이터 설정

Google Sheets - 시트에 데이터 추가

✅ Cron 표현식 예시 정리

목표 Cron 표현식

매일 9시 0 9 * * *

매주 월요일 10시 0 10 * * 1

매월 1일 자정 0 0 1 * *

매 5분 간격 */5 * * * *

주의사항

n8n이 실행 중인 서버/호스팅이 꺼져 있으면 트리거가 동작하지 않습니다.

실제 시간대(Timezone)는 서버 또는 n8n 설정에 따라 다를 수 있습니다.

마무리

이제 Cron 트리거를 통해 반복적인 작업을 자동화할 수 있습니다. 다음 편에서는 외부 API를 호출해 데이터를 가져오는 HTTP Request 노드를 소개하겠습니다.

전체 시리즈 보기: n8n전체 시리즈

n8n 자동화 가이드 - 5편: Google Sheets & MySQL을 활용한 데이터 저장 자동화

backend.log — Fri, 6 Jun 2025 19:09:39 +0900

n8n 자동화 가이드 - 5편: Google Sheets & MySQL을 활용한 데이터 저장 자동화

이전 글에서는 외부에서 데이터를 수신하고 가공하는 기본 워크플로우를 구성해보았습니다. 이번 편에서는 수집한 데이터를 Google Sheets 또는 MySQL에 자동 저장하는 과정을 다루겠습니다. 이는 실제 업무에서 많이 활용되는 형태로, 고객 문의 기록, 주문 데이터 저장, 로그 수집 등 다양한 업무에 응용할 수 있습니다.

워크플로우 구성도

이번 예제에서는 다음과 같은 흐름으로 구성합니다:

Webhook: 외부에서 POST 요청으로 데이터 수신

Set: 데이터 정제

Google Sheets 또는 MySQL: 정제된 데이터를 저장

Webhook Response: 응답 반환

1. Webhook 노드 설정

먼저 n8n에서 Webhook 노드를 생성합니다.

HTTP Method: POST

Path: save-to-db

예제 요청 URL: http://localhost:5678/webhook/test/save-to-db

샘플 요청 데이터 (JSON):

{ "name": "홍길동", "email": "hong@example.com", "message": "자동화 테스트입니다." }

2. Set 노드로 필드 정제

Webhook 다음에는 Set 노드를 연결하여 필요한 필드만 추출합니다.

Keep Only Set: 체크

name: {{$json["body"]["name"]}}

email: {{$json["body"]["email"]}}

message: {{$json["body"]["message"]}}

3. Google Sheets 또는 MySQL로 저장

✅ A. Google Sheets 사용 시

‘Google Sheets’ 노드 추가

Action: Append Sheet

Credential: OAuth2로 구글 계정 연동

Spreadsheet ID, Sheet Name 입력

‘Auto Map Input Data’ 체크

⚠️ 참고: 사전에 Google 시트를 생성하고, 첫 행에 name, email, message를 입력해두어야 자동 매핑이 가능합니다.

✅ B. MySQL 사용 시

‘MySQL’ 노드 추가

Action: Insert

Credential: DB 연결 정보 입력 (Host, User, Password, Database)

Table: 예를 들어 inquiries

예시 테이블 스키마:

CREATE TABLE inquiries ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50), email VARCHAR(100), message TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP );

4. Webhook Response 설정

저장이 완료되면 응답을 반환하기 위해 Webhook Response 노드를 연결합니다.

Response Mode: On Received

Response Data: JSON 형태로 간단한 메시지 반환

{ "status": "success", "message": "Data saved successfully." }

5. 테스트

터미널에서 curl 명령으로 테스트할 수 있습니다.

curl -X POST http://localhost:5678/webhook/test/save-to-db \ -H "Content-Type: application/json" \ -d '{"name":"홍길동", "email":"hong@example.com", "message":"자동화 테스트입니다."}'

요청이 정상적으로 처리되면 Google Sheet 혹은 DB에 값이 저장되고 응답도 확인할 수 있습니다.

✅ 마무리

이번 글에서는 n8n을 이용해 외부에서 데이터를 수신한 후 Google Sheets 또는 MySQL에 자동 저장하는 전체 과정을 구성해보았습니다. 이 방식은 반복적인 수기 입력을 줄이고, 다양한 실무 자동화에 활용 가능합니다.

다음 편에서는 조건 분기(IF), 반복 처리(Loop), 데이터 병합(Merge) 등의 고급 노드를 활용한 실전 자동화 예제를 다루겠습니다.

n8n 자동화 가이드 전체 시리즈 보러가기

n8n 자동화 가이드 - 4편: Webhook + 외부 API 자동화 실습

backend.log — Thu, 5 Jun 2025 19:06:06 +0900

n8n 자동화 가이드 - 4편: Webhook + 외부 API 자동화 실습

지난 글에서는 n8n의 UI 구성과 워크플로우 설계의 기본 개념을 알아보았습니다. 이제 본격적으로 n8n의 실전 예제를 통해 자동화 프로세스를 구성해보겠습니다.

이번 편에서는 Webhook 노드를 이용해 외부 요청을 수신하고, API 요청 결과를 자동으로 응답하는 간단한 워크플로우를 만들어봅니다.

1. 예제 시나리오

아래와 같은 프로세스를 구현할 것입니다:

Webhook 노드가 외부 HTTP 요청을 수신함

HTTP Request 노드가 외부 API(예: JSONPlaceholder) 호출

결과 데이터를 Set 노드를 통해 정제

Webhook Response 노드를 통해 클라이언트에게 결과 반환

2. 새 워크플로우 생성

n8n 대시보드에서 “New Workflow”를 클릭하여 새로운 자동화 흐름을 시작합니다.

3. Webhook 노드 설정

노드 추가: ‘Webhook’ 노드를 검색하여 추가합니다.

HTTP Method: GET

Path: get-post (예: /webhook/get-post)

노드를 저장하면 n8n이 자동으로 Webhook URL을 생성해줍니다. 예시:

http://localhost:5678/webhook/test/get-post

주의: 워크플로우를 테스트하려면 ‘Execute Node’를 클릭한 상태에서 외부 요청을 보내야 합니다.

4. HTTP Request 노드 추가

노드 추가: ‘HTTP Request’ 노드를 검색하여 추가

Method: GET

URL: https://jsonplaceholder.typicode.com/posts/1

Webhook 노드와 연결

이 예제는 JSONPlaceholder의 더미 데이터를 가져오는 API입니다.

5. Set 노드로 데이터 가공

‘Set’ 노드를 추가한 후, HTTP Request 노드와 연결

‘Keep Only Set’ 옵션 활성화

다음 필드를 추가:

title = {{$json["title"]}}

body = {{$json["body"]}}

이 노드를 통해 출력 데이터를 깔끔하게 정리할 수 있습니다.

6. Webhook Response 노드 추가

‘Webhook Response’ 노드를 추가하고, Set 노드와 연결

Response Mode는 On Received

Response Data From은 Last Node

이제 Webhook으로 들어온 요청에 대해 외부 API 결과를 응답으로 되돌려주게 됩니다.

7. 테스트

워크플로우 상단에서 “▶ Execute Workflow”를 누른 뒤, 새 탭에서 다음 URL을 호출합니다:

curl http://localhost:5678/webhook/test/get-post

정상적으로 작동하면 다음과 같은 JSON 결과가 출력됩니다:

{ "title": "sunt aut facere repellat provident occaecati", "body": "quia et suscipit suscipit recusandae consequuntur expedita et cum" }

8. 워크플로우 활성화 및 배포

테스트가 완료되면 상단의 “Activate” 버튼을 눌러 워크플로우를 실제로 서비스할 수 있습니다.
Webhook 노드가 production URL을 제공하며, 이 주소로 외부 애플리케이션에서 요청을 보낼 수 있습니다.

9. 마무리

이번 편에서는 Webhook을 통해 외부 요청을 수신하고, 외부 API에서 데이터를 가져와 처리한 후 결과를 반환하는 단순하지만 실용적인 자동화 흐름을 설계해보았습니다.

n8n을 활용하면 반복적인 API 연동, 데이터 수집, 슬랙 메시지 전송, 엑셀 파일 가공 등 다양한 자동화를 구현할 수 있습니다.

다음 편에서는 실시간 데이터 저장 및 DB 연동 (MySQL, Google Sheets)과 관련된 자동화 워크플로우를 다룰 예정입니다.

■ n8n 자동화 가이드 시리즈 전체 보기

n8n 자동화 가이드 - 3편: n8n UI 구조와 워크플로우 설계의 기초

backend.log — Wed, 4 Jun 2025 19:03:33 +0900

n8n 자동화 가이드 - 3편: n8n UI 구조와 워크플로우 설계의 기초

지난 글에서는 Docker를 이용해 n8n을 직접 서버에 설치하고 실행하는 과정을 살펴봤습니다. 이번 편에서는 n8n의 사용자 인터페이스(UI)를 이해하고, 워크플로우 설계를 시작하기 위한 기본 개념을 설명합니다.

1. n8n 대시보드 구조 이해하기

n8n에 접속하면 가장 먼저 다음과 같은 구성의 대시보드가 나타납니다.

워크플로우 목록 (Workflows): 지금까지 저장한 모든 워크플로우를 확인할 수 있는 메인 화면입니다.

새 워크플로우 생성 (New Workflow): 새로운 자동화 플로우를 설계할 때 사용합니다.

Settings / Credentials / Executions:

Credentials: API 연동 시 사용할 인증 정보를 저장하는 공간입니다.

Executions: 실행된 워크플로우 로그 및 결과를 확인할 수 있습니다.

이 UI는 단순하면서도 직관적이라, 비개발자도 쉽게 접근할 수 있다는 것이 큰 장점입니다.

2. 워크플로우란?

워크플로우(Workflow)는 n8n에서 하나의 자동화 로직을 구성하는 단위입니다. 각 워크플로우는 다음과 같은 요소로 구성됩니다:

노드(Node): 하나의 기능 또는 작업 단위입니다. (예: 이메일 전송, HTTP 요청, 구글 시트 업데이트 등)

연결선(Edge): 노드 간의 실행 흐름을 연결합니다.

트리거(Trigger): 워크플로우를 시작하는 시점입니다. (예: 일정 시간마다, Webhook 수신 시 등)

노드를 직관적으로 연결하면서 시각적으로 자동화 흐름을 설계할 수 있어, 코드 작성 없이도 복잡한 프로세스를 만들 수 있습니다.

3. 첫 워크플로우 설계해 보기

간단한 예제를 통해 워크플로우 설계 과정을 알아보겠습니다. 아래는 Webhook → 이메일 전송 자동화 예제입니다.

Webhook 노드 추가: 트리거 역할. 외부에서 HTTP 요청이 들어오면 워크플로우를 실행합니다.

Send Email 노드 추가: Webhook에서 받은 데이터를 기반으로 이메일을 전송합니다.

노드를 연결하고 저장한 후, "Activate" 버튼을 클릭하면 워크플로우가 활성화되어 외부 요청에 반응할 준비가 됩니다.

4. 주요 노드 살펴보기

n8n은 200개 이상의 다양한 노드를 기본 제공하며, 대표적인 노드는 다음과 같습니다:

노드 이름 기능 설명

Webhook 외부 요청을 받아 워크플로우 실행 시작

HTTP Request 외부 API 호출 (GET/POST/PUT 등)

Set 데이터 구조 수정 및 필드 지정

IF 조건 분기 처리

Function JavaScript를 이용한 고급 로직 구현

Send Email 이메일 전송 (SMTP 설정 필요)

5. 실행 방식과 디버깅

워크플로우를 설계하고 나면, 좌측 상단의 “▶ Execute Workflow” 버튼으로 직접 테스트해볼 수 있습니다. 각 노드는 실행 시 입력(input)과 출력(output) 데이터를 확인할 수 있어 디버깅이 매우 용이합니다.

또한 워크플로우 실행 이력은 Executions 메뉴에서 확인 가능하며, 오류 발생 시 어떤 노드에서 어떤 값이 잘못되었는지 쉽게 추적할 수 있습니다.

6. 마무리

이번 편에서는 n8n의 UI 구성과 워크플로우 설계의 기본 원리를 살펴봤습니다. 다음 글에서는 실제로 Webhook과 외부 API를 연동하여 데이터를 자동 수집하고 가공하는 예제를 진행해볼 예정입니다.

자동화는 더 이상 전문가들만의 영역이 아닙니다. 이제 누구나 시각적으로 손쉽게, 강력한 업무 자동화를 실현할 수 있습니다.

■ n8n 자동화 가이드 시리즈 전체 보기

n8n 자동화 가이드 - 2편: Docker로 n8n 설치하기

backend.log — Tue, 3 Jun 2025 19:01:28 +0900

n8n 자동화 가이드 - 2편: Docker로 n8n 설치하기

이전 글에서 n8n이 무엇인지와 왜 주목받고 있는지에 대해 살펴봤습니다. 이번 글에서는 본격적으로 n8n을 서버에 설치하는 방법을 알아보겠습니다. 가장 많이 사용되는 방식인 Docker + Docker Compose 환경을 기준으로 설명합니다.

1. 설치 준비물

다음은 n8n 설치를 위해 필요한 사전 조건입니다:

Linux 기반 서버 (예: Ubuntu 20.04 이상)

Docker & Docker Compose 설치

도메인 (선택, HTTPS 적용 시 필요)

로컬에서 테스트하려면 Mac 또는 Windows 환경에서도 Docker만 설치되어 있으면 진행 가능합니다.

2. Docker 및 Docker Compose 설치

우분투 기준으로 Docker 설치는 아래 명령어를 차례대로 실행하면 됩니다:

sudo apt update sudo apt install -y docker.io docker-compose sudo systemctl enable docker sudo systemctl start docker

설치 후 아래 명령어로 정상 작동 여부를 확인합니다:

docker --version docker-compose --version

3. n8n을 위한 디렉토리 구성

n8n을 설치할 디렉토리를 만들고, 설정 파일을 구성합니다.

mkdir ~/n8n cd ~/n8n touch docker-compose.yml touch .env

.env 파일은 다음과 같이 작성합니다:

# .env N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=securepassword N8N_HOST=localhost N8N_PORT=5678 N8N_PROTOCOL=http

주의: 비밀번호는 보안을 위해 반드시 복잡하게 설정하세요.

4. docker-compose.yml 작성

docker-compose.yml 파일은 다음과 같이 구성합니다:

version: "3" services: n8n: image: n8nio/n8n ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=${N8N_BASIC_AUTH_ACTIVE} - N8N_BASIC_AUTH_USER=${N8N_BASIC_AUTH_USER} - N8N_BASIC_AUTH_PASSWORD=${N8N_BASIC_AUTH_PASSWORD} - N8N_HOST=${N8N_HOST} - N8N_PORT=${N8N_PORT} - N8N_PROTOCOL=${N8N_PROTOCOL} volumes: - ./n8n_data:/home/node/.n8n restart: always

이 구성은 n8n을 http://localhost:5678에서 실행하며, 기본 인증을 활성화해 외부 접근을 제한합니다.

5. n8n 실행

이제 아래 명령어로 n8n을 실행합니다:

docker-compose up -d

정상적으로 실행되면, 브라우저에서 다음 주소로 접속해 확인할 수 있습니다:

http://localhost:5678

설정한 아이디/비밀번호로 로그인하면 n8n의 시각적 워크플로우 편집 화면을 확인할 수 있습니다.

6. HTTPS 적용 (선택)

도메인이 있다면, Nginx + Let's Encrypt를 활용해 HTTPS를 적용할 수 있습니다. 이 부분은 별도의 글로 따로 다룰 예정입니다.

7. 자주 발생하는 오류 및 해결 방법

포트 충돌: 다른 프로세스가 5678 포트를 이미 사용 중인 경우 N8N_PORT를 변경하거나 해당 프로세스를 종료하세요.

접속 불가: 서버 방화벽에서 5678 포트를 허용했는지 확인하세요.

데이터 초기화: ./n8n_data 폴더에 저장된 데이터가 n8n의 모든 설정과 워크플로우를 포함하므로, 삭제 시 주의하세요.

8. 마무리

여기까지 n8n을 Docker 환경에 설치하고 실행하는 기본적인 과정을 살펴봤습니다. 이제 n8n의 UI에서 직접 워크플로우를 구성할 준비가 끝났습니다.

다음 편에서는 n8n의 기본 인터페이스 구성과 노드(Node)의 개념, 워크플로우 설계 흐름을 이해하는 데 필요한 기초 지식을 다룰 예정입니다.

■ n8n 자동화 가이드 시리즈 전체 보기

n8n 자동화 가이드 - 1편: n8n이란? 워크플로우 자동화의 새로운 기준

backend.log — Mon, 2 Jun 2025 19:00:51 +0900

n8n 자동화 가이드 - 1편: n8n이란? 워크플로우 자동화의 새로운 기준

최근 업무 자동화 도구에 대한 관심이 폭발적으로 증가하면서, 다양한 플랫폼들이 주목받고 있습니다. 그중에서도 n8n은 오픈 소스 기반의 유연하고 강력한 워크플로우 자동화 도구로 빠르게 성장하고 있는데요. 이번 시리즈에서는 n8n의 개념부터 설치, 기본 사용법, 실전 활용까지 단계별로 꼼꼼히 살펴보겠습니다.

1. n8n이란 무엇인가?

n8n은 “노 코드(No Code)”와 “로우 코드(Low Code)” 방식을 결합한 워크플로우 자동화 툴입니다. 다양한 웹 서비스와 애플리케이션을 연결해 데이터를 자동으로 주고받으며, 반복 작업을 효율적으로 처리할 수 있도록 돕습니다.

기존의 상용 자동화 서비스들이 대부분 클라우드 기반으로 제한된 커스터마이징을 제공하는 것과 달리, n8n은 완전한 오픈 소스이며, 사용자가 직접 서버에 설치해 데이터 소유권을 100% 보장받을 수 있다는 점이 가장 큰 강점입니다.

2. n8n이 특별한 이유

오픈 소스 프로젝트: GitHub에서 소스 코드를 자유롭게 열람하고 수정 가능하며, 커뮤니티가 활발하게 기능을 개선하고 있습니다.

자체 호스팅 지원: 데이터 보안과 프라이버시가 중요한 기업 환경에서도 안전하게 운영할 수 있습니다.

유연한 확장성: 기본 제공되는 200개 이상의 노드(Node) 외에도, 커스텀 노드를 만들어 복잡한 업무 로직도 구현할 수 있습니다.

시각적 워크플로우 설계: 복잡한 코딩 없이도 끌어다 놓기 방식으로 자동화 프로세스를 설계할 수 있어, 비개발자도 쉽게 접근 가능합니다.

3. 경쟁 서비스와의 비교

대표적인 워크플로우 자동화 도구인 Zapier, Make (구 Integromat)과 비교하면 다음과 같은 특징이 있습니다.

특징 n8n Zapier Make

오픈 소스 여부 ✔️ ❌ ❌

자체 서버 설치 가능 ✔️ 불가 부분 지원

무료 플랜 제공 ✔️ (제한적) ✔️ (제한적) ✔️ (제한적)

노 코드/로우 코드 설계 ✔️ ✔️ ✔️

커스텀 노드 작성 가능 ✔️ 제한적 제한적

커뮤니티 지원 강력함 상업적 중간

4. n8n 설치 방식과 이번 시리즈 방향

n8n은 다양한 설치 방법을 제공합니다.

Docker 기반 설치: 가장 많이 사용되는 방법이며, 서버 환경에 독립적이고 안정적입니다.

npm 직접 설치: Node.js 환경에 익숙한 사용자에게 적합합니다.

n8n 클라우드: 관리형 서비스로 서버 관리 부담 없이 빠르게 시작 가능하지만, 비용이 발생합니다.

이번 시리즈에서는 실제 업무 환경에서 가장 많이 활용되는 Docker 기반 설치를 중심으로 다룹니다. 설치 후 기본 설정부터, 워크플로우 작성, 실전 자동화 사례까지 단계적으로 설명할 예정이니 차근차근 따라와 주세요.

5. 마치며

자동화는 단순 반복 업무를 줄여주고, 인간이 보다 창의적인 일에 집중할 수 있게 만드는 강력한 도구입니다. n8n은 이런 자동화에 대한 접근성을 크게 낮추면서도 높은 확장성을 제공하는 훌륭한 선택지입니다.

다음 편에서는 실제 환경에 n8n을 설치하는 과정을 자세히 안내합니다. Docker 설치부터 기본 환경 설정, 자주 마주치는 문제 해결 팁까지 폭넓게 다룰 예정이니 기대해 주세요!

■ n8n 자동화 가이드 시리즈 전체 보기

목표	Cron 표현식
매일 9시	`0 9 * * *`
매주 월요일 10시	`0 10 * * 1`
매월 1일 자정	`0 0 1 * *`
매 5분 간격	`/5 * * *`

노드 이름	기능 설명
Webhook	외부 요청을 받아 워크플로우 실행 시작
HTTP Request	외부 API 호출 (GET/POST/PUT 등)
Set	데이터 구조 수정 및 필드 지정
IF	조건 분기 처리
Function	JavaScript를 이용한 고급 로직 구현
Send Email	이메일 전송 (SMTP 설정 필요)

특징	n8n	Zapier	Make
오픈 소스 여부	✔️	❌	❌
자체 서버 설치 가능	✔️	불가	부분 지원
무료 플랜 제공	✔️ (제한적)	✔️ (제한적)	✔️ (제한적)
노 코드/로우 코드 설계	✔️	✔️	✔️
커스텀 노드 작성 가능	✔️	제한적	제한적
커뮤니티 지원	강력함	상업적	중간