편집자 보호
편집기를 HTTPS 및 지원되는 인증 뒤에 두십시오. 관리자 액세스를 제한하고 불필요한 경우 공개 등록을 피하십시오. 웹훅 경로에는 자체적인 노출 및 인증 결정이 필요합니다.
자격 증명 키 보관
구성된 암호화 키를 적절한 보호와 함께 백업하세요. 올바른 키 없이 데이터베이스를 복원하면 저장된 자격 증명을 사용할 수 없게 될 수 있습니다. 키를 스크린샷, 저장소, 필터링되지 않은 로그에 남기지 마세요.
실행 경로를 의도적으로 확장하세요
바쁜 환경에서는 지원되는 데이터베이스, 큐 및 워커 모델을 검토하세요. Redis와 별도 워커는 자체적인 접근 및 지속성 요구 사항을 추가합니다. 급증이 VPS 또는 외부 API 예산을 소진하지 않도록 동시 작업을 제한하세요.
유용한 실행 데이터만 보관하세요
워크플로는 토큰, 개인 기록 및 문서를 처리할 수 있습니다. 실행 기록 정리, 민감한 값 마스킹, 재시도 정의를 신중하게 설정하세요. 중복된 웹훅이 의도치 않은 두 번째 결제나 메시지를 유발해서는 안 됩니다.
암호화 키를 데이터베이스의 일부로 취급
저장된 자격 증명은 n8n의 암호화 키에 의존합니다. 자동 생성된 키가 포함된 상태 디렉터리를 보존하거나 비공개 시크릿 저장소에서 N8N_ENCRYPTION_KEY를 설정하세요. 모든 큐 워커는 메인 프로세스와 동일한 키가 필요합니다. 일회용 자격 증명으로 복원을 테스트하세요. 복원된 데이터베이스만으로는 정상으로 보일 수 있지만 자격 증명은 읽을 수 없는 상태일 수 있습니다.
- 키를 공개 디렉터리와 저장소 외부에 보관하세요
- 데이터베이스 일관성 있게 백업
- 의도한 프로덕션 배포에 지원되는 PostgreSQL 사용
공식 문서: n8n 암호화 키 구성
웹훅에 공개 주소를 부여하세요
Caddy와 같은 역방향 프록시는 HTTPS을 종료하고 n8n은 내부에서 수신 대기할 수 있습니다. 현재 문서에서는 외부 웹훅 오리진에 N8N_WEBHOOK_URL을 사용하며, 버전 2.35.0부터 이전 WEBHOOK_URL 이름을 대체합니다. 신뢰할 수 있는 프록시 홉 수를 실제 경로에 맞게 설정하세요. 단일 프록시는 N8N_PROXY_HOPS=1를 사용합니다. 전달된 호스트, 프로토콜 및 클라이언트 정보를 보존하세요. 서버 외부에서 웹훅을 테스트하고 프로덕션 URL을 확인하세요.
- 워크플로 시간대를 의도적으로 설정
- 민감한 입력이 포함된 실행 기록 정리
- 필요한 비공개 액세스 제어가 있는 경우에만 큐 워커와 Redis를 사용하세요
# Example: one HTTPS reverse proxy
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1공식 문서: 리버스 프록시 뒤의 n8n
워크로드 및 허용된 통합 정의
트리거, 외부 계정, 예상 실행량, 각 워크플로가 생성할 수 있는 최대 지출 또는 부작용을 나열하세요. 실제 사용에 대한 n8n 라이선스를 확인하세요. 특히 다른 사람에게 서비스로 제공하는 경우 더욱 그렇습니다. 소규모 예약 워크플로와 공개 웹훅 프로세서는 리소스 요구 사항이 다릅니다. 지원되는 릴리스, 비공개 영구 상태, TLS 이름 및 배포에 적합한 데이터베이스로 시작하세요. 편집기로 데이터베이스 포트를 노출하지 마세요.
- 각 통합에 별도의 제한된 자격 증명을 사용하세요.
- 의도한 워크플로 시간대와 실행 기록 보존 기간을 설정하세요.
- 내보낸 워크플로에 실제 비밀 정보가 포함되지 않도록 유지하세요.
공식 문서: n8n Docker 배포
설치된 릴리스의 공개 웹훅 오리진 설정
Caddy와 같은 역방향 프록시는 내부적으로 n8n에 도달하는 반면, 외부 서비스는 해당 HTTPS 웹훅 오리진을 호출합니다. 설치된 릴리스에 대해 문서화된 웹훅 URL 변수를 사용하세요. 현재 문서에서는 N8N_WEBHOOK_URL로 명명되며, 이전 릴리스에서는 WEBHOOK_URL을 사용했습니다. 임의의 전달 헤더를 신뢰하지 말고 실제 프록시 홉 수를 설정하세요. 편집기 액세스 정책을 웹훅 인증과 분리하고, 프로덕션 콜백에 내부 호스트나 포트가 포함되지 않는지 확인하세요.
# Example values for a supported current release, behind one proxy:
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1공식 문서: n8n 웹훅 리버스 프록시 설정
쓰기 권한을 부여하기 전에 무해한 워크플로를 테스트하세요
읽기 전용 요청이나 일회용 테스트 레코드로 시작하세요. VPS 외부에서 프로덕션 웹훅을 테스트하고, 인증 거부와 의도적 재시도를 확인하세요. 반복 요청이 실수로 두 번째 중대한 작업을 생성해서는 안 됩니다. 실행 로그에서 유출된 입력을 확인한 후 보존 정책을 적용하세요. 웹훅이 편집기의 테스트 모드에서만 작동한다면 워크플로가 게시/활성 상태인지, 프로덕션 및 테스트 경로가 올바른 프로세스에 도달하는지 점검하세요.
- 일회용 통합 자격 증명으로 복원을 테스트하세요.
- N8N_ENCRYPTION_KEY 또는 생성된 키 상태의 독립적인 암호화 사본을 보관하세요.
- 샘플 비밀번호나 API 토큰을 보관되는 디버깅 출력으로 보내지 마세요.
공식 문서: n8n 암호화 키
실행 병목을 확인한 후에만 확장하세요
대기열 모드는 Redis, 워커 및 공유 데이터베이스를 추가합니다. 메인 프로세스는 트리거를 수신하고 워커는 실행을 수행합니다. 모든 워커는 동일한 자격 증명 암호화 키를 사용해야 합니다. 파일이 포함된 워크플로를 대기열 모드로 이동하기 전에 현재 바이너리 데이터 스토리지 요구 사항을 따르세요. 동시성 및 업스트림 API 예산을 제한하고, 대기열 대기 시간과 실패를 모니터링하세요. 데이터베이스, 상태 및 키를 함께 백업하세요. 컨테이너 재시작은 읽을 수 없는 저장된 자격 증명에 대한 복구 계획이 아닙니다.
공식 문서: n8n 대기열 모드 · 실행 정리 설정