En önemli ortam değişkenleri açıklandı (N8N_HOST, WEBHOOK_URL, GENERIC_TIMEZONE ...)

Bir n8n örneğini kendi başına barındıran kişi, erişilebilirlik, saat dilimi, veritabanı ve güvenlik gibi merkezi ayarları arayüz üzerinden değil, konteynerin veya sürecin başlatılması sırasında ayarlanan ortam değişkenleri üzerinden yapılandırır. Belgelenmiş yüzden fazla değişkenden çoğu Alman self-hosting kurulumu için gerçekten belirleyici olan sadece bir avuç kadardır, örneğin ana bilgisayar adı için N8N_HOST, bir reverse proxy arkasından herkese açık erişim için WEBHOOK_URL veya zamanlanmış workflow'ların doğru saatte tetiklenmesi için GENERIC_TIMEZONE. Bu makale pratikte en önemli değişkenleri konu alanına göre sıralar ve her biri için bir kullanım örneği gösterir. Güncelleme: Temmuz 2026.

Temel yapılandırma: erişilebilirlik, URL ve saat dilimi

Bu değişkenler, n8n'in içeride ve dışarıda nasıl erişilebilir olduğunu ve zamanlanmış workflow'ların hangi saat diliminde çalıştığını belirler.

• N8N_HOST: n8n'in içeride hangi ana bilgisayar adı altında erişilebilir olduğunu belirler, varsayılan değer localhost'tur, kendi alan adına sahip bir sunucu için örneğin n8n.sirketiniz.de.
• N8N_PORT: n8n sürecinin dinlediği port, varsayılan değer 5678, aynı sunucuda birden fazla hizmet paralel çalıştığında önemlidir.
• N8N_PROTOCOL: n8n'e içeride http veya https üzerinden mi erişildiğini belirler, varsayılan http'dir, TLS'i sonlandıran bir reverse proxy arkasında içeride genellikle http kalır.
• N8N_EDITOR_BASE_URL: Kullanıcıların editöre eriştiği herkese açık URL, ayrıca e-posta bağlantıları ve SAML yönlendirmeleri için de kullanılır, örnek https://n8n.sirketiniz.de.
• WEBHOOK_URL: n8n bir reverse proxy arkasında çalıştığında, gelen webhook'ların doğru herkese açık adresi kullanması için manuel olarak ayarlanır, örnek https://n8n.sirketiniz.de/.
• GENERIC_TIMEZONE: n8n örneğinin saat dilimi, varsayılan değer America/New_York, Alman kurulumları için buraya pratik olarak neredeyse her zaman Europe/Berlin girilmelidir, aksi takdirde cron ve schedule tetikleyicileri yanlış saatte tetiklenir.

Güvenlik ve veri koruma

Özellikle Alman veri egemenliğinin ve kendi verileri üzerindeki kontrolün önemli olduğu şirketler için güvenlikle ilgili değişkenlere yakından bakmakta fayda vardır.

• N8N_ENCRYPTION_KEY: n8n'in veritabanındaki kimlik bilgilerini şifrelediği anahtar, belirtilmezse rastgele oluşturulur, üretim kurulumlarında sabit olarak ayarlanmalı ve güvenli şekilde saklanmalıdır, aksi takdirde kayıtlı kimlik bilgileri yeniden oluşturmadan sonra artık şifresi çözülemez.
• N8N_SECURE_COOKIE: Çerezlerin yalnızca HTTPS üzerinden iletilmesini sağlar, varsayılan değer true'dur, yalnızca TLS olmadan salt HTTP test işletiminde false olarak ayarlanmalıdır.
• N8N_BLOCK_ENV_ACCESS_IN_NODE: Kullanıcıların expression'lar veya Code node'u üzerinden sunucunun ortam değişkenlerine erişmesini engeller, varsayılan değer false'tur, hassas kimlik bilgilerine sahip çok kullanıcılı örnekler için true önerilir.
• N8N_DIAGNOSTICS_ENABLED: n8n'in üreticiye anonimleştirilmiş telemetri verisi gönderip göndermediğini kontrol eder, varsayılan değer true'dur, azami veri egemenliği isteyenler burayı false yapar.

Veritabanı ve işletim

Üretim işletimi için çoğu kurulum, birlikte gelen SQLite veritabanından PostgreSQL'e geçer, bu da kendi değişkenleri üzerinden yapılandırılır.

• DB_TYPE: Kullanılan veritabanını belirler, varsayılan değer sqlite'tır, birden fazla eşzamanlı kullanıcıya sahip üretim ortamları için yaygın değer postgresdb'dir.
• DB_POSTGRESDB_HOST: PostgreSQL sunucusunun ana bilgisayar adı, varsayılan değer localhost'tur, ayrı bir veritabanı için örneğin veritabanı konteynerinin dahili ana bilgisayar adı.
• DB_POSTGRESDB_DATABASE: PostgreSQL veritabanının adı, varsayılan değer n8n'dir, aynı sunucuda birden fazla örnek için uyarlanabilir.
• DB_POSTGRESDB_USER / DB_POSTGRESDB_PASSWORD: PostgreSQL bağlantısı için kimlik bilgileri, parola için varsayılan değer yoktur, her veritabanı parolası gibi depoda düz metin olarak yer almamalı, bir secret üzerinden yönetilmelidir.
• N8N_PROXY_HOPS: n8n'in kaç reverse proxy arkasında çalıştığını belirtir, varsayılan değer 0'dır, önünde tek bir Nginx veya Traefik varsa tipik olarak 1, böylece n8n gerçek istemci IP'sini doğru belirler.

n8n self-hosting'de yaşanan sorunların çoğu eksik değişkenlerden değil, yanlış ayarlanmış URL'lerden veya sunucu konumuyla eşleşmeyen bir saat diliminden kaynaklanır. Kendi n8n örneğini kurmak, güvenli hale getirmek veya Postgres'e taşımak isteyenler, NordFlux'un n8n hizmetleri kapsamında kurulum ve yapılandırma desteği bulur.

n8n ortam değişkenleri hakkında sıkça sorulan sorular

n8n'de ortam değişkenlerini nerede ayarlarım?

Bu, kurulum türüne bağlıdır. Docker'da bu, -e bayrakları veya docker-compose.yml içindeki bir .env dosyası üzerinden yapılır, klasik bir kurulumda ise n8n sürecinin başlatılmasından önce ayarlanan sistem ortam değişkenleri olarak yapılır.

N8N_ENCRYPTION_KEY'i ayarlamazsam ne olur?

Bu durumda n8n ilk başlatmada otomatik olarak rastgele bir anahtar oluşturur. Bu kaybolursa, örneğin kalıcı depolama olmadan bir konteyner yeniden oluşturmada, zaten kayıtlı olan kimlik bilgilerinin şifresi artık çözülemez.

WEBHOOK_URL'i her zaman ayarlamam gerekir mi?

Yalnızca n8n bir reverse proxy arkasında veya içeride yapılandırılandan farklı bir herkese açık adres altında çalışıyorsa. N8N_HOST ve N8N_PORT üzerinden doğrudan erişimde, değişken genellikle gerekli değildir.

Ortam değişkenlerini sonradan değiştirebilir miyim?

Evet, çoğu değişken yalnızca n8n sürecinin yeniden başlatılmasından sonra etkili olur. Devam eden workflow'lar ve zaten kayıtlı veriler, veritabanı bağlantısı değişmediği sürece bundan etkilenmez.

Belgelenen tüm değişkenlerle ilgili daha fazla ayrıntı n8n'in ortam değişkenleri belgelerinde ve özellikle veritabanı yapılandırmasında bulunabilir.