데이터베이스 환경 변수#
파일 기반 구성
각 변수에 _FILE을 추가하면 별도의 파일에서 해당 변수를 설정할 수 있습니다. 자세한 내용은 민감한 데이터를 별도 파일에 저장하기 문서를 참고하세요.
기본적으로 n8n은 SQLite를 사용합니다. n8n은 PostgreSQL도 지원합니다. n8n은 v1.0에서 MySQL 및 MariaDB 지원을 제거했습니다.
이 페이지는 자체 호스팅 n8n 인스턴스에 선택한 데이터베이스를 구성하기 위한 환경 변수를 설명합니다.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
DB_TYPE/ _FILE |
열거형 문자열:sqlite, postgresdb |
sqlite |
사용할 데이터베이스. |
DB_TABLE_PREFIX |
* | - | 테이블 이름에 사용할 접두사. |
PostgreSQL#
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
DB_POSTGRESDB_DATABASE/ _FILE |
문자열 | n8n |
PostgreSQL 데이터베이스의 이름. |
DB_POSTGRESDB_HOST/ _FILE |
문자열 | localhost |
PostgreSQL 호스트. |
DB_POSTGRESDB_PORT/ _FILE |
숫자 | 5432 |
PostgreSQL 포트. |
DB_POSTGRESDB_USER/ _FILE |
문자열 | postgres |
PostgreSQL 사용자. |
DB_POSTGRESDB_PASSWORD/ _FILE |
문자열 | - | PostgreSQL 비밀번호. |
DB_POSTGRESDB_POOL_SIZE/ _FILE |
숫자 | 2 |
n8n이 가져야 할 병렬 열린 Postgres 연결의 수를 제어합니다. 이 값을 증가시키면 자원 활용을 개선할 수 있지만, 너무 많은 연결은 성능 저하를 초래할 수 있습니다. |
DB_POSTGRESDB_CONNECTION_TIMEOUT/ _FILE |
숫자 | 20000 |
Postgres 연결 타임아웃 (ms). |
DB_POSTGRESDB_SCHEMA/ _FILE |
문자열 | public |
PostgreSQL 스키마. |
DB_POSTGRESDB_SSL_ENABLED/ _FILE |
불리언 | false |
SSL을 활성화할지 여부. DB_POSTGRESDB_SSL_CA, DB_POSTGRESDB_SSL_CERT 또는 DB_POSTGRESDB_SSL_KEY가 정의되면 자동으로 활성화됩니다. |
DB_POSTGRESDB_SSL_CA/ _FILE |
문자열 | - | PostgreSQL SSL 인증 기관. |
DB_POSTGRESDB_SSL_CERT/ _FILE |
문자열 | - | PostgreSQL SSL 인증서. |
DB_POSTGRESDB_SSL_KEY/ _FILE |
문자열 | - | PostgreSQL SSL 키. |
DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED/ _FILE |
불리언 | true |
n8n이 인증되지 않는 SSL 연결을 거부해야 하는지 여부 (true) 또는 하지 않아야 하는지 (false). |
SQLite#
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
DB_SQLITE_POOL_SIZE |
숫자 | 0 |
SQLite 파일을 WAL 모드 또는 롤백 저널 모드로 열지는 여부를 제어합니다. 0으로 설정하면 롤백 저널 모드를 사용합니다. 0보다 큰 경우, 병렬 SQL 읽기 연결 수를 구성하는 값으로 WAL 모드를 사용합니다. WAL 모드는 롤백 저널 모드보다 훨씬 더 성능이 뛰어나고 신뢰할 수 있습니다. |
DB_SQLITE_VACUUM_ON_STARTUP |
불리언 | false |
데이터베이스를 재구축하기 위해 시작 시 VACUUM 작업을 실행합니다. 파일 크기를 줄이고 인덱스를 최적화합니다. 이것은 오랜 시간 동안 차단되는 작업이며 시작 시간을 증가시킵니다. |