환경 변수로 인스턴스 설정 관리

환경 변수를 사용하여 셀프 호스팅 n8n 인스턴스의 소유자, SSO, 보안 정책, 로그 스트리밍, MCP, 커뮤니티 패키지를 설정하는 방법을 설명합니다.

UI를 통해 설정하는 대신, 환경 변수를 통해 인스턴스 설정의 일부를 관리할 수 있습니다. 이는 내부 배포 파이프라인 등을 통해 n8n 인스턴스를 자동으로 프로비저닝할 때 유용합니다. 지원되는 각 영역에는 _MANAGED_BY_ENV 라는 전용 환경 변수가 있습니다. 해당 영역의 환경 변수 관리를 활성화하려면 이 변수를 true 로 설정하세요. 그러면 n8n은 관련 환경 변수를 적용하고 일치하는 UI 컨트롤을 잠급니다. 작동 방식 # _MANAGED_BY_ENV 를 true 로 설정하면: n8n은 매번 시작할 때마다 환경 변수의 설정을 재적용합니다. 일치하는 UI 컨트롤이 읽기 전용 이 됩니다. _MANAGED_BY_ENV 가 false (기본값)이면, n8n은 관련 환경 변수를 설정했더라도 무시합니다. `*_MANAGED_BY_ENV`를 끄면 값은 유지됩니다 *_MANAGED_BY_ENV 를 다시 false 로 설정하면 UI 쓰기 접근이 복원되지만, 마지막으로 적용된 값은 유지됩니다. 변경하려면 이후 UI에서 직접 수정하세요. 예상치 못한 읽기 전용 UI 컨트롤 설정이 읽기 전용으로 표시되는데 그 이유를 알 수 없다면, 환경에서 일치하는 *_MANAGED_BY_ENV 변수가 true 로 설정되어 있는지 확인하세요. 지원되는 영역과 활성화 변수: 인스턴스 소유자: N8N_INSTANCE_OWNER_MANAGED_BY_ENV SSO: N8N_SSO_MANAGED_BY_ENV 보안 정책: N8N_SECURITY_POLICY_MANAGED_BY_ENV 로그 스트리밍: N8N_LOG_STREAMING_MANAGED_BY_ENV MCP: N8N_MCP_MANAGED_BY_ENV 커뮤니티 패키지: N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV `_MANAGED_BY_ENV`를 설정하여 그룹을 활성화하세요 해당 영역의 다른 환경 변수는 _MANAGED_BY_ENV 가 true 가 아니면 아무런 효과가 없습니다. 그룹을 활성화하려면 true 로 설정하세요. 인스턴스 소유자 # n8n v2.17.0부터 사용 가능 앱 내 설정 과정 대신 환경 변수를 통해 인스턴스 소유자 를 사전 프로비저닝합니다. 설정 후 소유자 이메일을 변경하려면 셀프 호스팅 n8n의 인스턴스 소유자 이메일 변경 을 참조하세요. `N8N_INSTANCE_OWNER_PASSWORD_HASH`는 bcrypt 해시여야 합니다 이 변수는 사전 해시된 bcrypt 값을 기대합니다. 평문 비밀번호를 설정하면 로그인이 중단됩니다. Note 이 섹션의 내용은 원문 문서 를 참조하세요. ( instance-owner.md ) SSO # n8n v2.18.0부터 사용 가능 기능 가용성 싱글 사인온은 Business 및 Enterprise 플랜에서 사용할 수 있습니다. 환경 변수를 통해 싱글 사인온 을 설정합니다. 활성화 및 공통 설정 # Note 이 섹션의 내용은 원문 문서 를 참조하세요. ( sso-activation.md ) OIDC # Note 이 섹션의 내용은 원문 문서 를