n8n-self-hosted-diagnostics

---

title: n8n Self-Hosted Diagnostics name: n8n-self-hosted-diagnostics description: npm으로 설치된 n8n 셀프호스트 상태 진단 + launchd 관리 스킬 type: skill space: outcome tags: [skill, n8n, self-hosted, diagnostics] created: 2026-06-01 updated: 2026-06-01 links:

• "[[@action/skills/SKILL-INDEX]]"
• "[[skills/automation/DESCRIPTION]]"
• "[[@identity/brain/rules]]"---

n8n Self-Hosted Diagnostics

npm으로 설치된 n8n 셀프호스트의 상태를 진단하고 launchd로 관리하는 스킬.

환경 (2026-06-01 기준)

• 설치: npm global (/opt/homebrew/lib/node_modules/n8n)
• 실행 경로: /opt/homebrew/bin/n8n → symlink to npm package
• 데이터 경로: ~/.n8n/
• DB: ~/.n8n/database.sqlite (SQLite)
• 설정: ~/.n8n/config (JSON — encryptionKey 포함)
• 포트: 5678
• launchd plist: ~/Library/LaunchAgents/ai.{{AGENT_NAME_LOWER}}.n8n.plist
• 로그: ~/P6-prefrontal/logs/n8n.log, n8n.error.log
• launchd label: ai.{{AGENT_NAME_LOWER}}.n8n
• 업데이트: npm update -g n8n (Homebrew formula 없음)

launchd 관리

# 상태 확인
launchctl list | grep n8n

# 수동 시작
launchctl start ai.{{AGENT_NAME_LOWER}}.n8n

# 수동 정지
launchctl stop ai.{{AGENT_NAME_LOWER}}.n8n

# 재시작
launchctl stop ai.{{AGENT_NAME_LOWER}}.n8n && sleep 2 && launchctl start ai.{{AGENT_NAME_LOWER}}.n8n

# plist reload
launchctl unload ~/Library/LaunchAgents/ai.{{AGENT_NAME_LOWER}}.n8n.plist
launchctl load ~/Library/LaunchAgents/ai.{{AGENT_NAME_LOWER}}.n8n.plist

재부팅 시 RunAtLoad: true로 자동 시작됩니다.

진단 체크리스트

# 1. launchd 상태
launchctl list | grep n8n

# 2. 프로세스 확인
ps aux | grep n8n | grep -v grep

# 3. 포트 LISTEN 확인
lsof -i :5678

# 4. HTTP 응답 확인
curl -s -o /dev/null -w "%{http_code}" http://localhost:5678

# 5. 데이터 디렉토리
ls -la ~/.n8n/

# 6. 로그 확인
tail -20 ~/P6-prefrontal/logs/n8n.log
tail -20 ~/P6-prefrontal/logs/n8n.error.log

계정 복구 — SQLite 직접 초기화 (bcrypt 해시 교체)

n8n은 bcrypt 해시 사용. UI "Forgot my password"가 작동하지 않는 경우 SQLite에서 직접 bcrypt 해시를 교체.

핵심: bcrypt 해시 — $2b$ vs $2a$

최신 n8n (2025~2026)은 $2b$ prefix도 인식함.

import bcrypt, sqlite3, os

DB = os.path.expanduser('~/.n8n/database.sqlite')
new_password = '새비밀번호'

# bcrypt 해시 생성
salt = bcrypt.gensalt(rounds=10)
hashed_str = bcrypt.hashpw(new_password.encode(), salt).decode()

# 유저 확인
conn = sqlite3.connect(DB)
cur = conn.execute('SELECT id, email FROM "user"')
for row in cur.fetchall():
    print(row)

# 비밀번호 업데이트
conn.execute('UPDATE "user" SET password = ? WHERE email = ?', (hashed_str, '대상@이메일.com'))
conn.commit()

# 검증
row = conn.execute('SELECT password FROM "user" WHERE email = ?', ('대상@이메일.com',)).fetchone()
print(f'해시 검증: {bcrypt.checkpw(new_password.encode(), row[0].encode())}')
conn.close()
print('완료 — http://localhost:5678 에서 로그인 시도')