Kılavuzlar · n8n (kendi sunucunuzda)

formbase düğümünü n8n'e kurun

formbase için n8n, npm üzerinde n8n-nodes-formbase olarak yayımlanan bir topluluk düğümüdür. Bu kılavuz onu kendi sunucunuzda barındırılan bir n8n'e kurar ve formbase'in iş akışlarınıza ulaşmak için kullandığı adresi ayarlar.

Last checked September 28, 2026

Her n8n kılavuzu, Docker’da çalışan, kendi sunucusunda barındırılan n8n 2.40’ta, düğümün 0.10.1 sürümüyle kontrol edildi. n8n’in nerede çalıştığına bağlı olan her şey bu sayfadadır. Düğüm kurulduktan sonra diğer kılavuzlar aynı şekilde çalışır.

Başlamadan önce

n8n 2.30 veya üstü. formbase bağlantı bilgisi bunu gerektirir.
Bir formbase hesabı. Bu kılavuzlardaki her şey Free planında çalışır; e-posta davetleri, hatırlatmalar ve yarım bırakılan gönderimler hariç — bunlar Pro veya Business gerektirir.

Kendi sunucunuzda barındırılan n8n

Kendi sunucunuzda barındırılan bir n8n’in düğümü kurabilmesi için önce iki şeye ihtiyacı vardır:

Sahip hesabı veya bir yönetici hesabı. Topluluk düğümlerini yalnızca sahip ve yöneticiler kurabilir.
Bir ters proxy’den veya bir tünelden gelen herkese açık bir HTTPS adresi. formbase olayları ve istek geri çağırmalarını yalnızca herkese açık internetteki https:// URL’lerine gönderir. Yalnızca localhost üzerinden erişilebilen bir n8n bağlanabilir ama hiçbir şey almaz.

1. n8n’e herkese açık adresini bildirin

n8n, formbase’e verdiği URL’leri tarayıcınızdaki adresten değil kendi ayarlarından oluşturur. Şu ortam değişkenlerini n8n konteynerinde veya sürecinde ayarlayın:

WEBHOOK_URL: sonunda eğik çizgi olan herkese açık HTTPS adresi, https://n8n.example.com/ gibi. n8n, bundan yayınlanmış bir tetikleyicinin URL’sini ve Wait for the Outcome’un devam URL’sini oluşturur.
N8N_EDITOR_BASE_URL: aynı adres. n8n, bundan bir tetikleyicinin Execute step için test URL’sini ve formbase bağlantı bilgisinin OAuth Redirect URL’sini oluşturur.
N8N_PROXY_HOPS: n8n tek bir ters proxy veya tünelin arkasında çalışırken bunu 1’e ayarlayın, böylece n8n proxy’nin ilettiği başlıkları okur.

Docker ile bu şöyle görünür:

bash

docker run -d --name n8n -p 5678:5678 \
  -e WEBHOOK_URL=https://n8n.example.com/ \
  -e N8N_EDITOR_BASE_URL=https://n8n.example.com/ \
  -e N8N_PROXY_HOPS=1 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Docker compose veya bir npm kurulumuyla, aynı değişkenleri n8n’in ortamında ayarlayın. Proxy’nizi veya tünelinizi 5678 portuna yönlendirin, /webhook/, /webhook-test/ ve /webhook-waiting/’i değiştirmeden geçirin ve o andan sonra n8n’i herkese açık adres üzerinden açın.

VALIDATION_ERROR: targetUrl must use https

formbase, bir http:// URL’sine veya özel bir ağ adresine olay göndermeyi reddeder. Bir tetikleyici bu hatayı Execute step’te gösteriyorsa N8N_EDITOR_BASE_URL ayarlı değildir; Publish’te gösteriyorsa WEBHOOK_URL ayarlı değildir. O değişkeni ayarlayın, n8n’i yeniden başlatın ve tekrar deneyin. WEBHOOK_URL’yi daha sonra değiştirirseniz, tetikleyicisinin yeni adresi kaydetmesi için her formbase iş akışının yayınını kaldırıp yeniden yayınlayın.

2. Topluluk düğümünü kurun

Settings › Community nodes’u açın ve Install’a tıklayın. npm Package Name altına n8n-nodes-formbase yazın, doğrulanmamış kod kurmanın risklerini anladığınızı belirten kutuyu işaretleyin ve Install’a tıklayın.

Install community nodes iletişim kutusu: npm Package Name olarak n8n-nodes-formbase, işaretlenmiş risk kutusu ve bir Install düğmesi

Birkaç saniye sonra paket, iki düğümüyle birlikte listede görünür:

Settings › Community nodes, n8n-nodes-formbase'i, sürüm 0.10.1'i ve 2 düğümü listeliyor: formbase, formbase Trigger

Paketi aynı listeden güncelleyin veya kaldırın. Community nodes, Settings’te yoksa, n8n’iniz N8N_COMMUNITY_PACKAGES_ENABLED=false ile başlatılmıştır; bu ayarı kaldırın.

n8n Cloud

n8n Cloud'da henüz kullanılamıyor

n8n Cloud yalnızca n8n’in doğruladığı topluluk düğümlerini kurar ve formbase düğümü henüz doğrulanmadı. Doğrulanana kadar kendi sunucunuzda barındırılan bir n8n kullanın, ya da REST API’yi bir HTTP Request düğümünden çağırın. Bir Cloud örneğinin zaten herkese açık bir HTTPS adresi vardır, bu yüzden düğüm orada kullanılabilir olduğunda yalnızca bu sayfadaki kurulum adımları değişir.

Düğümü kontrol edin

Bir iş akışı açın, +’ya tıklayın ve formbase’i arayın. Düğüm ayrıntıları altı eylem ve altı tetikleyici gösterir:

formbase'in Installed işaretli düğüm ayrıntıları, Actions (6): Cancel request, Create request, Get request, Get many requests, Remind request recipient ve Replay request callback ile, ve daraltılmış bir Triggers (6) bölümü

formbase Trigger, oluşturulan, güncellenen veya yarım bırakılan bir genel bağlantı gönderiminde, ya da tamamlanan, süresi dolan veya iptal edilen bir istekte bir iş akışı başlatır.
formbase, bir istek oluşturur, birini veya birçoğunu alır, alıcıyı hatırlatır, bir isteği iptal eder ve geri çağırmasını yeniden oynatır.

Sırada

formbase'i n8n'e bağlayınBağlantı bilgisini oluşturun, oturum açın ve çalışma alanını seçin.Tüm kılavuzlar