Qısa Xülasə: n8n-i yerli rejimdə işlətmək üçün npm (Node.js 20.19-24.x) və ya Docker lazımdır. Ən sürətli üsul quraşdırmadan dərhal test etmək üçün npx n8n-dən istifadə edir, Docker isə daha yaxşı izolyasiya və istehsal üçün hazırlıq təmin edir. Hər iki üsul, təkrarlanan bulud xərcləri olmadan n8n-in iş axını avtomatlaşdırma qabiliyyətlərinə tam giriş imkanı verir.
n8n-i yerli kompüterdə qurmaq, təkrarlanan abunəlik haqlarından azad edərkən, iş axını avtomatlaşdırması üzərində tam nəzarət təmin edir. Rəsmi n8n sənədlərinə görə, platforma npm quraşdırmaları üçün Node.js versiyası 20.19 və 24.x arasında olmalıdır və ya konteynerləşdirilmiş yerləşdirmələr üçün Docker lazımdır.
Yerli yerləşdirmə və bulud xidmətləri arasındakı qərar həm büdcəyə, həm də çevikliyə təsir edir. İcma müzakirələrinə görə, yerli quraşdırmalar məhdud iş axınlarını idarə edir, bulud planları isə icraya əsaslanan qiymətləri əhatə edir (bəzi istifadəçi hesabatlarına görə 2500 icra üçün ayda 24 dollardan başlayır).
Yerli Quraşdırma üçün Tələblər
n8n-i yerli rejimdə quraşdırmadan əvvəl, seçilən üsuldan asılı olaraq sistemdə müəyyən proqram təminatı olmalıdır.
npm quraşdırması üçün tələb olunan Node.js versiyası, tamamilə tətbiq etdiyiniz n8n versiyasının xüsusi tələblərindən asılıdır, çünki npm-in özü Node.js-in hazırda dəstəklənən bütün LTS versiyaları ilə uyğundur. Rəsmi sənədlər uyğunluq üçün bu dəqiq versiya diapazonunu müəyyən edir. Terminalda node –version işlədərək cari versiyanı yoxlayın.
Docker quraşdırmaları üçün Docker Engine və ya Docker Desktop lazımdır. n8n komandası əksər öz-özünə yerləşdirmə ehtiyacları üçün Docker-i tövsiyə edir, çünki o, təmiz izolyasiya təmin edir və əməliyyat sistemi uyğunsuzluqlarının qarşısını alır.
Sistem Tələbləri
Yerli n8n nümunələri Windows, macOS və Linux sistemlərində işləyir. Rəsmi sənədlərdə minimal RAM spesifikasiyası yoxdur, lakin iş axınının mürəkkəbliyi faktiki resurs ehtiyaclarını müəyyən edir.
Quraşdırma ilkin olaraq minimal disk sahəsini istehlak edir. Saxlama ehtiyacları iş axını məlumatları, icra tarixi və xüsusi düyün paketlərinə əsasən artır.
Metod 1: n8n-i npm ilə İşlətmək
npm quraşdırması n8n-i yerli rejimdə işlətmək üçün ən sürətli yolu təmin edir. Bu üsul konteynerləşdirmədən host sistemində birbaşa işləyir.
npx ilə Sürətli Başlanğıc
Ən sadə yanaşma daimi quraşdırma olmadan npx-dən istifadə edir. Terminalı açın və icra edin:
| npx n8n |
Bu komanda lazım olan hər şeyi yükləyir və n8n-i avtomatik olaraq işə salır. İnterfeys bir neçə saniyə ərzində localhost:5678 ünvanında əlçatan olur.
npx üsulu test və qiymətləndirmə üçün mükəmməl işləyir. Qlobal npm paketləri və ya daimi sistem dəyişiklikləri tələb etmir.
Qlobal npm Quraşdırması
Daimi quraşdırma üçün qlobal npm paketi ardıcıl giriş imkanı təmin edir:
| npm install n8n -g |
Quraşdırma tamamlandıqdan sonra, hər zaman işlədərək n8n-i başlatın:
| n8n |
n8n-in hazırkı əsas stabil versiyası 2.x-dir (məsələn, 2.10.4). Beta versiyalar sabit olmayan xüsusiyyətlər ehtiva edə bilər və istehsal iş axınları üçün istifadə edilməməlidir.
Konfiqurasiya və Məlumat Saxlanması
npm quraşdırmaları iş axını məlumatlarını standart olaraq ~/.n8n qovluğunda saxlayır. Bu yer etibarnamələrini, iş axını təriflərini və icra tarixini ehtiva edir.
Ətraf Mühit Dəyişənləri n8n-in davranışını idarə edir. Standart port 5678-i dəyişdirmək üçün N8N_PORT dəyişənini təyin edin. Digər dəyişənlər məlumat bazası əlaqələrini, webhook URL-lərini və autentifikasiya parametrlərini konfiqurasiya edir.
Metod 2: n8n-i Docker ilə İşlətmək
Docker quraşdırması yerli n8n yerləşdirməsi üçün tövsiyə olunan yanaşmadır. Rəsmi sənədlər istehsal üçün öz-özünə yerləşdirmə ehtiyacları üçün Docker-i vurğulayır.
Əsas Docker İşlətmə Komandası
Bir Docker komandası ilə n8n-i işə salın:
| docker run -it –rm –name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Bu komanda n8n adlı bir konteyner yaradır, hosta 5678 portunu map edir və ~/.n8n qovluğunda məlumatları saxlayır.
-it bayrağı ilə konteyner interaktiv şəkildə işləyir. Dayanmış konteyneri saxlamaq üçün –rm-i silin.
İstehsal Quraşdırması üçün Docker Compose
Docker Compose konfiqurasiyaları istehsal mühitləri üçün daha yaxşı nəzarət təmin edir. GitHub-dakı n8n-hosting repozitoriyası müxtəlif arxitekturalar üçün istifadəyə hazır Docker Compose faylları ehtiva edir.
Əsas bir docker-compose.yml konfiqurasiyası belə görünür:
| version: ‘3.8’ services: n8n: image: n8nio/n8n restart: always ports: - “5678:5678” environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=password volumes: - ~/.n8n:/home/node/.n8n |
Yığını işə salın:
| docker-compose up -d |
-d bayrağı konteynerləri ayrılmış rejimdə işlədir, terminaldan digər tapşırıqlar üçün istifadə etməyə imkan verir.
İlk Konfiqurasiya və Giriş
İstər npm, istərsə də Docker metodu ilə n8n-i işə saldıqdan sonra, veb brauzerinizdə localhost:5678 ünvanına keçin. İlk quraşdırma ekranı admin hesabı üçün e-poçt ünvanı və şifrə tələb edir.
Bu ilk istifadəçi tam inzibati imtiyazlara malik olan nümunə sahibi olacaq. Sonradan istifadəçi idarəetmə interfeysi vasitəsilə əlavə istifadəçilər əlavə etmək olar.
Autentifikasiya Quraşdırması
Təhlükəsizlik məqsədilə, yerli quraşdırmalarda belə autentifikasiyanı aktivləşdirin. Docker Compose konfiqurasiyaları birbaşa autentifikasiya ətraf mühit dəyişənlərini qəbul edir:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=strongpassword |
Bu dəyişənlər HTTP əsas autentifikasiyasını aktivləşdirir, bütün giriş cəhdləri üçün etimadnamə tələb edir.
Xüsusi Düyünləri Yerli Rejimdə Test Etmək
Rəsmi sənədlər inkişaf zamanı xüsusi düyünləri necə test etməyinizi izah edir. Əvvəlcə n8n-i qlobal olaraq quraşdırın, sonra xüsusi düyün paketini yaradın və bağlayın.
Xüsusi düyün qovluğunda işlədin:
| npm run build npm link |
Sonra n8n düyün qovluğuna (adətən ~/.n8n/custom/) gedin və paketi bağlayın:
| npm link <node-package-name> |
Nümunə yenidən başladıldıqdan sonra xüsusi düyün n8n interfeysində görünəcək.
n8n ilə İstifadə Üçün Faydalı Avtomatlaşdırma Resursları
Əgər siz n8n-i yerli rejimdə necə işlətməyi öyrənirsinizsə və öz kompüterinizdə iş axınlarını test edirsinizsə, ümumi tapşırıqları asanlaşdıran xarici köməkçilərdən və şablonlardan da faydalana bilərsiniz. Get AI Perks, n8n ilə birlikdə istifadə edə biləcəyiniz və ya özünüz tikmədən əvvəl avtomatlaşdırma ideyalarını prototipləşdirmək üçün iş axını şablonları və AI-əsaslı alətlər kitabxanasını təqdim edir.
Get AI Perks ilə siz:
- Əvvəlcədən hazırlanmış iş axını şablonlarından başlayın
- Rutin məntiq və məzmun üçün AI köməyi alın
- n8n-də həyata keçirməzdən əvvəl ümumi avtomatlaşdırma nümunələrini araşdırın
- Yerli n8n quraşdırmanızla şablonları birləşdirin
n8n iş axınlarınızı dəstəkləyən avtomatlaşdırma köməkçilərini tapmaq üçün Get AI Perks-i kəşf edin.
Ümumi Problemlərin Həlli
Port münaqişələri ən çox yayılmış quraşdırma problemidir. 5678 portu artıq istifadə edilirsə, ya münaqişəli xidməti dayandırın, ya da N8N_PORT ətraf mühit dəyişənindən istifadə edərək n8n-in portunu dəyişdirin.
Node Versiyası Uyğunsuzluğu
20.19-24.x diapazonundan kənar Node.js versiyalarından istifadə quraşdırma uğursuzluqlarına səbəb olur. n8n GitHub repozitoriyası, inkişaf etdiricilər yerli inkişaf mühitləri yaratmağa çalışdıqda yaranan problemləri sənədləşdirir, Node versiyası uyğunluğunun əhəmiyyətini vurğulayır.
Digər problemləri həll etməzdən əvvəl Node versiyası uyğunluğunu yoxlayın. Lazım gələrsə, nvm (Node Version Manager) istifadə edərək Node versiyalarını dəyişdirin.
Docker Həcminin İcazə Səhvləri
~/.n8n həcmi bağlayıcısı ilə bağlı icazə problemləri məlumatların saxlanmasının qarşısını alır. Docker konteynerləri node istifadəçisi kimi işləyir, bu da host qovluğuna yazma icazəsinə malik olmaya bilər.
Konteyneri işə salmadan əvvəl qovluğu müvafiq icazələrlə yaradın:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Tez-tez Verilən Suallar
n8n internet bağlantısı olmadan işləyə bilərmi?
Bəli, n8n yerli iş axınları üçün tamamilə oflayn rejimdə işləyir. İnternet bağlantısı yalnız iş axınları xarici API-lər və ya bulud xidmətləri ilə qarşılıqlı əlaqədə olduqda lazımdır.
n8n-i yerli rejimdə işlətmək nə qədər başa gəlir?
Yerli quraşdırmalar pulsuzdur. İcma buraxılışı bütün əsas xüsusiyyətləri lisenziya haqları olmadan təqdim edir. Bulud yerləşdirməsi icra limitləri və aylıq xərclərlə başlayır, lakin icma müzakirələrinə görə, yerli yerləşdirmə bu məhdudiyyətləri tamamilə aradan qaldırır.
Başlanğıclar npm və ya Docker istifadə etməlidirmi?
Başlanğıclar n8n-i test edərkən dərhal giriş üçün npx ilə başlamalıdır. Donor istifadə üçün daha məqsədəuyğundur, çünki o, daha yaxşı izolyasiya və daha asan yeniləmələr təmin edir.
n8n yerli iş axını məlumatlarını harada saxlayır?
Standart məlumat qovluğu, istifadəçinin ev qovluğunda ~/.n8n-dir. Bu yer, əgər başqa cür konfiqurasiya edilməyibsə, SQLite məlumat bazası fayllarını, etibarnamələri və icra jurnallarını ehtiva edir.
Bir kompüterdə birdən çox n8n nümunəsi işləyə bilərmi?
Bəli, lakin hər nümunəyə unikal port lazımdır. Hər nümunə üçün N8N_PORT ətraf mühit dəyişənini istifadə edərək fərqli portlar təyin edin. Docker bunu ayrı konteynerlərdə port map etməklə asanlaşdırır.
Yerli quraşdırmalar üçün yeniləmələr necə işləyir?
npm quraşdırmaları npm update -g n8n və ya npm install -g n8n@latest vasitəsilə yenilənir. Docker istifadəçiləri docker pull n8nio/n8n ilə son imici çəkirlər, sonra konteynerləri yenidən yaradırlar. Yeniləmədən əvvəl həmişə ~/.n8n qovluğunu yedəkləyin.
İstehsal Mülahizələri
Rəsmi n8n sənədləri öz-özünə yerləşdirmənin texniki bilik tələb etdiyini vurğulayır. Serverləri qurmaq, resursları idarə etmək və tətbiqləri təmin etmək sistem inzibatçılığı təcrübəsi tələb edir.
İstehsal yerləşdirmələri üçün Docker Compose təməlini təmin edir. HTTPS dəstəyi üçün nginx və ya Caddy kimi bir tərs proksi əlavə edin. n8n-hosting repozitoriyası istifadəyə hazır Caddy konfiqurasiyalarını ehtiva edir.
Məlumat bazası seçimi ağır iş yükləri üçün vacibdir. Standart SQLite məlumat bazası mülayim istifadə üçün işləyir, lakin rəsmi təlimata görə PostgreSQL yüksək həcmli avtomatlaşdırma üçün daha yaxşı performans təklif edir.
Qərar Vermək: Yerli vs Bulud
Yerli n8n yerləşdirməsi texniki imkanlara və xüsusi təhlükəsizlik tələblərinə malik komandalar üçün uyğundur. Məlumatlar nəzarət olunan infrastrukturda qalır və icra limitləri yox olur.
Lakin, yerli yerləşdirmə texniki xidmət, yedəkləmələr və monitorinq tələb edir. Bulud yerləşdirməsi bu məsuliyyətləri n8n-in infrastruktur komandasına köçürür. Cari bulud qiymətləri və xüsusiyyət müqayisələri üçün rəsmi veb saytına baxın.
n8n-i yerli rejimdə işlətmək, iş axını avtomatlaşdırma infrastrukturuna tam nəzarət imkanı verir. Nə təcili test üçün npm, nə də istehsal yerləşdirmələri üçün Docker istifadə etsəniz, hər iki üsul təkrarlanan xərclər olmadan tam platformanı təqdim edir. Təcili araşdırma üçün npx ilə başlayın, sonra iş axınları istehsal istifadəsinə doğru irəlilədikdə Docker-ə keçin.
