Ubuntu için N8N Otomasyon Eğitimi – Sıfırdan Akışa

Anahtar Kelimeler

Neden otomasyon önemlidir

Modern ekipler “bir uygulama çalıştırmaz” — bir dizi SaaS aracı, iç hizmetler, veri depoları ve sohbet/uyarı sistemleri işletirler. Bu karmaşıklığın maliyeti öngörülebilir şekillerde ortaya çıkar:

• Manuel geçişler ve tekrar eden boş işler (sistemler arasında kopyala/yapıştır)
• Yavaş yanıt döngüleri (onaylar, bilet yönlendirmeleri, olay bildirimleri)
• Tutarsız sonuçlar (insan hatası, atlanan adımlar, kısmi güncellemeler)
• Kırılgan entegrasyonlar (görünürlük veya sahiplik olmadan tek seferlik betikler)

Otomasyon, bu sürtüşmeyi azaltmanın en yüksek etkili yollarından biridir. Küçük iş akışları bile — veri senkronizasyonu, yük doğrulama, bildirim gönderme, kayıt güncelleme — anlamlı kazanımlara dönüşebilir: daha hızlı döngü süresi, daha az hata ve daha tutarlı operasyonlar. Önemli olarak, “otomasyon” yalnızca çabayı azaltmakla ilgili değildir; aynı zamanda işlemleri gözlemlenebilir ve tekrarlanabilir hale getirmekle de ilgilidir.

Bu rapor, otomasyonu üretim altyapısı gibi ele alır: temiz bir şekilde dağıtın, yapılandırmayı kontrol edin, verileri kalıcı tutun ve davranışı belirleyici bir test iş akışı ile doğrulayın.

N8N nedir (ve neden en iyi arkadaşınız olabilir)

N8N, düğüm tabanlı bir editör kullanarak hizmetleri bağlamanızı sağlayan bir iş akışı otomasyon platformudur. İş akışlarını “düğümlerden” (tetikleyiciler, veri dönüşümleri, API çağrıları, veritabanı işlemleri, bildirimler) oluşturursunuz, ardından bunları manuel olarak, bir takvimde veya webhook’lar aracılığıyla çalıştırırsınız.

N8N’i özellikle bir Linux dağıtım bağlamında kullanışlı kılan unsurlar:

• Kendi barındırılabilir: veriler ve ağ üzerinde kontrol sağlamak için kendi altyapınızda çalıştırabilirsiniz.
• Genişletilebilir entegrasyonlar: birçok yerleşik düğüm ve API’si olan her şey için genel HTTP düğümleri.
• Operasyonel olarak dost: konteynerlerde iyi çalışır, kalıcılık için Postgres kullanabilir ve ortam odaklı yapılandırmayı destekler.
• Artımlı benimseme için iyi: basit iş akışlarıyla başlayın, ardından erişimi güçlendirin (ters proxy + HTTPS) ve kullanım arttıkça operasyonel uygulamaları geliştirin.

Bu değerlendirmede, N8N, gerçekten çalıştırabileceğiniz bir hizmet gibi ele alınır: dağıtım seçimleri ve yapılandırma, netlik, yeniden üretilebilirlik ve “gelecek güçlendirme” (ilk kurulumu aşırı mühendislik yapmadan) yönünde belgelenmiştir.

Kendi N8N örneğinizi barındırın

Denemeye hazır mısınız? Kurulum birkaç teknik adım gerektirir, ancak endişelenmeyin — bu kılavuzu takip edin ve ilk N8N örneğinizi kısa sürede çalışır hale getirin.

Bu öğretici, AlexHost tarafından sağlanan bir VPS üzerinde çalışan Ubuntu 22.04’ü kullanmaktadır.

Docker kurulumu

N8N’i kurmanın birkaç yolu vardır. Bu öğretici için, N8N’i yönetmek ve yapılandırmak için net ve güvenilir bir yaklaşım sağladığı için Docker kullanıyoruz.

Öncelikle, sisteminizde docker ve docker compose’un kurulu olduğundan emin olun.

# Check for docker
docker -v

# Check for docker compose
docker compose

Eğer bu bir sürüm döndürüyorsa, her şey hazır demektir.

Eğer kurulu değilse, lütfen bu sayfayı takip ederek talimatları izleyin: kurulum kılavuzu. Kullandığınız işletim sistemini doğru seçtiğinizden emin olun.

Proje yapısı

Dosyaları düzgün bir şekilde organize etmek, netlik ve uzun vadeli sürdürülebilirlik için esastır. Geleneksel olarak, Docker hizmetleri genellikle /opt dizini altında yer alır. Bunun içinde, N8N dahil tüm hizmetleri depolamak için bir docker_services klasörü oluşturulmuştur.

# Create all the needed folders
sudo mkdir -p /opt/docker_services/n8n

# Navigate to n8n folder
cd /opt/docker_services/n8n

Docker compose dosyasını ekleme

N8N örneğimizi ve arka uç veritabanını başlatmak için bir compose.yaml dosyası kullanacağız. Yapılandırma ve yürütme günlükleri için çok daha sağlam ve üretime hazır bir veri deposu sağladığı için varsayılan SQLite yerine PostgreSQL’i seçiyoruz.

Dosyayı nano gibi bir metin düzenleyici kullanarak oluşturun:

nano compose.yaml

Aşağıdaki yapılandırmayı dosyaya yapıştırın:

services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    env_file:
      - .env
    volumes:
      - ./data:/home/node/.n8n
      - ./files:/files
    depends_on:
      - postgres

  postgres:
    image: postgres:15
    restart: always
    env_file:
      - .env
    volumes:
      - ./postgres-data:/var/lib/postgresql/data

Yapılandırmayı anlama:

Konteynerleri başlatmadan önce, haritalanmak üzere gerekli dizinleri açıkça oluşturmanız gerekir:

# Use your own path if different
cd /opt/docker_services/n8n

mkdir data files postgres-data

Dizin sahipliği ve izinleri

Varsayılan olarak, Docker hacimleriniz için otomatik olarak ana bilgisayar dizinleri oluşturduğunda (örneğin, data ve files klasörlerimiz), sahipliği root kullanıcısına atar. Ancak, güvenlik nedenleriyle, n8n konteyneri kasıtlı olarak ayrıcalıkları bırakır ve bir kök olmayan kullanıcı olarak çalışır (özellikle, UID 1000).

Eğer bu klasörler root tarafından sahiplenilirse, n8n yapılandırmasını veya veritabanı dosyalarını kaydedemez, bu da konteynerin başlangıçta ‘izin reddedildi’ hatası ile çökmesine neden olur. Bu sürtüşmeyi önlemek için, hizmeti başlatmadan önce bu dizinlerin sahipliğini doğru kullanıcıya açıkça veriyoruz.

# Set ownership of the volume directories to UID/GID 1000
sudo chown -R 1000:1000 data files

.env dosyasını ekleme

Docker, sistem yapılandırmalarını ve gizli bilgileri konteynerlerimize geçirebilmek için .env dosyasını kullanır, böylece bunları compose.yaml dosyamıza sabit kodlamadan geçirebiliriz.

Aynı dizinde dosyayı oluşturun:

nano .env

Aşağıdaki yapılandırmayı yapıştırın (lütfen example.com ve veritabanı şifresini kendi güvenli değerlerinizle değiştirin):

# n8n Settings
DOMAIN_NAME=example.com
SUBDOMAIN=n8n
GENERIC_TIMEZONE=Europe/Chisinau
N8N_HOST=n8n.example.com
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.example.com/
N8N_SECURE_COOKIE=false
NODE_ENV=production


# PostgreSQL
POSTGRES_DB=n8n
POSTGRES_USER=n8n
POSTGRES_PASSWORD=changeme123

Ortam değişkenlerini anlama:

Dosyayı kaydedin ve kapatın. Artık Docker Compose yığınınızı çalıştırmak için gerekli tüm yapılandırmayı ayarladınız.

Docker hizmetlerini başlatma

Proje dizininize gidin ve tüm hizmetleri arka planda başlatın.

# Use your own path if different
cd /opt/docker_services/n8n

docker compose up -d

Docker gerekli görüntüleri çeker ve konteynerlerinizi başlatır. Çalışmaya başladıktan sonra, n8n varsayılan olarak 5678 portunda veya bir ters proxy kullanıyorsanız yapılandırdığınız alan adında erişilebilir olacaktır.

Doğru çalıştığını doğrulamak için n8n ve postgres konteynerlerinin listelendiğini ve çalıştığını kontrol edin.

docker ps

N8N ile çalışma

Hizmetler başarıyla çalışmaya başladıktan sonra, N8N’i keşfetmeye başlamak için heyecan verici bir zaman!

N8N’e erişim

N8N, bir web tarayıcısı aracılığıyla erişilebilir. Bu yerel kurulumda, aşağıdaki URL’de mevcuttur: http://localhost:5678.

İlk erişimde, doldurulması gereken yaygın alanlarla bir giriş sayfası görünür.

Lisans anahtarını ayarlama

Başlangıçta, N8N, ücretli özellikleri açan ücretsiz bir lisans anahtarı sunan bir pencere gösterir. Evet, doğru duydunuz: ücretli özellikler ücretsiz! Bu, kendi kendine barındırılan bir N8N örneği çalıştırmanın avantajlarından biridir.

Lisans anahtarını e-posta ile aldıktan sonra, Ayarlar->Kullanım ve Plan bölümüne giderek etkinleştirebilirsiniz.

İlk iş akışını oluşturma

Yeni iş akışları doğrudan ana sayfadan oluşturulabilir. Aşağıdaki görüntüye bakın.

İlk yürütme kullanım durumu için iki düğüm kullanılacaktır:

• Manuel Tetikleyici: iş akışını manuel olarak başlatır.
• Set Düğümü: alanları ve değerlerini tanımlar ve bunlarla çalışır.

Manuel Tetikleyici düğümünün yapılandırmaya ihtiyacı yoktur, ancak Set düğümünün vardır. Bizim durumumuzda, amacımız ‘n8n çalışıyor’ mesajını ve olayın zaman damgasını çıkarmaktır. Bu nedenle Set düğümü aşağıdaki görüntüde gösterildiği gibi yapılandırılmıştır.

İki düğüm bağlandığında ve yapılandırıldığında, iş akışını İş akışını çalıştır butonuna basarak başlatıyoruz.

Tebrikler 👏, ilk N8N iş akışınız başarıyla yürütüldü!

Sonraki adım nedir?

Bu başlangıç kurulumu sadece bir başlangıçtır. N8N’in gerçek gücü, günlük araçlarınızı bağlayarak tekrarlayan görevleri otomatikleştirmeye ve sürtüşmeyi azaltmaya başladığınızda açığa çıkar. Örneğin, web sitenizden yeni potansiyel müşterileri otomatik olarak bir CRM’ye senkronize etmek, acil uyarıları ve kritik hizmet hatalarını bir ekip sohbetine yönlendirmek veya çeşitli SaaS platformlarından verileri periyodik olarak veritabanınıza yedeklemek için iş akışları oluşturabilirsiniz. Operasyonlarınızı otomatikleştirme ve günlük iş yükünüzü basitleştirme olasılıkları neredeyse sonsuzdur.

Sonuç

Bu kılavuzu tamamlayarak, günlük operasyonlarınızı yönetme şeklinizi dönüştürebilecek güçlü, kendi kendine barındırılan bir platformu başarıyla dağıtmış oldunuz. Bu kurulumu takip ettiğiniz için teşekkür ederiz! N8N’in neler yapabileceğini keşfetmeye devam ederken, daha fazla harika ve kullanışlı araç keşfetmek için diğer öğreticilerimizi kontrol etmeyi unutmayın. Ölçeklenmeye veya yeni, heyecan verici projelere dalmaya hazır olduğunuzda, AlexHost‘ın hizmetlerinizi güvenilir bir şekilde barındırmak için ihtiyaç duyduğunuz tüm sağlam altyapıyı sağladığını unutmayın.