Mengapa n8n kerap terputus pada VPS anda?
Kenal pasti punca sebenar n8n terputus. Ketahui perbezaan antara ralat sepanduk websocket, gelung mulakan semula, isu OOM kill, dan kegagalan penjadualan aliran kerja.
Mengapa n8n kerap terputus: empat kegagalan, satu simptom
"n8n kerap terputus" adalah satu ayat yang merangkumi empat kegagalan berbeza, dan setiap satunya memerlukan penyelesaian yang berlainan. Editor memaparkan sepanduk sambungan terputus walaupun kontena sedang berjalan seperti biasa. Kontena dimulakan semula dengan sendiri. Kernel menamatkan proses Node.js kerana penggunaan memori yang terlalu tinggi. Atau tiada apa-apa yang salah dengan proses tersebut, namun aliran kerja (workflow) yang aktif langsung tidak dicetuskan. Jika anda menukar tetapan yang salah, anda akan menghabiskan hujung minggu untuk masalah yang sebenarnya tidak wujud.
Oleh itu, kenal pasti kegagalan yang anda hadapi sebelum mengubah sebarang konfigurasi. n8n menjalankan proses utama Node.js, biasanya di dalam kontena Docker, di sebalik reverse proxy yang melakukan TLS (transport layer security) termination. Node kod juga menggunakan proses task runner: mod dalaman (internal mode) melancarkan proses anak (child process), manakala mod luaran (external mode) menjalankannya secara berasingan, biasanya dalam kontena sidecar. Setiap lapisan tersebut boleh gagal dengan cara tersendiri, dan pelayar akan melaporkan kegagalan sambungan dengan mesej yang sama.
Diagnosis mengikut urutan ini
Jalankan perintah-perintah ini pada VPS (virtual private server) dan baca nilai yang dipaparkan oleh mesin anda sendiri. Jangan bandingkan nilai tersebut dengan angka daripada perbincangan forum. Nilai yang penting di sini ialah nilai yang menerangkan pelayan anda, bukan pelayan orang lain.
docker ps -a --filter name=n8n
docker logs --tail 200 --timestamps n8n
docker inspect n8n | grep -iE 'Status|Running|RestartCount|OOMKilled|ExitCode'
docker stats --no-streamLajur STATUS daripada docker ps -a menyatakan tempoh masa kontena berada dalam status semasanya. Bandingkan tempoh tersebut dengan saat masalah anda bermula. Jika kontena telah berjalan sejak sebelum sepanduk (banner) muncul, ini menolak kemungkinan kontena dimulakan semula pada saat itu, namun ia tidak membuktikan n8n kekal tersedia. Semak /healthz untuk kebolehcapaian dan /healthz/readiness untuk pangkalan data yang bersambung dan telah dimigrasi sebelum beralih ke laluan websocket yang dibincangkan dalam bahagian seterusnya.
RestartCount ialah bilangan kali Docker telah memulakan semula kontena ini. Catatkan nombor tersebut, tunggu seminit, kemudian baca semula. Nombor yang meningkat semasa anda memerhati menandakan gelung mulakan semula (restart loop), dan baris log tepat sebelum setiap permulaan semula mengandungi puncanya.
OOMKilled ialah flag benar atau palsu (true atau false). True bermakna Docker merekodkan pembunuhan akibat kehabisan memori (out of memory kill) dalam kontena. Baca flag ini bersama-sama dengan log dan mesej kernel untuk menentukan proses mana yang dibunuh dan sama ada tekanan berpunca daripada had kontena atau keseluruhan mesin.
ExitCode ialah kod keluar terakhir kontena anda. Anda tidak perlu menghafal maksud setiap kod. Baca kod anda, kemudian baca bahagian akhir docker logs daripada cap masa yang sama. Bahagian akhir log dan flag kehabisan memori secara bersama memberitahu anda apa yang berlaku, dan mana-mana satu daripadanya secara sendirian boleh mengelirukan anda.
docker stats menunjukkan penggunaan memori secara langsung di samping had yang berkuat kuasa. Biarkan ia berjalan dalam terminal kedua, cetuskan aliran kerja (workflow) yang menyebabkan masalah, dan perhatikan perubahan nombor tersebut semasa kegagalan berlaku.
Sepanduk sambungan terputus biasanya berpunca daripada reverse proxy anda
Editor n8n mengekalkan satu sambungan tolak (push connection) jangka hayat panjang ke bahagian belakang supaya ia boleh menstrim kemajuan pelaksanaan ke kanvas. Secara lalai, sambungan tersebut ialah WebSocket, iaitu perkara yang dipilih oleh N8N_PUSH_BACKEND, dan nilai lalainya ialah websocket. WebSocket bermula sebagai permintaan HTTP biasa yang membawa pengepala Connection: Upgrade dan Upgrade: websocket. Pelayan menjawab 101 Switching Protocols, dan mulai saat itu kedua-dua pihak menggunakan soket TCP yang sama dalam kedua-dua arah.
Dua masalah proksi akan memutuskan sambungan tersebut. Proksi berkomunikasi menggunakan HTTP/1.0 ke arah hulu (upstream) atau membuang pengepala naik taraf (upgrade headers), menyebabkan naik taraf tidak pernah berlaku dan editor terus menyambung semula tanpa henti. Atau, naik taraf berjaya tetapi proksi kemudian menutup soket kerana ia tidak aktif, memandangkan WebSocket tanpa mesej kelihatan sama seperti sambungan melahu. n8n sendiri juga menolak sambungan tolak disebabkan kegagalan pengesahan atau pengesahan permintaan, termasuk pushRef yang tiada atau origin yang tidak sah. Sepanduk tersebut adalah cara pelayar memberitahu anda bahawa ia kehilangan salurannya, bukan bukti bahawa kontena tersebut sihat.
Sahkan perkara ini dalam pelayar sebelum mengubah apa-apa. Buka alat pembangun (developer tools), pergi ke tab Network, tapis kepada WS, dan muat semula editor. Permintaan tolak tersebut sepatutnya sampai ke 101 Switching Protocols dan kekal terbuka. Permintaan tolak yang mengembalikan kod status biasa, atau yang muncul semula setiap beberapa saat, memerlukan respons dan log n8n diperiksa untuk mengesan ralat proksi, pengesahan atau origin.
Tetapan nginx yang mengekalkan sambungan editor
nginx tidak akan memajukan naik taraf (upgrade) melainkan anda memintanya. Connection dan Upgrade ialah header hop-by-hop yang dibuang oleh nginx semasa proses penghantaran, jadi anda perlu memasukkan semula kedua-duanya. Protokol upstream bergantung pada keluaran nginx anda: sejak 1.29.7 (Mac 2026), proxy_pass menggunakan HTTP/1.1 untuk berhubung dengan backend secara lalai, manakala sebelum itu ia menggunakan HTTP/1.0 yang tidak menyokong naik taraf sama sekali. Jalankan nginx -v untuk melihat versi yang anda gunakan. Konfigurasi di bawah menetapkan proxy_http_version 1.1 secara eksplisit supaya ia berfungsi pada kedua-dua versi, dan pada 1.29.7 atau lebih baharu, baris tersebut hanya menyatakan semula tetapan lalai. Blok map diletakkan dalam konteks http, bukan di dalam server. Jika blok pelayan di bawah tidak biasa bagi anda, panduan langkah demi langkah blok pelayan nginx menerangkan fungsi setiap arahan tersebut.
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}server {
listen 443 ssl;
http2 on;
server_name n8n.example.com;
location / {
proxy_pass http://127.0.0.1:5678;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
proxy_buffering off;
}
}proxy_read_timeout ditetapkan kepada 60 saat secara lalai dan turut terpakai pada WebSocket yang telah dinaik taraf, diukur berdasarkan tempoh antara bacaan daripada backend. n8n menghantar ping tolak (push pings) setiap 60 saat, jadi instans aliran kerja yang tidak aktif tidak bermakna soket tersebut tidak membawa trafik. Meningkatkan tempoh tamat masa memberi ruang kepada ping tersebut untuk sampai tanpa perlu bersaing dengan tamat masa lalai; bingkai ping berkala juga akan menetapkan semula tempoh ini.
sudo nginx -t && sudo systemctl reload nginx
sudo nginx -T | grep -iE 'proxy_http_version|upgrade|proxy_read_timeout'nginx -T menguji dan mencetak fail konfigurasi, termasuk fail yang disertakan, bukannya memeriksa konfigurasi yang sedang dimuatkan oleh proses yang berjalan. Pastikan muat semula (reload) juga berjaya. Konfigurasi yang tersimpan dalam fail tetapi tidak diambil oleh mana-mana baris include adalah punca mengapa pembetulan yang betul kelihatan tidak memberikan sebarang kesan.
Seterusnya, maklumkan kepada n8n bahawa ia berada di belakang proksi, kerana ia membina URL berdasarkan nilai-nilai ini.
environment:
- N8N_HOST=n8n.example.com
- N8N_PROTOCOL=https
- N8N_PORT=5678
- N8N_PROXY_HOPS=1
- N8N_WEBHOOK_URL=https://n8n.example.com/N8N_PROXY_HOPS ditetapkan kepada 0 secara lalai, yang bermaksud n8n menganggap alamat penyambung sebagai alamat klien dan mengabaikan X-Forwarded-For. Tetapkan nilai ini kepada bilangan proksi yang berada di hadapan kontena. Sehingga Oktober 2026, N8N_WEBHOOK_URL ialah nama semasa dan WEBHOOK_URL yang lebih lama masih berfungsi walaupun akan mencetak amaran penamatan (deprecation warning) semasa permulaan.
Traefik memajukan WebSocket secara automatik
Traefik memajukan naik taraf WebSocket tanpa middleware dan tanpa label tambahan. Nilai lalai tamat masa HTTP-nya tidak menetapkan tamat masa untuk WebSocket yang telah dinaik taraf. Tombol di bawah berada pada entryPoint: setakat Oktober 2026 dalam Traefik v3, idleTimeout ditetapkan secara lalai kepada 180 saat untuk sambungan keep-alive HTTP melahu dan readTimeout ditetapkan secara lalai kepada 60 saat untuk membaca permintaan, termasuk badannya. Tamat masa penulisan respons secara eksplisit mengecualikan naik taraf protokol. Contoh ini mengubah tamat masa HTTP; ia bukan penyelesaian tetap untuk banner WebSocket.
entryPoints:
websecure:
address: ":443"
transport:
respondingTimeouts:
readTimeout: 0
idleTimeout: 3600sCaddy mengendalikan naik taraf secara automatik dalam reverse_proxy dan tidak memerlukan arahan untuknya. Jika anda tidak boleh mengubah proksi sama sekali kerana ia dimiliki oleh pihak lain, tukar saluran tolak dengan N8N_PUSH_BACKEND=sse. SSE (server-sent events) ialah respons HTTP biasa yang dibiarkan terbuka, jadi ia mampu bertahan melalui proksi yang menolak naik taraf, walaupun tamat masa melahu yang agresif masih boleh memutuskannya. Memilih proksi itu sendiri merupakan keputusan yang berasingan, dan perbandingan nginx, Caddy dan Traefik merangkumi kos operasi bagi setiap satu.
Apabila kontena benar-benar dimulakan semula
Jika RestartCount meningkat, kontena tersebut gagal dan Docker cuba memulakannya semula. Selaraskan cap masa log dengan setiap permulaan semula dan baca mesej yang muncul serta-merta sebelumnya. Punca biasa termasuk ralat konfigurasi yang menghalang permulaan, pangkalan data yang tidak dapat dicapai oleh n8n, kegagalan sistem (crash) semasa berjalan, dan penamatan akibat kehabisan memori (memory kill).
Mulakan dengan volum, kerana isu kebenaran (permissions) sering tidak disedari. Imej rasmi berjalan sebagai pengguna tanpa keistimewaan node dan menyimpan datanya dalam /home/node/.n8n. Jika bind mount tidak boleh ditulis oleh pengguna tersebut, proses akan gagal apabila ia cuba menulis datanya, dan polisi permulaan semula boleh mengubah kegagalan tersebut menjadi gelung (loop).
docker compose config
docker run --rm -it --entrypoint sh docker.n8n.io/n8nio/n8n -c 'id'
docker exec n8n ls -ld /home/node/.n8nVolum bernama yang baharu akan mewarisi pemilikan direktori imej apabila Docker mengisinya; volum sedia ada masih perlu diperiksa kebenarannya. Jika anda memerlukan bind mount, chown direktori hos kepada ID pengguna berangka yang dicetak oleh arahan id. Pemetaan pemilikan antara hos dan kontena perlu difahami sekali, dan penjelasan PUID dan PGID merangkumi cara imej-imej ini menentukan siapa yang menulis fail tersebut.
OOM kill yang kelihatan seperti kegagalan sistem
Terdapat dua had memori berasingan di atas proses n8n, dan kedua-duanya gagal dengan cara yang berbeza. Had kumpulan kawalan (cgroup) kontena dikuatkuasakan oleh kernel: jika penggunaan mencapai had dan tidak dapat dikurangkan, kernel akan memanggil OOM killer. Penggunaan boleh melebihi had tersebut buat sementara waktu. OOM kill tidak memberi peluang kepada mangsa untuk menulis entri log terakhir, dan Docker merekodkannya dalam OOMKilled. Had heap V8 dikuatkuasakan di dalam Node.js: kehabisan had ini menghasilkan ralat heap fatal dan menamatkan proses tanpa OOM kill kernel. Dari pelayar, kedua-duanya kelihatan sama. Baca docker inspect bersama-sama dengan log untuk membezakannya.
Tetapkan had heap Node di bawah had kontena, bagi memberi ruang untuk peruntukan natif, penimbal (buffer), kawasan heap lain dan proses lain dalam kontena. Had heap yang lebih tinggi meningkatkan risiko OOM kill kernel sebelum V8 mencapai hadnya sendiri, tetapi tidak menjamin perkara itu berlaku: memori boleh dituntut semula atau diswap, dan beban kerja mungkin tidak akan menghabiskan kedua-dua had tersebut. Had heap yang lebih rendah juga tidak menjamin ralat heap akan berlaku sebelum OOM kill kontena.
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: unless-stopped
environment:
- NODE_OPTIONS=--max-old-space-size=<MiB, below the container limit>
deploy:
resources:
limits:
memory: <your container limit>Gantikan pemegang tempat heap dengan nilai angka dalam MiB, menggunakan format --max-old-space-size=SIZE. Pilih kedua-dua nombor berdasarkan kapasiti sebenar VPS anda, dengan meninggalkan ruang untuk pangkalan data, proksi dan sistem pengendalian. docker stats --no-stream mencetak penggunaan semasa di samping had yang sedang berkuat kuasa, supaya anda boleh menyemak sama ada had yang anda tulis adalah had yang digunakan oleh Docker. Bagaimana had memori Compose digunakan menerangkan kunci mana yang diutamakan apabila beberapa had ditetapkan.
Data pelaksanaan adalah perkara yang berkembang di bawah anda
Satu pelaksanaan menyimpan output setiap nod semasa proses berjalan, dan n8n kemudian menyimpan data tersebut mengikut tetapan penyimpanan pelaksanaan. Dua kesan akan berlaku. Jumlah data dan kerja yang dilakukan oleh setiap nod mempengaruhi penggunaan memori puncak, jadi aliran kerja yang mengendalikan sepuluh ribu baris sekaligus adalah program yang berbeza daripada aliran kerja yang sama yang mengendalikan dua ratus baris pada satu masa. Selain itu, salinan yang disimpan akan terus berkembang sehingga sesuatu memadamkannya.
Pruning menangani masalah kedua. Setakat Oktober 2026, tetapan lalai adalah pruning didayakan, EXECUTIONS_DATA_MAX_AGE pada 336 jam (14 hari) dan EXECUTIONS_DATA_PRUNE_MAX_COUNT pada 10000. Ini adalah tetapan yang longgar untuk VPS kecil yang menjalankan SQLite, di mana satu fail menyimpan segala-galanya dan proses yang sama yang melayani editor perlu membaca serta menulisnya.
environment:
- EXECUTIONS_DATA_PRUNE=true
- EXECUTIONS_DATA_MAX_AGE=72
- EXECUTIONS_DATA_PRUNE_MAX_COUNT=1000
- EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
- EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=falseEXECUTIONS_DATA_SAVE_ON_SUCCESS=none ialah tetapan yang agresif. Ia melumpuhkan penyimpanan pelaksanaan yang berjaya; pelaksanaan yang gagal akan disimpan jika EXECUTIONS_DATA_SAVE_ON_ERROR kekal pada tetapan lalai all, dan tetapan aliran kerja individu boleh mengatasi pilihan ini. Tentukan perkara ini dengan sengaja, kerana aliran kerja yang menghasilkan output yang salah tanpa mencetuskan ralat tidak akan meninggalkan apa-apa untuk anda periksa. Pruning juga menandakan baris sebagai dipadam terlebih dahulu dan membuangnya pada proses seterusnya, dan SQLite menggunakan semula halaman yang dikosongkan dan bukannya mengembalikannya, jadi saiz fail pada cakera tidak mengecil sebaik sahaja anda menukar tetapan tersebut.
Untuk mengurangkan penggunaan puncak dan bukannya jumlah keseluruhan yang disimpan, pindahkan data yang lebih sedikit bagi setiap pelaksanaan. Pecahkan tugasan besar kepada sub-aliran kerja yang mengembalikan hasil kecil kepada induk, lakukan batch dengan nod Loop Over Items, dan elakkan menyimpan keseluruhan set data di dalam nod Code.
Fail binari tidak sepatutnya melalui memori
N8N_DEFAULT_BINARY_DATA_MODE ditetapkan secara lalai kepada default, yang menyimpan data binari dalam memori proses yang sedang berjalan. Fail yang dimuat turun oleh aliran kerja menambah penggunaan memori tersebut. Satu aliran kerja yang mengambil beberapa lampiran besar boleh menolak proses melepasi had yang tidak pernah dicapai oleh kerja JSON biasa, itulah sebabnya kegagalan berlaku pada aliran kerja tertentu dan bukannya mengikut masa.
environment:
- N8N_DEFAULT_BINARY_DATA_MODE=filesystemDengan filesystem, data binari ditulis di bawah N8N_BINARY_DATA_STORAGE_PATH, yang secara lalai berada di dalam folder pengguna n8n dan oleh itu disimpan pada volum yang sama dengan segala-galanya. Pastikan volum tersebut mempunyai ruang yang mencukupi sebelum anda menukar tetapan. N8N_PAYLOAD_SIZE_MAX menetapkan muatan webhook masuk terbesar dalam MiB (mebibyte) dan ditetapkan kepada 16 secara lalai. Meningkatkan nilai ini membolehkan permintaan yang lebih besar masuk, dan itu merupakan kos memori yang anda pilih untuk terima.
Apa sahaja yang berkongsi pelayan yang sama akan bersaing untuk mendapatkan RAM yang sama. Jika pembunuhan OOM bermula apabila anda menambah kontena pangkalan data, menjalankan pangkalan data dalam Docker atau pada hos adalah pertukaran yang anda lakukan sekarang.
Polisi mulakan semula, dan kembali selepas but semula
Kontena tanpa polisi mulakan semula akan kekal mati selepas ia keluar, dan selepas hos but semula. restart: unless-stopped akan menghidupkannya semula dalam kedua-dua keadaan sambil tetap menghormati kontena yang anda hentikan secara manual. restart: always juga akan memulakan semula kontena yang anda hentikan dengan sengaja, sebaik sahaja Docker bermula.
n8n menyediakan titik akhir kesihatan, yang dinamakan oleh N8N_ENDPOINT_HEALTH, yang secara lalai adalah healthz. Semak titik akhir tersebut daripada hos terlebih dahulu supaya anda tahu laluan tersebut betul pada instans anda.
curl -fsS http://127.0.0.1:5678/healthz
docker exec n8n which wget curl
sudo systemctl is-enabled dockerHealthcheck sahaja tidak akan memulakan semula apa-apa. Compose menandakan kontena sebagai tidak sihat dan berhenti di situ; polisi mulakan semula bertindak apabila kontena keluar, manakala pemerhati luaran diperlukan untuk memulakan semula kontena secara khusus kerana ia tidak sihat. Menulis healthcheck yang benar-benar bertindak dan memastikan stack bermula semula selepas but semula merangkumi kedua-dua bahagian tersebut.
Aliran kerja yang tidak pernah berjalan walaupun n8n berfungsi dengan baik
Keadaan ini tidak menghasilkan sebarang sepanduk atau mulakan semula. Kontena sedang berjalan, editor berfungsi, dan pelaksanaan yang anda jangkakan tiada dalam senarai pelaksanaan. Berikut adalah empat perkara untuk diperiksa.
- Aliran kerja tidak diterbitkan. Simpan dan terbitkan aliran kerja menggunakan Schedule Trigger supaya jadual pengeluarannya berjalan.
- Zon waktu bukan milik anda. Schedule Trigger menggunakan zon waktu aliran kerja terlebih dahulu, kemudian zon waktu instans jika tiada zon waktu aliran kerja ditetapkan.
GENERIC_TIMEZONEmenggunakan lalai kepadaAmerica/New_York; tetapkan zon waktu aliran kerja atau tukar lalai instans kepada zon waktu anda sendiri. - Pelaksanaan terlepas tempoh tangguh. Penjadual tahan lasak (durable scheduler) didayakan secara lalai bermula dari n8n 2.45.0 dan merekodkan pelaksanaan akan datang dalam pangkalan data. Pelaksanaan yang direkodkan akan berjalan lewat selepas mulakan semula dalam tempoh tangguhnya; selepas tempoh itu, polisi kegagalan (misfire policy) yang dikonfigurasikan akan menentukan sama ada untuk melangkau pelaksanaan tersebut atau melakukan pelaksanaan susulan. Penjadual dalam memori yang lebih lama akan melangkau pelaksanaan yang sepatutnya berlaku semasa waktu henti.
- Aliran kerja telah dinyahaktifkan untuk anda.
N8N_WORKFLOW_AUTODEACTIVATION_ENABLEDdimatikan secara lalai, dan apabila ia dihidupkan, aliran kerja yang terus terhempas akan dinyahterbitkan, yang kemudiannya kelihatan sama seperti aliran kerja yang tidak pernah diaktifkan oleh sesiapa.
Buka senarai pelaksanaan dan tapis mengikut aliran kerja tersebut. Entri yang gagal bermakna terdapat masalah pada aliran kerja. Jika ia gagal dengan ralat 429 terhadap servis lain yang anda hoskan pada mesin yang sama, had tersebut adalah milik servis itu dan bukannya n8n, dan panduan SearXNG 429 menunjukkan cara untuk membezakan pengehad kadar (rate limiter) servis tersebut daripada enjin yang menyekat IP pelayan anda. Tiada entri langsung juga berlaku apabila penyimpanan pelaksanaan dinyahdayakan atau proses pemangkasan (pruning) telah membuang rekod tersebut, jadi periksa tetapan tersebut sebelum menganggapnya sebagai masalah pencetus (trigger).
Perkara yang perlu diubah dahulu
- Baca
STATUS,RestartCountdanOOMKilledpada container anda sendiri sebelum menyunting sebarang fail. - Jika container kekal berjalan, semak kebolehcapaian n8n dan kesediaan pangkalan data, kemudian periksa sambungan push untuk ralat proksi, pengesahan, asal (origin) atau tamat masa (timeout).
- Jika
OOMKilledadalah benar, tetapkan had container yang anda pilih secara sengaja, sediakan ruang di bawahnya apabila menetapkan had Node heap, dan tukar data binari kepadafilesystem. - Jika tiada apa-apa yang dicetuskan, semak sama ada aliran kerja (workflow) telah diterbitkan, zon waktu berkesannya adalah milik anda, serta tetapan penjadual dan misfire sepadan dengan jangkaan anda.
Kebanyakan perkara ini merupakan konfigurasi yang ditetapkan sekali sahaja dan tidak perlu diubah lagi, di atas pemasangan yang berfungsi. Jika anda masih dalam proses melakukan pemasangan tersebut, panduan n8n pada Docker dengan HTTPS adalah asas bagi tetapan ini.
FAQ
Mengapakah editor n8n memaparkan sepanduk "connection lost" sedangkan kontena sedang berjalan?
Editor mengekalkan sambungan WebSocket untuk menstrim kemajuan pelaksanaan. Jika reverse proxy anda tidak memajukan header Connection: Upgrade dan Upgrade: websocket, atau tidak menggunakan HTTP/1.1 upstream, proses naik taraf (upgrade) tidak akan selesai dan pelayar akan terus menyambung semula sementara n8n kekal sihat. Dalam nginx, anda memerlukan kedua-dua baris proxy_set_header dan proxy_http_version 1.1 pada keluaran yang lebih lama daripada 1.29.7 (keluaran baharu menggunakan HTTP/1.1 secara lalai). Meningkatkan proxy_read_timeout melebihi nilai lalai 60 saat memberikan ruang untuk ping berkala n8n sampai; aliran kerja yang senyap tidak menjadikan sambungan tersebut terbiar (idle). n8n juga menolak permintaan push yang tidak sah dan kegagalan pengesahan, jadi periksa respons dan log aplikasi. Semak fail konfigurasi dengan sudo nginx -T dan sahkan bahawa muat semula (reload) berjaya dilakukan.
Bagaimanakah cara membezakan "out of memory kill" daripada kerosakan (crash) biasa?
Jalankan docker inspect n8n | grep -iE 'OOMKilled|ExitCode|RestartCount' dan baca flag OOMKilled. Nilai "true" bermaksud Docker merekodkan "out of memory kill"; mangsa tidak berpeluang menulis entri log terakhir, walaupun log kontena sebelumnya masih boleh membantu. Nilai "false", dengan ralat heap kritikal pada penghujung docker logs, menunjukkan Node.js telah menghabiskan V8 heap miliknya. Tetapkan NODE_OPTIONS=--max-old-space-size=SIZE dengan saiz angka dalam MiB di bawah had kontena anda, bagi memberi ruang untuk penggunaan memori lain. Ini mengehadkan V8 old space, tetapi tidak menjamin ralat heap akan berlaku sebelum "kernel OOM kill".
Adakah pembersihan (pruning) data pelaksanaan membebaskan ruang cakera dengan serta-merta?
Tidak. EXECUTIONS_DATA_PRUNE menandakan pelaksanaan lama untuk dipadamkan dan proses seterusnya akan membuangnya, mengikut jadual yang ditetapkan oleh EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL. Dengan SQLite, fail tersebut juga menggunakan semula halaman yang dibebaskan dan bukannya mengembalikannya kepada sistem fail, jadi saiz pada cakera kekal sama untuk seketika selepas baris data dipadamkan. Tetapkan EXECUTIONS_DATA_MAX_AGE dan EXECUTIONS_DATA_PRUNE_MAX_COUNT kepada nilai yang sesuai dengan pelayan anda, kemudian semak semula pada hari berikutnya dan bukannya serta-merta.
Mengapakah aliran kerja berjadual saya tidak berjalan semasa n8n dimulakan semula?
Penjadual tahan lasak (durable scheduler), yang diaktifkan secara lalai bermula n8n 2.45.0, mengekalkan pelaksanaan akan datang dalam pangkalan data. Pelaksanaan yang direkodkan akan dijalankan lewat apabila n8n kembali dalam tempoh tangguh (grace period) masing-masing. Melebihi tempoh tersebut, polisi "misfire" pencetus (trigger) akan menentukan sama ada untuk melangkau tunggakan atau melakukan pelaksanaan susulan (catch-up). Semak versi anda, konfigurasi penjadual, dan pilihan Schedule Trigger. Instans yang menggunakan penjadual dalam memori (in-memory) yang lebih lama akan melangkau pelaksanaan yang sepatutnya berlaku semasa waktu henti (downtime).
Adakah healthcheck akan memulakan semula n8n apabila ia berhenti bertindak balas?
Tidak secara sendirinya. Healthcheck dalam Compose hanya menandakan kontena sebagai sihat atau tidak sihat. Polisi mulakan semula (restart policy) bertindak apabila kontena keluar, jadi restart: unless-stopped akan menghidupkannya semula selepas keluar dan selepas but semula hos, dengan syarat ia tidak dihentikan secara sengaja dan Docker bermula. Sahkan perkara itu dengan sudo systemctl is-enabled docker. Untuk bertindak secara khusus terhadap status tidak sihat, anda memerlukan pemerhati (watcher) di luar Docker yang membaca status tersebut dan memulakan semula servis.