메인 콘텐츠로 건너뛰기
자체 머신에 n8n을 배포하고 커뮤니티 노드를 통해 CometAPI에 연결하여 자동화된 AI 워크플로를 로컬에서 실행하세요.

​
사전 준비 사항

  • Linux(Ubuntu/Debian/CentOS 등) 또는 macOS
  • RAM 2GB 이상, 여유 디스크 공간 10GB 이상
  • 공개 npm 레지스트리에 접근 가능한 셸 환경
  • Node.js 18.x 또는 20.x LTS(1단계 참고)
  • 활성 API 키가 있는 CometAPI 계정 — 여기에서 발급받으세요
1

CometAPI API 키 받기

CometAPI 콘솔에 로그인합니다. Add API Key를 클릭하고 sk-xxxxx 키를 복사합니다.
Add API Key 버튼이 표시된 CometAPI 대시보드
base URL이 포함된 CometAPI API 키 세부 정보
2

nvm으로 Node.js 설치하기

n8n 1.x는 Node.js 18.x 또는 20.x가 필요합니다. 권장 방식은 nvm입니다:
# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reload your shell profile
source ~/.bashrc   # or ~/.zshrc on macOS

# Install and activate the LTS version
nvm install --lts
nvm use --lts

# Verify
node -v
npm -v
나중에 n8n: command not found가 표시되면 터미널을 다시 시작하거나, nvm이 관리하는 npm 전역 bin 디렉터리가 PATH에 포함되어 있는지 확인하세요.
3

n8n 설치 및 시작

npm install -g n8n
n8n -v       # verify the installed version
n8n start    # runs on http://localhost:5678/
포트 5678이 이미 사용 중이라면:
export N8N_PORT=5679
n8n start
터미널을 닫은 뒤에도 n8n이 계속 실행되게 하려면:
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
n8n이 성공적으로 시작되는 터미널 화면
터미널의 n8n 시작 로그
4

소유자 계정 만들기

브라우저에서 http://localhost:5678/을 엽니다. 처음 실행하면 설정 마법사가 Owner 계정(이메일 + 비밀번호) 생성을 요청합니다. 설정을 완료한 뒤 로그인하세요.
Owner 계정 정보를 요청하는 n8n 첫 실행 설정 마법사
5

CometAPI 커뮤니티 노드 설치하기

  1. Settings(좌측 하단) → Community nodes로 이동합니다
  2. Install a community node를 클릭합니다
  3. 패키지 이름 @cometapi-dev/n8n-nodes-cometapi를 입력합니다
  4. 위험 고지 확인 박스를 체크한 뒤 Install을 클릭합니다
설치가 끝나면 노드 패널에서 CometAPI를 검색할 수 있습니다.
Community nodes 섹션이 표시된 n8n Settings 패널
CometAPI 패키지 이름이 입력된 설치 대화상자
Community Nodes 섹션이 보이지 않으면 Owner 계정으로 로그인되어 있는지 확인하고, Settings → Security에서 커뮤니티 노드 설치가 활성화되어 있는지도 확인하세요.
6

워크플로 생성 및 자격 증명 구성

  1. 상단의 + New를 클릭해 워크플로를 생성합니다.
  2. 캔버스에서 **+**를 클릭하고 CometAPI를 검색해 노드를 추가합니다.
CometAPI 노드 검색이 열린 n8n 워크플로 캔버스
n8n 캔버스에 추가된 CometAPI 노드
  1. Manual Trigger 노드를 추가하고 CometAPI 노드에 연결합니다.
  2. CometAPI 노드의 Credential to connect with에서 Create new를 선택합니다. sk-xxxxx 키를 CometAPI Key에 붙여넣고 Save를 클릭합니다. Base URL의 기본값은 https://api.cometapi.com이며, 보통 변경할 필요가 없습니다.
API 키가 입력된 CometAPI 자격 증명 대화상자
  1. 노드를 구성합니다:
  • Model: 사용할 현재 모델 ID를 입력합니다
  • Messages: Role을 user로 설정하고, Content에는 테스트 프롬프트를 입력합니다(예: Hello)
  • 선택 사항: system 메시지를 추가하고, Max Tokens, Temperature 등을 설정합니다.
  1. Execute step을 클릭해 노드를 실행합니다. Output 패널에 JSON 응답이 표시됩니다.
성공적인 CometAPI JSON 응답이 표시된 n8n 출력 패널
  • node-gyp 또는 네이티브 빌드 오류 — 빌드 도구를 설치하세요: sudo apt install build-essential python3(Debian/Ubuntu) 또는 Xcode Command Line Tools(macOS).
  • npm 권한 오류(EACCES) — 사용자 수준의 Node.js 설치를 위해 nvm을 사용하세요. sudo는 필요하지 않습니다.
  • 포트 충돌(localhost:5678 사용 불가) — n8n start 실행 전에 N8N_PORT=5679(또는 다른 사용 가능한 포트)로 설정하세요.
  • Community Nodes 섹션이 없음 — Owner 계정으로 로그인하고 Settings → Security를 확인하세요.
  • 사내 네트워크에서 npm install 실패 — 프록시를 구성하세요: npm config set proxy http://user:pass@host:port
  • CometAPI 노드가 401/403 반환 — API 키가 올바른지, 그리고 해당 모델이 CometAPI 요금제에서 접근 가능한지 확인하세요.
  • 빈 응답 또는 토큰 제한 오류 — Max Tokens를 늘리세요. 필요에 따라 Temperature와 Top P를 조정하세요.
  • 터미널을 닫으면 n8n이 중지됨 — pm2를 사용하세요: pm2 start "n8n" --name n8n && pm2 save.