n8n kendi sunucunuzda nasıl barındırılır ve CometAPI Node yerel olarak nasıl çalıştırılır

Yapay zeka hızla ilerliyor: yeni çoklu-modellik modelleri ve geliştirilmiş gerçek zamanlı API’ler, güçlü yapay zekayı otomasyon platformlarına gömmeyi kolaylaştırırken, güvenlik ve gözlemlenebilirlik etrafındaki paralel tartışmalar ekiplerin üretim sistemlerini nasıl yönettiğini yeniden şekillendiriyor. Yerel otomasyonlar kuranlar için pratik bir desen ortaya çıkıyor: pek çok modele erişmek için birleşik bir model geçidi (örneğin CometAPI) kullanın ve bu model çağrılarını kendi barındırdığınız bir otomasyon çalıştırıcısına (örneğin n8n) dikin; böylece veri, gecikme ve maliyetler üzerinde kontrol sizde kalsın. Bu rehber, adım adım, CometAPI + n8n (yerel) ile nasıl başlayacağınızı, nelere dikkat etmeniz gerektiğini ve işler raydan çıktığında nasıl sorun gidereceğinizi gösterir.

n8n nedir ve yapay zeka otomasyonu için neden önemlidir?

n8n, görsel bir düzenleyici ve geniş bir düğüm (bağlayıcı) ekosistemine sahip açık kaynaklı bir iş akışı otomasyon aracıdır. Tetikleyicileri, dönüşümleri ve harici API çağrılarını tekrarlanabilir iş akışlarına (webhook’lar, zamanlanmış işler, dosya işleme, sohbet botları vb.) zincirlemenizi sağlar. n8n’i yerelde kendiniz barındırmak, özellikle hassas girdileri işleyen üçüncü taraf yapay zeka modellerini çağırırken, veri yerleşimi ve yürütme üzerinde tam kontrol sunar.

n8n pratikte nasıl çalışır?

Tetikleyiciler (Webhook, Cron) ve eylem düğümleri (HTTP Request, veritabanı düğümleri, e-posta) ile görsel tuval.
Topluluk düğümleri yetenekleri genişletir — topluluk paketlerini kurabilir ve bunları yerel düğümler gibi kullanabilirsiniz.

n8n’i kendiniz barındırmanın sundukları:

Tam veri kontrolü — iş akışları ve çalışma verisi, yönettiğiniz altyapıda kalır.
Özelleştirme — bulut özelliklerini beklemeden özel düğümler veya yerel entegrasyonlar ekleyin.
Maliyet öngörülebilirliği — yoğun iç otomasyonlarda görev başına bulut faturalandırma sürprizleri yok.
Güvenlik ve uyumluluk — dahili politika ve düzenleyici gereksinimleri karşılamak daha kolay.

CometAPI nedir ve neden model geçidi olarak kullanılmalı?

CometAPI, yüzlerce üçüncü taraf yapay zeka modelini (metin, embedding’ler, görüntü üretimi vb.) tek bir, OpenAI ile uyumlu arayüz ve faturalandırma modeli arkasında sunan birleşik bir API geçididir. Bu da denemek istediğiniz her LLM veya görüntü motoru için özel entegrasyonlar eklemek yerine tek bir API’yi çağırıp istekte kullanmak istediğiniz modeli seçebileceğiniz anlamına gelir. Bu yaklaşım denemeyi, maliyet kontrolünü ve operasyonel entegrasyonu basitleştirir.

Avantajlar:

Model seçimi: Aynı kod yoluyla pek çok sağlayıcı/modeli deneyin.
Token havuzu / ücretsiz kotalar: Birçok birleşik geçit, denemeler için kredi/katmanlar sunar.
Daha basit altyapı: Yönetilecek tek bir kimlik doğrulama sistemi ve tek bir temel URL.

CometAPI erişimi ve anahtarlarını nasıl edinirim?

CometAPI sitesinde (veya satıcı kontrol panelinde) kayıt olun. Çoğu geçit, test için ücretsiz bir katman sunar.
CometAPI panonuzdan bir API anahtarı alın — uzun, gizli bir dize. Belgelerde nereye yerleştirmeniz gerektiği belirtilir (CometAPI, https://api.cometapi.com/v1). adresine karşı Bearer yetkilendirmesi kullanır).
Kullanmayı planladığınız uç noktanın (sohbet tamamlamaları, görüntüler, embedding’ler) API belgelerini okuyun. CometAPI, /v1/chat/completions ve /v1/images/generations gibi uç noktaları belgelendirir.

n8n kendi sunucunuzda nasıl barındırılır ve CometAPI Node yerel olarak nasıl çalıştırılır

n8n ile CometAPI arasındaki bağlama (entegrasyon) neden önemlidir?

Burada “bağlama”, otomasyon çalıştırıcınız (n8n) ile model geçidiniz arasındaki güvenilir, güvenli entegrasyon yolunu ifade eder. Doğru bağlama önemlidir çünkü:

Çağrılar arasında bağlamı korur (konuşma geçmişi, embedding’ler).
Kimlik bilgilerini ve sırları tek yerde merkezileştirerek döndürmeyi güvenli kılar.
Öngörülebilir uç noktalar ve standart istek formatlarıyla gecikmeyi ve hata yüzeyini azaltır.
Gözlemlenebilirlik ve sorun gidermeyi mümkün kılar — hangi model, istem ve yanıtın sonuca yol açtığını bilirsiniz.

Kısacası: iyi bağlama, operasyonel riski düşürür ve iterasyonu hızlandırır.

n8n’i yerelde nasıl dağıtırım (hızlı pratik rehber)?

n8n’i yerelde npm veya Docker ile çalıştırabilirsiniz; çoğu self-host senaryosu için Docker Compose önerilir (yeniden üretilebilir ve bağımlılıkları izole eder). Aşağıda minimal bir Docker Compose örneği ve temel notlar yer alıyor.

n8n’i Docker ile nasıl kendim barındırırım?

Docker (ve Docker Compose), n8n’i üretimde çalıştırmanın en sağlam ve tekrarlanabilir yoludur. Uygulamayı izole eder, yükseltmeleri basitleştirir ve ters proxy’ler ile düzenleyiciler (Docker Swarm, Kubernetes) ile iyi eşleşir. n8n’in resmi belgeleri, burada takip edip uyarlayacağım bir Docker Compose referansı içerir.

Üretimde tipik olarak şu yığın çalışır:

n8n servisi (resmi imaj: docker.n8n.io/n8nio/n8n veya etikete bağlı olarak n8nio/n8n).
PostgreSQL (veya desteklenen başka bir veritabanı).
Redis (kuyruk modunu kullanacaksanız).
TLS, host yönlendirme ve hız sınırlama kuralları için bir ters proxy (Traefik, Caddy veya nginx).

Bu mimari, endişeleri temiz şekilde ayırır (VT kalıcılığı, kuyruklama, web proxy’si) ve ölçeklemeyi ve yedeklemeleri düz hale getirir. Resmi n8n belgeleri, Docker Compose kalıpları ve ortam değişkeni referansları sağlar.

This is step-by-step guide:

Klasör oluşturun ve n8n servisini içeren bir docker-compose.yml ekleyin. Aşağıda tipik üretim ihtiyaçlarını karşılayan pratik bir docker-compose örneği var: harici Postgres, Redis (kuyruk/çalıştırmalar modu), kalıcı volume’ler ve TLS’yi yöneten bir Nginx ters proxy’si:

```yaml
version: "3.8"
services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=supersecretpassword
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=anothersecret
      - WEBHOOK_TUNNEL_URL=https://n8n.example.com
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: n8n
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: supersecretpassword
    volumes:
      - pgdata:/var/lib/postgresql/data

  redis:
    image: redis:7
    volumes:
      - redisdata:/data

volumes:
  n8n_data:
  pgdata:
  redisdata:
```

Başlatın:

docker compose up -d

http://localhost:5678 adresini ziyaret edin ve yönetici kullanıcınızı oluşturun. Üretim için Postgres, SSL ve uygun ortam değişkenlerini istersiniz — resmi Docker Compose belgelere bakın.

Notlar ve sıkılaştırma:

Gizli bilgileri düz metin olarak docker-compose.yml içinde saklamayın; üretimde ortam dosyaları, Docker secrets veya harici gizli bilgi yöneticileri kullanın.
WEBHOOK_URL değerini gerçek herkese açık URL’nizle değiştirin ve ters proxy’nizi n8n.example.com adresini n8n konteynerine yönlendirecek şekilde yapılandırın.
Sağlam arka plan işleme için EXECUTIONS_MODE=queue kullanın; kuyruk işçileri ve Redis gerektirir.

n8n’i npm / Node.js ile nasıl kendim barındırırım?

npm (veya pnpm) ile kurulum, n8n’i doğrudan ana makinede çalıştırır. Bu daha hafiftir (konteyner katmanı yoktur) ve tek kullanıcı, düşük karmaşıklıktaki kurulumlar veya geliştirici makineleri için yardımcı olabilir. Ancak bağımlılık yönetimi, izolasyon ve servis gözetimi için daha fazla sorumluluk gerektirir. Resmi n8n belgeleri bir npm kurulum rehberi ve çekinceler içerir.

Gerekli işletim sistemi paketleri ve Node sürümü:

Kararlı bir LTS Node.js kullanın (Node 18 veya Node 20+, n8n sürüm gereksinimleriyle eşleştirin).
build-essential, git ve bir süreç yöneticisi kurun (systemd önerilir).
Üretim için yine PostgreSQL ve Redis’i harici servisler olarak kullanın (Docker ile aynı gerekçeler).

n8n’i npm ile nasıl kurar ve çalıştırırım (adım adım)?

1.Install Node.js (önerilir: nvm)

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reload your shell (adjust to your shell startup file if needed)
source ~/.bashrc  # or ~/.zshrc

# Install and use the latest LTS (usually 18 or 20)
nvm install --lts
nvm use --lts

# Verify
node -v
npm -v

Daha sonra “n8n: command not found” görürseniz, terminali yeniden başlatın veya nvm tarafından yönetilen npm global bin yolunun PATH’inizde olduğundan emin olun.

2. n8n’i kurun ve başlatın (yerel)

npm install -g n8n
n8n -v  # verify version

3. Ön planda başlatın:

n8n start

Varsayılan URL: http://localhost:5678/ Port kullanımda ise:

export N8N_PORT=5679
n8n start

İsteğe bağlı: arka planda çalışır halde tutun (yine yerel):

npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status

4 .İlk erişim ve oturum açma:

Tarayıcınızda http://localhost:5678/ adresini açın.
İlk çalıştırmada, Sahip hesabını (e-posta + şifre) oluşturmak ve oturum açmak için sihirbazı izleyin.

n8n’de bir CometAPI topluluk düğümünü nasıl kurar veya yapılandırırım?

n8n, doğrulanmış topluluk düğümlerini (GUI ile kurulum) ve self-host yaptığınızda npm’den manuel kurulumu destekler. CometAPI’yi n8n’e entegre etmenin iki yolu vardır:

Seçenek A — CometAPI topluluk düğümünü kullanın (Düğümler panelinde mevcutsa)

n8n’de düğümler panelini açın (+ veya Tab tuşuna basın).
CometAPI doğrulanmış bir topluluk düğümüdür, “More from the community” altında görünür. Tıklayın ve kurun.
Kurulumdan sonra istenirse n8n’i yeniden başlatın. Settings → Credentials içinde yeni bir Credential oluşturun (düğüm bunu sağlıyorsa CometAPI credential türünü seçin) ve CometAPI jetonunuzu yapıştırın.

Seçenek B — Manuel kurulum (GUI kurulumu mevcut olmadığında)

1.SSH ile n8n ana makinenize/konteynerinize bağlanın.

2. Paketi global n8n node_modules içine veya özel klasörünüze kurun:

Go to Settings (bottom-left) > Community nodesClick “
Install a community node”
In “npm Package Name”, enter: @cometapi-dev/n8n-nodes-cometapiCheck the risk acknowledgment boxClick “
Install”After installation, you can search for “CometAPI” in the node panel.

3.n8n’i yeniden başlatın. Örneğiniz kuyruk modunda çalışıyorsa, belgelerde açıklanan manuel kurulum yolunu izlemelisiniz.

Düğümün kurulu olduğunu nasıl kontrol ederim

Yeniden başlatmadan sonra düğümler panelini açın ve “CometAPI” veya “Comet” arayın. Düğüm topluluk paketi olarak işaretlenmiş olacaktır.
Düğümü göremiyorsanız: örnek sahibi hesabını kullandığınızı (yalnızca örnek sahipleri kurulum yapabilir) veya düğüm paketinin konteyner/görüntü günlüklerinde hata olmadan kurulduğunu doğrulayın.

İş akışı nasıl oluşturulur ve API nasıl yapılandırılır

1. Yeni bir İş Akışı oluşturun

n8n örneğinize (self-hosted) giriş yapın.
Yeni bir otomasyon tuvali başlatmak için "Add Workflow" tıklayın.

2.Düğüm ekleyin

Bir tetikleyici düğümü ekleyin: “Manual Trigger” veya “When clicking ‘Execute workflow’” arayın.
Tuvalin sağ tarafındaki “+” düğmesini tıklayın ve “CometAPI” arayarak düğümü ekleyin.
Ayrıca sol düğüm listesinde “CometAPI” arayıp tuvale sürükleyebilirsiniz.

3.Kimlik bilgilerini yapılandırın (yalnızca ilk sefer):

CometAPI düğümünde, “Credential to connect with” altında “Create new” seçin.
CometAPI konsolunda oluşturduğunuz jetonu “CometAPI Key” alanına yapıştırın.
Kaydedin. Base URL varsayılan olarak https://api.cometapi.com olur ve genellikle değiştirilmesi gerekmez.

4. Model ve mesajları yapılandırın:

Model: desteklenen bir model girin, örn. gpt-4o veya gpt-4o-mini.

Mesajlar: Rol ve bağlamı doldurmanız gerekir; Rol için user veya system seçebilirsiniz.

İsteğe bağlı parametreler (gerektiğinde): Maksimum Token Sayısı (ör. 4096); Örnekleme Sıcaklığı (ör. 0.7); PenaltyStream (akış etkin/devre dışı). Belirli parametre dokümantasyonu ve açıklamaları için lütfen CometAPI belgelerine bakın.

5.Metin yürütme:

CometAPI düğümünü seçip “Execute step” tıklayın veya alttaki “Execute workflow” düğmesini tıklayın.
Sağdaki OUTPUT paneli bir JSON yanıtı (choices, usage vb. dahil) göstermelidir.

Artık Linux’ta npm ile n8n’i (önerilir) yerel olarak kurdunuz, CometAPI topluluk düğümünü yükleyip yapılandırdınız ve gpt-4o gibi modelleri çağıran ve yanıt alan iş akışlarını çalıştırabiliyorsunuz.

Yaygın sorunlar nelerdir ve nasıl sorun gideririm?

1) “401 Unauthorized” veya “Invalid API key”

CometAPI panonuzdaki jeton dizesini tam olarak doğrulayın (benzer adlara sahip jetonlar olabilir). Kopyala → n8n kimlik bilgisine yapıştır ve gerekirse düğümü yeniden başlat.
Authorization başlığı biçiminin Bearer sk-xxxxx olduğundan emin olun.

2) Topluluk düğümü kurulmuyor / “queue mode”

n8n’iniz kuyruk modunda çalışıyorsa, GUI kurulumu devre dışı olabilir; topluluk düğümlerini npm üzerinden yüklemek veya düğümü içeren özel bir imaj oluşturmak için manuel kurulum belgesini izleyin. Kurulumdan sonra n8n’i yeniden başlatın.

3) Kurulumdan sonra palette düğüm bulunamıyor

n8n’i yeniden başlatın.
Paketi doğru bağlamda kurduğunuzdan emin olun (konteyner imajı içinde veya bu düzeni kullanıyorsanız .n8n/custom yolunda).
Modül çözümleme hataları için konteyner günlüklerini kontrol edin.

4) Hız sınırlamaları veya kota sorunları

Kullanım ve kotayı CometAPI panosundan kontrol edin.
Sınır uyarıları veya HTTP 429’ları tespit ettiğinizde üstel geri çekilme uygulayın ve daha ucuz modellere geri dönüş yapın.

Topluluk düğümü mevcut değilse veya daha fazla esneklik isterseniz alternatifler var mı?

Evet — her zaman doğrudan HTTP Request düğümünü kullanabilirsiniz (tam kontrol) veya temel URL yönlendirmesiyle bir OpenAI düğümü kullanabilirsiniz (pratik kestirme). Ham HTTP kullanmak, yeni CometAPI uç noktalarını (örn. görüntü/video uç noktaları) yayınlandıkça benimsemeyi de kolaylaştırır.Lütfen bkz. Guide.

Ayrıca bkz. How to Use n8n with CometAPI

Sonuç:

CometAPI size model seçimi ve operasyonel sadelik sunar; n8n ise görsel orkestrasyon ve genişletilebilirlik sağlar. Hızlı sohbet/tamamlama entegrasyonu için OpenAI kimlik bilgisi kestirmesini, güvenilir olduklarında topluluk düğümlerini kullanın. Her iş akışını maliyet, gecikme ve güvenlik için izleyin ve ölçümleyin; önemli kararlar için insan geri dönüşlerini tercih edin; ve model seçiminizi dinamik tutarak yapay zeka sağlayıcı ekosistemindeki hızlı değişimlere uyum sağlayın. n8n ve CometAPI birleşimi güçlüdür, ancak tüm güçlü araçlar gibi korkuluklar ister — gözlemleyin, test edin ve yineleyin.