Ringkasan Pantas: Menjalankan n8n secara setempat memerlukan sama ada npm (Node.js 20.19-24.x) atau Docker. Kaedah terpantas menggunakan npx n8n untuk ujian segera tanpa pemasangan, manakala Docker menyediakan pengasingan yang lebih baik dan kesediaan pengeluaran. Kedua-dua kaedah memberikan anda akses penuh kepada keupayaan automasi aliran kerja n8n tanpa kos awan berulang.
Menyediakan n8n pada mesin setempat menghapuskan yuran langganan berulang sambil memberikan kawalan penuh ke atas automasi aliran kerja. Menurut dokumentasi rasmi n8n, platform ini memerlukan versi Node.js antara 20.19 dan 24.x untuk pemasangan npm, atau Docker untuk penempatan terkonteks.
Keputusan antara pengehosan setempat dan perkhidmatan awan mempengaruhi bajet dan fleksibiliti. Menurut perbincangan komuniti, pemasangan setempat mengendalikan aliran kerja tanpa had, manakala pelan awan termasuk harga berdasarkan pelaksanaan (bermula pada $24/bulan untuk 2,500 pelaksanaan menurut beberapa laporan pengguna).
Prasyarat untuk Pemasangan Setempat
Sebelum memasang n8n secara setempat, sistem memerlukan perisian khusus bergantung pada kaedah yang dipilih.
Versi Node.js yang diperlukan untuk pemasangan npm bergantung sepenuhnya pada keperluan khusus versi n8n yang anda letakkan, kerana npm sendiri serasi dengan semua versi LTS Node.js yang disokong pada masa ini. Dokumentasi rasmi menetapkan julat versi tepat ini untuk keserasian. Semak versi semasa dengan menjalankan node –version dalam terminal.
Pemasangan Docker memerlukan Docker Engine atau Docker Desktop. Pasukan n8n mengesyorkan Docker untuk kebanyakan keperluan pengehosan sendiri kerana ia menyediakan pengasingan yang bersih dan mengelakkan ketidakserasian sistem operasi.
Keperluan Sistem
Contoh n8n setempat berjalan pada sistem Windows, macOS, dan Linux. Tiada spesifikasi RAM minimum kelihatan dalam dokumentasi rasmi, tetapi kerumitan aliran kerja menentukan keperluan sumber sebenar.
Pemasangan menggunakan ruang cakera yang minimum pada mulanya. Keperluan storan meningkat berdasarkan data aliran kerja, sejarah pelaksanaan, dan pakej nod tersuai.
Kaedah 1: Menjalankan n8n dengan npm
Pemasangan npm menyediakan laluan terpantas untuk menjalankan n8n secara setempat. Kaedah ini berfungsi terus pada sistem hos tanpa pengkonteksan.
Mula Pantas dengan npx
Pendekatan paling mudah menggunakan npx tanpa pemasangan kekal. Buka terminal dan laksanakan:
| npx n8n |
Perintah ini memuat turun semua yang diperlukan dan memulakan n8n secara automatik. Antara muka menjadi boleh diakses di localhost:5678 dalam beberapa saat.
Kaedah npx berfungsi dengan sempurna untuk ujian dan penilaian. Ia tidak memerlukan pakej npm global atau perubahan sistem kekal.
Pemasangan npm Global
Untuk pemasangan kekal, pakej npm global menyediakan akses yang konsisten:
| npm install n8n -g |
Selepas pemasangan selesai, mulakan n8n pada bila-bila masa dengan menjalankan:
| n8n |
Versi stabil utama n8n semasa ialah 2.x (cth., 2.10.4). Versi beta mungkin mengandungi ciri yang tidak stabil dan harus dielakkan untuk aliran kerja pengeluaran.
Konfigurasi dan Storan Data
Pemasangan npm menyimpan data aliran kerja dalam direktori ~/.n8n secara lalai. Lokasi ini mengandungi kelayakan, definisi aliran kerja, dan sejarah pelaksanaan.
Pembolehubah persekitaran mengawal tingkah laku n8n. Tetapkan pembolehubah N8N_PORT untuk menukar port lalai 5678. Pembolehubah lain mengkonfigurasi sambungan pangkalan data, URL webhook, dan tetapan pengesahan.
Kaedah 2: Menjalankan n8n dengan Docker
Pemasangan Docker mewakili pendekatan yang disyorkan untuk pengehosan n8n setempat. Dokumentasi rasmi menekankan Docker untuk keperluan pengehosan sendiri pengeluaran.
Perintah Larian Docker Asas
Mulakan n8n dengan satu perintah Docker:
| docker run -it –rm –name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Perintah ini mencipta kontena bernama n8n, memetakan port 5678 ke hos, dan mengekalkan data dalam direktori ~/.n8n.
Kontena berjalan secara interaktif dengan bendera -it. Alih keluar –rm untuk menyimpan kontena selepas menghentikannya.
Docker Compose untuk Sediakan Pengeluaran
Konfigurasi Docker Compose menyediakan kawalan yang lebih baik untuk persekitaran pengeluaran. Repositori n8n-hosting di GitHub mengandungi fail Docker Compose sedia untuk digunakan untuk pelbagai seni bina.
Konfigurasi docker-compose.yml asas kelihatan seperti ini:
| 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 |
Mulakan timbunan dengan:
| docker-compose up -d |
Bendera -d menjalankan kontena dalam mod terpisah, membenarkan penggunaan terminal untuk tugasan lain.
Konfigurasi dan Akses Awal
Selepas memulakan n8n melalui salah satu kaedah, navigasi ke localhost:5678 dalam pelayar web. Skrin persediaan awal meminta alamat e-mel dan kata laluan untuk akaun pentadbir.
Pengguna pertama ini menjadi pemilik contoh dengan keistimewaan pentadbiran penuh. Pengguna tambahan boleh ditambah kemudian melalui antara muka pengurusan pengguna.
Sediakan Pengesahan
Untuk keselamatan, dayakan pengesahan walaupun pada pemasangan setempat. Konfigurasi Docker Compose menerima pembolehubah persekitaran pengesahan secara langsung:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
Pembolehubah ini mengaktifkan pengesahan asas HTTP, memerlukan kelayakan untuk semua percubaan akses.
Menguji Nod Tersuai Secara Setempat
Dokumentasi rasmi menerangkan cara menguji nod tersuai semasa pembangunan. Pasang n8n secara global terlebih dahulu, kemudian bina dan paut pakej nod tersuai.
Dalam direktori nod tersuai, jalankan:
| npm run build npm link |
Kemudian navigasi ke direktori nod n8n (biasanya ~/.n8n/custom/) dan pautkan pakej:
| npm link <nama-pakej-nod> |
Nod tersuai muncul dalam antara muka n8n selepas memulakan semula contoh.
Sumber Automasi Berguna untuk Digunakan Dengan n8n
Jika anda sedang mempelajari cara menjalankan n8n secara setempat dan menguji aliran kerja pada mesin anda, anda mungkin juga mendapat manfaat daripada pembantu dan templat luaran yang memudahkan automasi tugasan biasa. Get AI Perks menawarkan pustaka templat aliran kerja dan alatan berbantuan AI yang boleh anda gunakan bersama n8n atau untuk prototaip idea automasi sebelum anda membangunkannya sendiri.
Dengan Get AI Perks, anda boleh:
- Mulakan daripada templat aliran kerja yang sudah dibina
- Dapatkan bantuan AI untuk logik dan kandungan rutin
- Terokai corak automasi biasa sebelum melaksanakannya dalam n8n
- Gabungkan templat dengan persediaan n8n setempat anda
Temui Get AI Perks untuk mencari pembantu automasi yang menyokong aliran kerja n8n anda.
Penyelesaian Masalah Umum
Konflik port mewakili masalah pemasangan yang paling kerap. Jika port 5678 sudah digunakan, sama ada hentikan perkhidmatan yang bercanggoh atau tukar port n8n menggunakan pembolehubah persekitaran N8N_PORT.
Ketidakserasian Versi Node
Menggunakan versi Node.js di luar julat 20.19-24.x menyebabkan kegagalan pemasangan. Repositori GitHub n8n mendokumentasikan isu apabila pembangun cuba persediaan dev setempat, menyoroti kepentingan keserasian versi Node.
Sahkan keserasian versi Node sebelum menyelesaikan masalah lain. Tukar versi Node menggunakan nvm (Node Version Manager) jika perlu.
Ralat Kebenaran Jilid Docker
Isu kebenaran dengan pemasangan jilid ~/.n8n menghalang ketekalan data. Kontena Docker berjalan sebagai pengguna nod, yang mungkin tidak mempunyai akses tulis ke direktori hos.
Cipta direktori dengan kebenaran yang sesuai sebelum memulakan kontena:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Soalan Lazim
Bolehkah n8n berjalan tanpa akses internet?
Ya, n8n berfungsi sepenuhnya di luar talian untuk aliran kerja setempat. Ketersambungan internet hanya menjadi perlu apabila aliran kerja berinteraksi dengan API luaran atau perkhidmatan awan.
Berapakah kos menjalankan n8n secara setempat?
Pemasangan setempat adalah percuma. Edisi komuniti menyediakan semua ciri teras tanpa yuran lesen. Pengehosan awan bermula dengan had pelaksanaan dan kos bulanan, tetapi pengehosan setempat menghapuskan sekatan ini sepenuhnya mengikut perbincangan komuniti.
Haruskah pemula menggunakan npm atau Docker?
Pemula yang menguji n8n harus bermula dengan npx untuk akses segera. Docker lebih masuk akal untuk kegunaan berterusan kerana ia menyediakan pengasingan yang lebih baik dan peningkatan yang lebih mudah.
Di manakah n8n menyimpan data aliran kerja secara setempat?
Direktori data lalai ialah ~/.n8n dalam folder rumah pengguna. Lokasi ini mengandungi fail pangkalan data SQLite, kelayakan dan log pelaksanaan kecuali dikonfigurasikan sebaliknya.
Bolehkah berbilang contoh n8n berjalan pada satu mesin?
Ya, tetapi setiap contoh memerlukan port yang unik. Tetapkan port yang berbeza menggunakan pembolehubah persekitaran N8N_PORT untuk setiap contoh. Docker menjadikan ini lebih mudah melalui pemetaan port dalam kontena yang berasingan.
Bagaimanakah kemas kini berfungsi untuk pemasangan setempat?
Pemasangan npm dikemas kini melalui npm update -g n8n atau npm install -g n8n@latest. Pengguna Docker menarik imej terkini dengan docker pull n8nio/n8n, kemudian mencipta semula kontena. Sentiasa sandarkan direktori ~/.n8n sebelum mengemas kini.
Pertimbangan Pengeluaran
Dokumentasi rasmi n8n menekankan bahawa pengehosan sendiri memerlukan pengetahuan teknikal. Menyediakan pelayan, mengurus sumber, dan mengamankan aplikasi menuntut pengalaman pentadbiran sistem.
Untuk penempatan pengeluaran, Docker Compose menyediakan asas. Tambahkan proksi terbalik seperti nginx atau Caddy untuk sokongan HTTPS. Repositori n8n-hosting termasuk konfigurasi Caddy sedia untuk penempatan.
Pemilihan pangkalan data penting untuk beban kerja yang berat. Pangkalan data SQLite lalai berfungsi untuk kegunaan sederhana, tetapi PostgreSQL menawarkan prestasi yang lebih baik untuk automasi volum tinggi mengikut panduan rasmi.
Membuat Pilihan: Setempat vs Awan
Pengehosan n8n setempat sesuai untuk pasukan dengan keupayaan teknikal dan keperluan keselamatan khusus. Data kekal pada infrastruktur terkawal, dan had pelaksanaan hilang.
Walau bagaimanapun, pengehosan setempat memerlukan penyelenggaraan, sandaran dan pemantauan. Pengehosan awan memindahkan tanggungjawab ini kepada pasukan infrastruktur n8n. Semak tapak web rasmi untuk harga awan semasa dan perbandingan ciri.
Menjalankan n8n secara setempat memberikan kawalan penuh ke atas infrastruktur automasi aliran kerja. Sama ada menggunakan npm untuk ujian pantas atau Docker untuk penempatan pengeluaran, kedua-dua kaedah memberikan platform penuh tanpa kos berulang. Mulakan dengan npx untuk penerokaan segera, kemudian beralih kepada Docker apabila aliran kerja beralih ke penggunaan pengeluaran.
