밤샘AI
← 자료실
10월 3.0부터 설치법이 바뀌어요

n8n 한 줄 설치하고 첫 AI 채팅 에이전트 만들기

n8n · Ollama · Docker · 읽는 데 20분 · 2026-09-30 확인

n8n은 블록(노드)을 선으로 이어 업무를 자동화하는 도구예요. 내 컴퓨터나 회사 서버에 직접 깔면(셀프 호스팅) 무료로 쓸 수 있어서 개발자들이 많이 써요.

2026년 10월 나오는 n8n 3.0부터는 예전 방식(npx n8n, npm 설치)이 안 되고 도커로만 배포돼요. 그래서 공식 문서도 새 한 줄 설치를 권해요. 이 글은 그 방법 기준입니다.

1단계n8n 띄우기

  1. Docker Desktop을 깔고 켜 둬요. 도커 명령을 몰라도 괜찮아요.
  2. 맥·리눅스 터미널에서 아래 한 줄을 실행해요. 지금 있는 폴더 안에 n8n 폴더를 만들고 설정 파일까지 알아서 써 줍니다.
    curl -fsSL https://get.n8n.io | sh
  3. 끝에 나온 주소 http://localhost:5678 을 열고 관리자 계정을 만들어요.
  4. 끌 때는 이렇게요. 설치했던 폴더에서 실행하세요.
    docker compose -f ./n8n/compose.yml down

2단계채팅 에이전트 만들기

  1. 새 워크플로를 만들고 첫 노드로 Chat Trigger를 넣어요. 채팅 메시지가 오면 흐름이 시작돼요.
  2. 뒤에 AI Agent 노드를 이어요. 에이전트는 질문을 보고 어떤 도구를 쓸지 스스로 정하는 블록이에요.
  3. AI Agent 아래 Chat Model 자리에 Ollama Chat Model을 붙이고, 새 자격 증명(연결 정보)을 만들어 Base URL을 넣어요. n8n이 도커 안에 있어서 localhost가 아니라 이 주소예요.
    http://host.docker.internal:11434
  4. 모델 칸에서 받아 둔 모델(예: gemma4)을 고르고, Memory 자리에 Simple Memory를 붙여요. 그래야 앞 대화를 기억해요.
  5. 아래쪽 채팅 창을 열어 말을 걸어 보세요. 노드마다 초록 표시가 뜨면 성공이에요.

3단계도구 붙여서 진짜 일 시키기

  1. AI Agent의 Tool 자리에 구글 시트, 슬랙, HTTP Request 같은 노드를 붙이면 에이전트가 필요할 때 직접 불러 써요.
  2. 처음엔 도구 하나만 붙이고, 에이전트 설정의 시스템 메시지에 '언제 이 도구를 쓸지'를 한 줄로 적어 주세요. 도구가 많을수록 헷갈려 해요.

알아 둘 것

라이선스 — Sustainable Use License라는 '공정 코드' 라이선스예요. 사내 업무용은 괜찮지만, n8n 자체를 유료 서비스로 되팔면 안 돼요.
클라우드판은 메시지마다 실행 1회 — 채팅 10번이면 실행 10회로 세요. 셀프 호스팅은 횟수 제한이 없어요.
새 에이전트 기능 — 워크플로 없이 에이전트만 따로 만드는 기능이 미리보기로 나와 있어요. 셀프 호스팅은 추가 설정이 필요해요.
처음엔 선 잇는 게 장난감 같은데, 세 번째 워크플로쯤 가면 퇴근이 빨라져요. 저는 아직 첫 번째예요.
출처 (2026-09-30 확인)
GitHub n8n-io/n8n (Sustainable Use License) — https://github.com/n8n-io/n8n
n8n 문서 — 한 줄 설치 — https://docs.n8n.io/deploy/host-n8n/install-options/one-line-setup
n8n 문서 — Ollama Chat Model 연결 문제 — https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatollama/common-issues
n8n 문서 — Chat Trigger — https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-langchain.chattrigger
Ollama 자주 묻는 질문 — 서버 주소 설정 — https://docs.ollama.com/faq
잠 못 자고 모은 AI 소식, 매일 만나 보세요.

자료는 공식 도움말을 직접 확인해 만들고, 날짜를 적어 둡니다. 서비스 화면은 바뀔 수 있어요.