본문으로 건너뛰기

n8n 자체 호스팅 스킬

Docker 기반 n8n을 배포·유지하며 Caddy HTTPS, 비공개 서비스와 검증된 백업을 구성합니다.

커뮤니티 · Romuald Członkowski
작성자Romuald Członkowski
라이선스MIT
소스czlonkowski/n8n-skills · GitHub의 SKILL.md
프로젝트 웹사이트docs.n8n.io/deploy/host-n8n
작동 환경Claude Code · Codex, Gemini CLI, Cursor, Copilot
소스 확인 날짜

n8n-self-hosting은 새 Linux VM에서 Docker Compose와 Caddy로 HTTPS n8n을 구축하도록 에이전트를 안내합니다.

단일 SQLite 배포와 Postgres·Redis·외부 실행기를 짝짓는 큐 모드를 구분합니다. 워크플로 제작기가 아닌 운영 스킬입니다.

스킬의 SKILL.md에서: # Deploying self-hosted n8n

Romuald Członkowski의 커뮤니티 스킬로, 저희나 Anthropic이 검토하지 않았습니다. 스킬은 에이전트에게 코드 실행, 파일 읽기, 네트워크 호출을 지시할 수 있습니다. 설치하기 전에 SKILL.md와 폴더 안의 모든 스크립트를 읽고, 설명과 맞지 않는 동작이 없는지 확인하세요.

하는 일

  1. 배포 전에 모드, 도메인, SSH와 시간대를 수집합니다.
  2. 서버에서 새 비밀값을 만들고 내부 서비스를 비공개로 유지합니다.
  3. 상태, TLS와 워커를 확인하고 백업·복원을 문서화합니다.

얻을 수 있는 결과물

  • Compose 구성, Caddyfile과 비공개 환경 파일.
  • 배포 확인과 운영 후 유지보수 인계.

이럴 때 사용하세요

  • 허가된 Linux 서버에 n8n을 배포할 때.
  • Python 실행기나 큐 워커 설정을 고칠 때.

이럴 때는 맞지 않습니다

  • 워크플로를 만들거나 n8n Cloud를 관리할 때.

필요한 것

  • Linux VM, root 또는 sudo SSH, 도메인 DNS, 공개 포트 80/443.
  • Docker Compose와 Caddy. 서버, 도메인과 선택 n8n 유료 기능은 별도 비용입니다.

스킬에 들어 있는 파일

파일 또는 폴더용도
SKILL.md모드 선택과 배포 순서.
TASK_RUNNERS.md외부 Python·JavaScript 실행기 설정.
DAY2.md업데이트, 백업과 복원 절차.
assets/단일·큐 Compose, Caddy와 환경 설정 템플릿.

2026-11-17 기준 저장소에 있는 라이선스: MIT.

예시 프롬프트

설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.

  • 내 Linux VM에 단일 인스턴스를 계획하고 변경 전에 DNS와 접근 권한을 확인하세요.
  • 큐 배포의 워커 환경 일치와 짝지어진 외부 실행기를 검토하세요.
  • n8n 암호화 키를 보존하는 백업·복원 점검표를 작성하세요.

n8n-self-hosting 설치 방법

서버 접근

개별 폴더는 SSH와 시스템 작업이 필요합니다. Claude.ai 업로드나 격리 API로 전체 흐름을 수행하는 것은 여기서 검증하지 않았습니다.

전체 n8n 플러그인은 라우팅과 훅도 추가합니다. 배포 안내만 필요하면 전체 묶음 대신 이 폴더만 복사하세요.

스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.

Claude Code: 스킬 폴더에 복사

이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-self-hosting ~/.claude/skills/

Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /n8n-self-hosting를 입력하거나 작업을 설명하면 됩니다.

Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.

Codex, Gemini CLI, Cursor, GitHub Copilot

이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-self-hosting .agents/skills/
에이전트프로젝트 폴더사용자 폴더참고
OpenAI Codex
.agents/skills/
~/.agents/skills/
$를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상).
신뢰할 수 있는 스킬만 설치하세요. Anthropic은 신뢰할 수 있는 출처의 스킬만 사용하고, 그 밖의 스킬은 사용하기 전에 모든 파일을 읽어 보라고 권합니다. 스킬은 설명에 나오지 않는 방식으로 에이전트에게 명령어 실행, 파일 읽기, 데이터 전송을 지시할 수 있기 때문입니다.

이 단계의 출처

2026-11-14에 각 업체의 문서와 대조해 확인했습니다:

운영 범위

기존 인스턴스에서 명령을 실행하기 전에 대상, 점검 시간과 백업을 확인하세요. 템플릿만으로 서버가 정상임을 증명할 수는 없습니다.

자체 호스팅 n8n의 에디션과 라이선스는 이 MIT 스킬과 별개입니다.

n8n-self-hosting에 관한 질문

n8n-mcp가 필요한가요?

배포는 SSH와 Docker를 사용합니다. n8n-mcp는 워크플로 제작 묶음에 속하며 서버 구축에는 필요하지 않습니다.

어느 모드를 선택하나요?

배포 전에 단일 또는 큐를 명확히 고르세요. 큐는 Postgres와 Redis가 필요하며 SQLite는 사용하지 않습니다.

저장된 자격 증명을 잃을 수 있나요?

암호화 키를 잃거나 바꾸면 그럴 수 있습니다. 데이터와 함께 키를 서버 밖에 안전하게 백업하세요.

HTTP 상태 응답이면 충분한가요?

아닙니다. 공개 TLS, 준비 상태와 필요한 경우 워커 환경·실행기까지 확인합니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리