SSD Nodes Learn Hosting plans →

n8n VPS-ல் அடிக்கடி offline ஆவது ஏன்? தீர்வுகள்

n8n offline ஆவதற்கு நான்கு முக்கிய காரணங்கள் உள்ளன. Connection lost பிழை, restart loop, OOM kill மற்றும் dead schedule ஆகியவற்றை கண்டறிந்து சரிசெய்யும் முறைகளை இதில் விரிவாகக் காணலாம்.

n8n ஏன் offline ஆகிறது: நான்கு தோல்விகள், ஒரு அறிகுறி

"n8n offline ஆகிறது" என்பது நான்கு வெவ்வேறு தோல்விகளைக் குறிக்கும் ஒரே வாக்கியமாகும்; ஒவ்வொன்றிற்கும் வெவ்வேறு தீர்வுகள் தேவை. container சாதாரணமாக இயங்கிக்கொண்டிருக்கும்போது, editor "connection lost" என்ற அறிவிப்பைக் காட்டலாம். container தானாகவே restart ஆகலாம். அதிகப்படியான memory-ஐப் பயன்படுத்துவதால், kernel ஆனது Node.js process-ஐக் கொல்லலாம். அல்லது process-ல் எந்தப் பிரச்சினையும் இல்லாமல், ஒரு active workflow இயங்காமல் இருக்கலாம். தவறான அமைப்பை மாற்றினால், இல்லாத ஒரு சிக்கலுக்காக நீங்கள் வார இறுதி முழுவதையும் செலவிட நேரிடும்.

எனவே, எந்தவொரு configuration-ஐயும் மாற்றும் முன், உங்களுக்கு ஏற்பட்டுள்ள தோல்வி எது என்பதைக் கண்டறியவும். n8n ஒரு முதன்மை Node.js process-ஐ இயக்குகிறது; இது பொதுவாக Docker container-க்குள், TLS (transport layer security)-ஐ முடிக்கும் reverse proxy-க்கு பின்னால் இருக்கும். Code nodes-ம் task runner process-களைப் பயன்படுத்துகின்றன: internal mode ஒரு child process-ஐத் தொடங்குகிறது, அதேசமயம் external mode அவற்றைத் தனியாக, பொதுவாக ஒரு sidecar container-ல் இயக்குகிறது. இந்த ஒவ்வொரு அடுக்கும் அதன் சொந்த வழியில் செயலிழக்கக்கூடும், ஆனால் browser அதே செய்தியைக் கொண்டு connection தோல்விகளைப் புகாரளிக்கும்.

இந்த வரிசையில் கண்டறியவும்

இந்தக் கட்டளைகளை உங்கள் VPS (virtual private server)-ல் இயக்கி, உங்கள் கணினி காட்டும் மதிப்புகளைப் படிக்கவும். அவற்றை ஏதேனும் ஒரு forum-ல் உள்ள எண்களுடன் ஒப்பிட வேண்டாம். இங்கே முக்கியமானது உங்கள் கணினியின் மதிப்புகள் மட்டுமே, மற்றவர்களுடையது அல்ல.

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-stream

docker ps -a-ன் STATUS நெடுவரிசை, container அதன் தற்போதைய நிலையில் எவ்வளவு காலம் உள்ளது என்பதைக் காட்டுகிறது. உங்கள் சிக்கல் தொடங்கிய நேரத்துடன் இதை ஒப்பிட்டுப் பாருங்கள். பிழை தோன்றுவதற்கு நீண்ட காலத்திற்கு முன்பே container இயங்கிக்கொண்டிருந்தால், அந்த நேரத்தில் container restart ஆகவில்லை என்று அர்த்தம்; ஆனால், n8n தொடர்ந்து பயன்பாட்டில் இருந்தது என்று இதற்குப் பொருள் அல்ல. அடுத்த பகுதிக்குச் செல்லும் முன், /healthz மூலம் அணுகல்தன்மையையும் (reachability), /healthz/readiness மூலம் இணைக்கப்பட்ட மற்றும் migrated செய்யப்பட்ட database-ஐயும் சரிபார்க்கவும்.

RestartCount என்பது Docker இந்த container-ஐ எத்தனை முறை restart செய்தது என்பதைக் குறிக்கிறது. அந்த எண்ணைக் குறித்துக் கொண்டு, ஒரு நிமிடம் காத்திருந்து, மீண்டும் சரிபார்க்கவும். நீங்கள் கவனிக்கும்போதே அந்த எண் அதிகரித்தால், அது restart loop-ல் உள்ளது என்று அர்த்தம்; ஒவ்வொரு restart-க்கு முன்பும் உள்ள log வரிகள் அதற்கான காரணத்தைக் கொண்டிருக்கும்.

OOMKilled என்பது true அல்லது false என்ற flag ஆகும். True என்றால், container-ல் out of memory (OOM) பிழையை Docker பதிவு செய்துள்ளது என்று அர்த்தம். எந்த process நிறுத்தப்பட்டது என்பதையும், அந்த அழுத்தம் container-ன் வரம்பினால் ஏற்பட்டதா அல்லது முழு கணினியின் அழுத்தத்தினால் ஏற்பட்டதா என்பதையும் கண்டறிய, logs மற்றும் kernel செய்திகளுடன் சேர்த்து இதைப் படிக்கவும்.

ExitCode என்பது உங்கள் container கடைசியாக வெளியேறிய (exit) குறியீட்டைக் காட்டுகிறது. ஒவ்வொரு குறியீடும் எதைக் குறிக்கிறது என்பதை மனப்பாடம் செய்ய வேண்டிய அவசியமில்லை. உங்கள் குறியீட்டைப் படித்துவிட்டு, அதே timestamp-ல் உள்ள docker logs-ன் முடிவைப் படிக்கவும். log-ன் கடைசிப் பகுதியும், out of memory flag-ம் சேர்ந்து என்ன நடந்தது என்பதைத் தெரிவிக்கும்; இரண்டில் ஒன்றை மட்டும் பார்த்தால் தவறான முடிவுக்கு வரக்கூடும்.

docker stats, நடைமுறையில் உள்ள வரம்பிற்கு அருகில் தற்போதைய memory பயன்பாட்டைக் காட்டுகிறது. இதை மற்றொரு terminal-ல் இயங்கவிட்டு, சிக்கலை ஏற்படுத்தும் workflow-ஐத் தூண்டிவிட்டு, தோல்வி ஏற்படும்போது அந்த எண் எவ்வாறு மாறுகிறது என்பதைக் கவனிக்கவும்.


இணைப்பு துண்டிக்கப்பட்டதற்கான அறிவிப்பு பொதுவாக உங்கள் reverse proxy-ஆல் ஏற்படுகிறது

n8n editor, execution progress-ஐ canvas-ல் காண்பிக்க, backend-உடன் நீண்ட காலம் நீடிக்கும் ஒரு push connection-ஐத் திறந்து வைத்திருக்கும். இயல்பாக, அந்த இணைப்பு ஒரு WebSocket ஆகும்; இதைத்தான் N8N_PUSH_BACKEND தேர்வு செய்கிறது, மேலும் அதன் இயல்புநிலை மதிப்பு websocket ஆகும். ஒரு WebSocket, Connection: Upgrade மற்றும் Upgrade: websocket ஆகிய headers-ஐக் கொண்ட சாதாரண HTTP கோரிக்கையாகத் தொடங்குகிறது. சர்வர் 101 Switching Protocols என்று பதிலளிக்கும், அதன் பிறகு இரு தரப்பும் ஒரே TCP socket-ஐ இரு திசைகளிலும் பயன்படுத்தும்.

இரண்டு வகையான proxy சிக்கல்கள் இந்த இணைப்பைத் துண்டிக்கும். ஒன்று, proxy-ஆனது HTTP/1.0-ஐ upstream-க்கு அனுப்புவது அல்லது upgrade headers-ஐ நீக்கிவிடுவது; இதனால் upgrade நடைபெறாது, editor மீண்டும் மீண்டும் இணைக்க முயற்சிக்கும். அல்லது, upgrade வெற்றிகரமாக நடந்த பிறகு, நீண்ட நேரம் எந்தத் தகவலும் பரிமாறப்படாததால், idle connection என்று கருதி proxy அந்த socket-ஐ மூடிவிடும். n8n-ம் கூட authentication அல்லது request-validation தோல்விகளுக்காக, அதாவது pushRef விடுபட்டிருந்தாலோ அல்லது origin தவறாக இருந்தாலோ, push connection-ஐ நிராகரிக்கும். இந்த அறிவிப்பு, browser தனது இணைப்பை இழந்துவிட்டதைக் குறிக்கிறதே தவிர, container சரியாக இயங்குகிறது என்பதற்குச் சான்றல்ல.

எந்த மாற்றத்தையும் செய்வதற்கு முன், browser-ல் இதை உறுதிப்படுத்தவும். Developer tools-ஐத் திறந்து, Network tab-க்குச் சென்று, WS என்று filter செய்து, editor-ஐ reload செய்யவும். அந்த push request 101 Switching Protocols-ஐ அடைந்து, தொடர்ந்து திறந்த நிலையில் இருக்க வேண்டும். சாதாரண status code-ஐத் தரும் push request அல்லது சில வினாடிகளுக்கு ஒருமுறை மீண்டும் தோன்றும் request-களின் response-ஐயும், n8n logs-ல் உள்ள proxy, authentication அல்லது origin பிழைகளையும் சரிபார்க்க வேண்டும்.

எடிட்டரை இணைப்பில் வைத்திருக்கும் nginx அமைப்புகள்

நீங்கள் கோரினால் ஒழிய, nginx ஒரு upgrade கோரிக்கையை முன்னோக்கி அனுப்பாது. Connection மற்றும் Upgrade ஆகியவை hop-by-hop headers ஆகும்; இவற்றை nginx வழியில் நீக்கிவிடும், எனவே நீங்கள் இரண்டையும் மீண்டும் சேர்க்க வேண்டும். upstream protocol உங்கள் nginx release-ஐப் பொறுத்தது: 1.29.7 (மார்ச் 2026) முதல் proxy_pass இயல்பாகவே backend-உடன் HTTP/1.1-ல் தொடர்பு கொள்கிறது. அதற்கு முன்பு இது HTTP/1.0-ஐப் பயன்படுத்தியது, அது upgrade-ஐ ஆதரிக்காது. உங்களிடம் எந்தப் பதிப்பு உள்ளது என்பதைப் பார்க்க nginx -v கட்டளையை இயக்கவும். கீழே உள்ள config, proxy_http_version 1.1-ஐத் தெளிவாகக் குறிப்பிடுவதால், அது இரண்டிலும் வேலை செய்யும்; 1.29.7 அல்லது அதற்குப் பிந்தைய பதிப்புகளில் அந்த வரி இயல்பான அமைப்பை மீண்டும் உறுதிப்படுத்துகிறது. map தொகுதி http சூழலில் இருக்க வேண்டும், server-க்குள் இருக்கக்கூடாது. கீழே உள்ள server தொகுதியின் பிற பகுதிகள் உங்களுக்குப் புரியவில்லை என்றால், nginx server தொகுதியின் வரி வாரியான விளக்கம் ஒவ்வொரு directive-ம் என்ன செய்கிறது என்பதை விளக்குகிறது.

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 இயல்பாக 60 வினாடிகளாக உள்ளது, இது மேம்படுத்தப்பட்ட WebSocket-க்கும் பொருந்தும்; இது backend-லிருந்து தரவைப் படிக்கும் இடைவெளியைக் கணக்கிடுகிறது. n8n ஒவ்வொரு 60 வினாடிகளுக்கும் push pings அனுப்புகிறது, எனவே ஒரு workflow instance சும்மா இருந்தாலும் socket-ல் traffic இருக்கும். timeout-ஐ அதிகரிப்பதன் மூலம், இயல்புநிலை timeout-க்கு முன்பே pings வந்து சேர வழிவகை செய்யப்படுகிறது; அவ்வப்போது வரும் ping frames-ம் இதை reset செய்யும்.

sudo nginx -t && sudo systemctl reload nginx
sudo nginx -T | grep -iE 'proxy_http_version|upgrade|proxy_read_timeout'

nginx -T, தற்போது இயங்கும் process-ல் உள்ள configuration-ஐச் சோதிக்காமல், configuration கோப்புகளைச் சோதித்து அச்சிடுகிறது. reload வெற்றிகரமாக முடிந்ததை உறுதிப்படுத்தவும். ஒரு கோப்பில் உள்ள config-ஐ எந்த include வரியும் எடுக்கவில்லை என்றால், சரியான திருத்தம் செய்தும் எந்த மாற்றமும் தெரியாது.

பிறகு, n8n ஒரு proxy-க்கு பின்னால் உள்ளது என்பதை அதற்குத் தெரிவிக்கவும், ஏனெனில் அது இந்த மதிப்புகளைக் கொண்டே URL-களை உருவாக்குகிறது.

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 இயல்பாக 0 என உள்ளது, அதாவது n8n இணைக்கும் முகவரியையே client முகவரியாகக் கருதி X-Forwarded-For-ஐப் புறக்கணிக்கும். இதை container-க்கு முன்னால் உள்ள proxies-ன் எண்ணிக்கைக்கு ஏற்ப அமைக்கவும். அக்டோபர் 2026 நிலவரப்படி, N8N_WEBHOOK_URL என்பதே தற்போதைய பெயர்; பழைய WEBHOOK_URL இப்போதும் வேலை செய்யும், ஆனால் startup-ல் deprecation எச்சரிக்கையை அச்சிடும்.

Traefik தானாகவே WebSocket-களை forward செய்கிறது

Traefik எந்தவொரு middleware அல்லது கூடுதல் labels இல்லாமலேயே WebSocket upgrade-ஐ forward செய்கிறது. இதன் HTTP timeout இயல்பான அமைப்புகள், upgrade செய்யப்பட்ட WebSocket-க்கு காலாவதி நேரத்தை (timeout) நிர்ணயிப்பதில்லை. கீழே உள்ள அமைப்புகள் entryPoint-ல் உள்ளன: அக்டோபர் 2026 நிலவரப்படி Traefik v3-ல், idleTimeout என்பது idle HTTP keep-alive இணைப்புகளுக்கு 180 வினாடிகளாகவும், readTimeout என்பது கோரிக்கையை (request) வாசிப்பதற்கும் அதன் body-க்கும் சேர்த்து 60 வினாடிகளாகவும் இயல்பாக அமைக்கப்பட்டுள்ளன. பதில் எழுதும் காலாவதி (response write timeout) என்பது protocol upgrade-களைத் தவிர்த்துவிடும். இந்த உதாரணம் HTTP காலாவதி நேரங்களை மாற்றுகிறது; இது WebSocket banner-க்கான நிரந்தரத் தீர்வு அல்ல.

entryPoints:
  websecure:
    address: ":443"
    transport:
      respondingTimeouts:
        readTimeout: 0
        idleTimeout: 3600s

Caddy தானாகவே reverse_proxy-ல் upgrade-ஐக் கையாளுகிறது, இதற்கு எந்தவொரு கூடுதல் directive-ம் தேவையில்லை. வேறொருவர் நிர்வகிக்கும் proxy என்பதால் உங்களால் அதை மாற்ற முடியாவிட்டால், N8N_PUSH_BACKEND=sse மூலம் push channel-ஐ மாற்றவும். SSE (server-sent events) என்பது திறந்த நிலையில் இருக்கும் ஒரு சாதாரண HTTP பதில் ஆகும், எனவே upgrade-ஐ மறுக்கும் proxy-யிலும் இது செயல்படும், இருப்பினும் மிகக் கடுமையான idle timeout இதைத் துண்டிக்கக்கூடும். எந்த proxy-ஐத் தேர்ந்தெடுப்பது என்பது தனிப்பட்ட முடிவு, மேலும் Nginx, Caddy மற்றும் Traefik ஒப்பீடு ஒவ்வொன்றையும் இயக்குவதற்கான செலவுகள் மற்றும் சவால்களை விளக்குகிறது.

container மீண்டும் மீண்டும் தொடங்கும் போது

RestartCount அதிகரித்தால், container தோல்வியடைகிறது மற்றும் Docker அதை மீண்டும் தொடங்குகிறது. log-ல் உள்ள நேர முத்திரைகளை (timestamps) ஒவ்வொரு restart-உடனும் ஒப்பிட்டு, அதற்கு முன்னால் என்ன பிழை பதிவாகியுள்ளது என்பதைப் படிக்கவும். தொடக்கத்தைத் தடுக்கும் configuration பிழை, n8n அணுக முடியாத database, இயங்கும்போது ஏற்படும் crash மற்றும் memory kill போன்றவை பொதுவான காரணங்களாகும்.

முதலில் volume-ஐச் சரிபார்க்கவும், ஏனெனில் அனுமதி (permissions) தொடர்பான சிக்கல்கள் பெரும்பாலும் அமைதியாகவே இருக்கும். அதிகாரப்பூர்வ image, சலுகைகள் இல்லாத node பயனர் மூலம் இயங்குகிறது மற்றும் அதன் தரவை /home/node/.n8n-ல் சேமிக்கிறது. ஒரு bind mount-க்கு அந்தப் பயனரால் எழுத முடியவில்லை என்றால், தரவை எழுத முயற்சிக்கும்போது செயல்முறை (process) தோல்வியடையும், மேலும் restart policy அந்தத் தோல்வியை ஒரு சுழற்சியாக (loop) மாற்றும்.

docker compose config
docker run --rm -it --entrypoint sh docker.n8n.io/n8nio/n8n -c 'id'
docker exec n8n ls -ld /home/node/.n8n

புதிய named volume, Docker அதை உருவாக்கும்போது image directory-ன் உரிமையைப் பெறுகிறது; ஆனால் ஏற்கனவே உள்ள volume-ன் அனுமதிகளைச் சரிபார்க்க வேண்டும். உங்களுக்கு bind mount தேவைப்பட்டால், id கட்டளை அச்சிட்ட numeric user id-க்கு host directory-ஐ chown செய்யவும். host மற்றும் container-க்கு இடையிலான ownership mapping-ஐ ஒருமுறை புரிந்துகொள்வது அவசியம், மேலும் PUID மற்றும் PGID விளக்கம் இந்த image-கள் கோப்புகளை யார் எழுதுவது என்பதை எவ்வாறு தீர்மானிக்கின்றன என்பதை விளக்குகிறது.

நினைவகப் பற்றாக்குறையினால் ஏற்படும் திடீர் செயலிழப்பு (OOM kill)

n8n process-க்கு மேலே இரண்டு தனித்தனி நினைவக வரம்புகள் உள்ளன, இவை வெவ்வேறு விதமாகச் செயலிழக்கின்றன. Container control group வரம்பை kernel அமல்படுத்துகிறது: பயன்பாடு வரம்பை எட்டி, அதைக் குறைக்க முடியாதபோது, kernel OOM killer-ஐத் தூண்டுகிறது. பயன்பாடு தற்காலிகமாக அந்த வரம்பைத் தாண்டலாம். OOM kill நடக்கும்போது, பாதிக்கப்பட்ட process-க்கு இறுதி log பதிவை எழுத வாய்ப்பு கிடைப்பதில்லை, மேலும் Docker இதை OOMKilled-ல் பதிவு செய்கிறது. V8 heap வரம்பை Node.js உள்ளே அமல்படுத்துகிறது: இதை மீறினால் fatal heap error ஏற்பட்டு, kernel OOM kill இல்லாமலேயே process வெளியேறுகிறது. உலாவியில் (browser) பார்க்கும்போது இவை இரண்டும் ஒரே மாதிரியாகத் தெரியும். இவற்றை வேறுபடுத்தி அறிய docker inspect-ஐ logs-உடன் சேர்த்துப் படிக்கவும்.

Node heap வரம்பை container வரம்பை விடக் குறைவாக அமைக்கவும். இது native allocations, buffers, பிற heap பகுதிகள் மற்றும் container-ல் உள்ள பிற process-களுக்குத் தேவையான இடத்தைத் தரும். heap வரம்பு அதிகமாக இருந்தால், V8 அதன் சொந்த வரம்பை எட்டுவதற்கு முன்பே kernel OOM kill ஏற்படும் அபாயம் அதிகரிக்கிறது, ஆனால் இது உறுதியானது அல்ல: நினைவகத்தை மீண்டும் பெறலாம் அல்லது swap செய்யலாம், மேலும் பணிச்சுமை எந்த வரம்பையும் எட்டாமலும் இருக்கலாம். heap வரம்பு குறைவாக இருப்பது, container OOM kill-க்கு முன்பே heap error ஏற்படும் என்பதற்கு உத்தரவாதம் அளிக்காது.

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>

heap placeholder-க்கு பதிலாக MiB-ல் ஒரு எண்ணை, --max-old-space-size=SIZE வடிவத்தைப் பயன்படுத்தி இடவும். உங்கள் VPS-ல் உள்ள உண்மையான நினைவகத்தின் அடிப்படையில் இரண்டு எண்களையும் தேர்ந்தெடுக்கவும்; database, proxy மற்றும் operating system-க்குத் தேவையான இடத்தை விட்டுவிடவும். docker stats --no-stream தற்போதைய பயன்பாட்டையும் அமலில் உள்ள வரம்பையும் காட்டும், எனவே நீங்கள் குறிப்பிட்ட வரம்புதான் Docker-ஆல் பயன்படுத்தப்படுகிறதா என்பதைச் சரிபார்க்கலாம். Compose நினைவக வரம்புகள் எவ்வாறு அமல்படுத்தப்படுகின்றன என்பதில், பல வரம்புகள் அமைக்கப்படும்போது எந்த key முன்னுரிமை பெறும் என்பது விளக்கப்பட்டுள்ளது.

செயல்பாட்டுத் தரவு உங்கள் கட்டுப்பாட்டிற்கு அடியில் வளரும் ஒன்று

ஒரு workflow இயங்கிக்கொண்டிருக்கும்போது, ஒவ்வொரு node-ன் வெளியீட்டையும் ஒரு தனிப்பட்ட execution வைத்திருக்கும். பின்னர், n8n அந்தத் தரவை அதன் execution saving அமைப்புகளுக்கு ஏற்ப சேமிக்கும். இதனால் இரண்டு விளைவுகள் ஏற்படுகின்றன. ஒவ்வொரு node-ம் செய்யும் வேலை மற்றும் தரவின் அளவு ஆகியவை peak memory பயன்பாட்டைப் பாதிக்கும். எனவே, பத்தாயிரம் வரிசைகளை ஒரே நேரத்தில் கையாளும் ஒரு workflow, இருநூறு வரிசைகளை கையாளும் அதே workflow-லிருந்து முற்றிலும் மாறுபட்டது. மேலும், சேமிக்கப்பட்ட நகல் ஏதேனும் ஒன்றால் நீக்கப்படும் வரை வளர்ந்துகொண்டே இருக்கும்.

Pruning இந்த இரண்டாவது சிக்கலைத் தீர்க்கிறது. அக்டோபர் 2026 நிலவரப்படி, இயல்புநிலை அமைப்புகள் pruning-ஐச் செயல்படுத்தியுள்ளன. EXECUTIONS_DATA_MAX_AGE 336 மணிநேரமாகவும் (14 நாட்கள்), EXECUTIONS_DATA_PRUNE_MAX_COUNT 10000 ஆகவும் உள்ளன. SQLite-ஐ இயக்கும் ஒரு சிறிய VPS-க்கு இவை தாராளமானவை. ஏனெனில், அங்கு ஒரே கோப்பு அனைத்தையும் வைத்திருக்கிறது மற்றும் editor-ஐ இயக்கும் அதே process-தான் அதைப் படிக்கவும் எழுதவும் வேண்டும்.

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=false

EXECUTIONS_DATA_SAVE_ON_SUCCESS=none என்பது ஒரு தீவிரமான அமைப்பாகும். இது வெற்றிகரமான executions-ஐச் சேமிப்பதை முடக்குகிறது. EXECUTIONS_DATA_SAVE_ON_ERROR அதன் இயல்புநிலையான all-ல் இருந்தால், தோல்வியுற்ற executions மட்டும் சேமிக்கப்படும். தனிப்பட்ட workflow அமைப்புகள் இந்தத் தேர்வுகளை மாற்றியமைக்கலாம். இதைத் திட்டமிட்டு முடிவு செய்யுங்கள், ஏனெனில் பிழையை ஏற்படுத்தாமல் தவறான வெளியீட்டைத் தரும் ஒரு workflow-ஐ ஆய்வு செய்ய உங்களிடம் எந்தத் தரவும் இருக்காது. Pruning முதலில் வரிசைகளை நீக்கப்பட்டதாகக் குறிக்கும், பின்னர் ஒரு கட்டத்தில் அவற்றை அகற்றும். SQLite விடுவிக்கப்பட்ட பக்கங்களை மீண்டும் பயன்படுத்துமே தவிர, அவற்றை உடனே திருப்பித் தராது. எனவே, நீங்கள் அமைப்பை மாற்றிய உடனேயே வட்டில் உள்ள கோப்பின் அளவு குறையாது.

சேமிக்கப்பட்ட மொத்த அளவைக் குறைப்பதற்குப் பதிலாக, peak பயன்பாட்டைக் குறைக்க, ஒவ்வொரு run-லும் குறைவான தரவை அனுப்புங்கள். பெரிய வேலைகளைச் சிறிய முடிவுகளை parent-க்குத் திருப்பி அனுப்பும் sub-workflows-ஆகப் பிரிக்கவும். Loop Over Items node மூலம் batch செய்யவும், முழு dataset-களையும் Code node-க்குள் கொண்டு செல்வதைத் தவிர்க்கவும்.

Binary கோப்புகளை நினைவகத்தின் (memory) வழியாக அனுப்பக்கூடாது

N8N_DEFAULT_BINARY_DATA_MODE இயல்பாக default-க்கு அமைக்கப்பட்டுள்ளது, இது binary தரவுகளை இயங்கும் execution-ன் நினைவகத்திலேயே வைத்திருக்கும். ஒரு workflow பதிவிறக்கம் செய்யும் கோப்புகள் அந்த நினைவகப் பயன்பாட்டை அதிகரிக்கும். சில பெரிய கோப்புகளைப் பதிவிறக்கும் ஒரு workflow, சாதாரண JSON வேலைகள் நெருங்க முடியாத அளவிற்கு நினைவகப் பயன்பாட்டை உயர்த்திவிடும். இதனால்தான், குறிப்பிட்ட நேரத்திற்குப் பதிலாக, ஒரு குறிப்பிட்ட workflow-ஐ இயக்கும்போது crash ஏற்படுகிறது.

environment:
  - N8N_DEFAULT_BINARY_DATA_MODE=filesystem

filesystem மூலம், binary தரவுகள் N8N_BINARY_DATA_STORAGE_PATH-ன் கீழ் எழுதப்படுகின்றன. இது இயல்பாக n8n பயனர் கோப்புறையில் (user folder) இருப்பதால், மற்ற கோப்புகள் இருக்கும் அதே volume-ல் சேமிக்கப்படும். நீங்கள் மாற்றும் முன், அந்த volume-ல் போதுமான இடம் இருப்பதை உறுதி செய்யவும். N8N_PAYLOAD_SIZE_MAX என்பது உள்ளே வரும் webhook payload-ன் அதிகபட்ச அளவை MiB-ல் (mebibytes) குறிக்கிறது, இதன் இயல்பு மதிப்பு 16 ஆகும். இதை அதிகரிப்பதன் மூலம் பெரிய கோப்புகளை அனுமதிக்கலாம், ஆனால் இது நினைவகப் பயன்பாட்டில் நீங்கள் ஏற்கும் கூடுதல் சுமையாகும்.

அதே server-ல் இயங்கும் மற்ற அனைத்தும் ஒரே RAM-ஐப் பகிர்ந்து கொள்கின்றன. நீங்கள் database container-ஐச் சேர்த்த பிறகு OOM (Out of Memory) பிழைகள் ஏற்படத் தொடங்கினால், database-ஐ Docker-ல் அல்லது host-ல் இயக்குவது நீங்கள் இப்போது செய்ய வேண்டிய சமரசமாகும்.

Restart policy மற்றும் reboot-க்குப் பிறகு மீண்டும் தொடங்குதல்

Restart policy இல்லாத ஒரு container, அது வெளியேறிய பிறகோ அல்லது host reboot செய்யப்பட்ட பிறகோ மீண்டும் இயங்காது. restart: unless-stopped, இந்த இரண்டு சூழல்களிலும் container-ஐ மீண்டும் இயக்கும்; அதே சமயம் நீங்கள் கைமுறையாக நிறுத்திய container-ஐ இது பாதிக்காது. restart: always, நீங்கள் வேண்டுமென்றே நிறுத்திய container-ஐயும் Docker அடுத்த முறை தொடங்கும் போது மீண்டும் இயக்கிவிடும்.

n8n ஒரு health endpoint-ஐ வழங்குகிறது, இது N8N_ENDPOINT_HEALTH மூலம் குறிப்பிடப்படுகிறது, இதன் default மதிப்பு healthz ஆகும். உங்கள் instance-ல் path சரியாக உள்ளதா என்பதை உறுதிப்படுத்த, முதலில் host-லிருந்து அதைச் சரிபார்க்கவும்.

curl -fsS http://127.0.0.1:5678/healthz
docker exec n8n which wget curl
sudo systemctl is-enabled docker

Healthcheck மட்டும் எதையும் தானாக restart செய்யாது. Compose அந்த container-ஐ unhealthy என்று குறிக்கும், அதோடு நின்றுவிடும்; restart policy என்பது container வெளியேறினால் மட்டுமே செயல்படும். ஒரு container unhealthy-ஆக இருப்பதால் அதை restart செய்ய வேண்டுமெனில், அதற்கு ஒரு external watcher தேவை. செயல்படும் வகையில் ஒரு healthcheck-ஐ எழுதுதல் மற்றும் reboot-க்குப் பிறகு stack-ஐ மீண்டும் தொடங்குதல் ஆகிய பகுதிகள் இவை இரண்டையும் விளக்குகின்றன.

n8n சரியாக இயங்கினாலும் தூண்டப்படாத workflow

இந்தச் சூழலில் எந்த அறிவிப்பும் வராது, மறுதொடக்கமும் நடக்காது. Container இயங்கிக்கொண்டிருக்கும், editor வேலை செய்யும், ஆனால் நீங்கள் எதிர்பார்த்த run executions பட்டியலில் இருக்காது. சரிபார்க்க வேண்டிய நான்கு விஷயங்கள் கீழே உள்ளன.

  • Workflow வெளியிடப்படவில்லை (not published). Schedule Trigger-ஐப் பயன்படுத்தி workflow-ஐச் சேமித்து வெளியிடவும், அப்போதுதான் அதன் production schedule இயங்கும்.
  • நேர மண்டலம் (timezone) உங்களுடையது அல்ல. Schedule Trigger முதலில் workflow-ன் நேர மண்டலத்தைப் பயன்படுத்தும், அது அமைக்கப்படவில்லை எனில் instance-ன் நேர மண்டலத்தைப் பயன்படுத்தும். GENERIC_TIMEZONE இயல்பாக America/New_York என இருக்கும்; workflow-ன் நேர மண்டலத்தை அமைக்கவும் அல்லது instance-ன் இயல்புநிலை அமைப்பை உங்களுடையதாக மாற்றவும்.
  • run அதன் grace period-ஐத் தவறவிட்டது. n8n 2.45.0 முதல் durable scheduler இயல்பாகவே செயல்படுத்தப்பட்டுள்ளது, இது வரவிருக்கும் run-களை database-ல் பதிவு செய்யும். மறுதொடக்கத்திற்குப் பிறகு, grace period-க்குள் இருக்கும் பதிவு செய்யப்பட்ட run-கள் தாமதமாக இயங்கும்; அதற்குப் பிறகு, misfire policy-ன் அடிப்படையில் அவை தவிர்க்கப்படுமா அல்லது catch-up run செய்யப்படுமா என்பது தீர்மானிக்கப்படும். பழைய in-memory scheduler, downtime-ன் போது வர வேண்டிய run-களைத் தவிர்த்துவிடும்.
  • workflow உங்களுக்காக முடக்கப்பட்டுள்ளது. N8N_WORKFLOW_AUTODEACTIVATION_ENABLED இயல்பாகவே அணைக்கப்பட்டிருக்கும், இது ஆன் செய்யப்பட்டிருக்கும்போது, அடிக்கடி crash ஆகும் workflow தானாகவே unpublished நிலைக்குச் சென்றுவிடும். அதன் பிறகு, யாரும் activate செய்யாத workflow போலவே அது காட்சியளிக்கும்.

Executions பட்டியலைத் திறந்து அந்த workflow-ஐ மட்டும் filter செய்யவும். தோல்வியடைந்த entry இருந்தால், அது workflow சார்ந்த சிக்கல். நீங்கள் அதே server-ல் வைத்திருக்கும் மற்றொரு service-ல் 429 பிழை ஏற்பட்டால், அந்த வரம்பு n8n-ஐச் சார்ந்தது அல்ல, அந்த service-ஐச் சார்ந்தது. SearXNG 429 வழிமுறை உங்கள் server IP-ஐத் தடுக்கும் engine-களிடமிருந்து, அந்த service-ன் rate limiter-ஐ எவ்வாறு வேறுபடுத்திப் பார்ப்பது என்பதைக் காட்டுகிறது. Execution சேமிப்பு முடக்கப்பட்டிருந்தாலோ அல்லது pruning மூலம் பதிவு நீக்கப்பட்டிருந்தாலோ executions பட்டியலில் எந்த entry-யும் இருக்காது. எனவே, இதை ஒரு trigger சிக்கலாகக் கருதுவதற்கு முன் அந்த அமைப்புகளைச் சரிபார்க்கவும்.

முதலில் எதை மாற்ற வேண்டும்

  1. எந்தவொரு கோப்பையும் திருத்துவதற்கு முன்பு, உங்கள் சொந்த container-ல் STATUS, RestartCount மற்றும் OOMKilled ஆகியவற்றை வாசிக்கவும்.
  2. container தொடர்ந்து இயங்கினால், n8n-ன் அணுகல் திறன் (reachability) மற்றும் database தயாராக உள்ளதா என்பதைச் சரிபார்க்கவும். பின்னர், proxy, authentication, origin அல்லது timeout பிழைகளுக்காக push connection-ஐ ஆய்வு செய்யவும்.
  3. OOMKilled என்பது true எனில், நீங்கள் கவனமாகத் தேர்ந்தெடுத்த container limit-ஐ அமைக்கவும். Node heap ceiling-ஐ அமைக்கும்போது அதற்கு கீழே போதிய இடைவெளி விடவும், மேலும் binary data-வை filesystem-க்கு மாற்றவும்.
  4. எதுவும் செயல்படவில்லை எனில், workflow வெளியிடப்பட்டுள்ளதா (published), அதன் effective timezone உங்களுடையதுதானா, மற்றும் அதன் scheduler மற்றும் misfire அமைப்புகள் உங்கள் எதிர்பார்ப்புகளுடன் ஒத்துப்போகிறதா என்பதைச் சரிபார்க்கவும்.

இவை பெரும்பாலும் ஒருமுறை மட்டும் அமைத்துவிட்டு மறக்கக்கூடிய configuration-கள் ஆகும்; இவை ஏற்கனவே இயங்கிக்கொண்டிருக்கும் ஒரு install-ன் மேல் செய்யப்படுபவை. நீங்கள் இன்னும் அந்த install-ஐ உருவாக்கிக்கொண்டிருக்கிறீர்கள் என்றால், HTTPS உடன் Docker-ல் n8n-ஐ நிறுவும் வழிமுறை என்பது இந்த அமைப்புகள் சேர வேண்டிய அடிப்படை ஆகும்.

FAQ

n8n container இயங்கிக்கொண்டிருக்கும்போது, editor ஏன் "connection lost" என்ற எச்சரிக்கையைக் காட்டுகிறது?

Editor, execution progress-ஐ stream செய்ய ஒரு WebSocket-ஐத் திறந்து வைத்திருக்கும். உங்கள் reverse proxy, Connection: Upgrade மற்றும் Upgrade: websocket headers-ஐ forward செய்யவில்லை என்றாலோ அல்லது upstream-க்கு HTTP/1.1-ஐப் பயன்படுத்தவில்லை என்றாலோ, இந்த upgrade முழுமையடையாது. இதனால் n8n சரியாக இயங்கினாலும், browser மீண்டும் மீண்டும் இணைக்க முயற்சிக்கும். Nginx-ல், proxy_set_header வரிகள் மற்றும் 1.29.7-க்கு முந்தைய releases-க்கு proxy_http_version 1.1 ஆகிய இரண்டும் தேவை (புதிய பதிப்புகள் இயல்பாகவே HTTP/1.1-ஐப் பயன்படுத்துகின்றன). proxy_read_timeout-ஐ அதன் இயல்பான 60 வினாடிகளுக்கு மேல் அதிகரிப்பது, n8n-ன் காலமுறை pings வந்து சேர உதவும்; அமைதியான workflows மட்டும் இணைப்பை idle ஆக்காது. n8n தவறான push requests மற்றும் authentication தோல்விகளையும் நிராகரிக்கும், எனவே response மற்றும் application logs-ஐச் சரிபார்க்கவும். sudo nginx -T மூலம் configuration கோப்புகளைச் சரிபார்த்து, reload வெற்றிகரமாக முடிந்ததை உறுதிப்படுத்தவும்.

ஒரு சாதாரண crash-க்கும், memory பற்றாக்குறையினால் ஏற்படும் kill-க்கும் உள்ள வித்தியாசத்தை எப்படிக் கண்டறிவது?

docker inspect n8n | grep -iE 'OOMKilled|ExitCode|RestartCount' கட்டளையை இயக்கி, OOMKilled flag-ஐப் பார்க்கவும். இதன் மதிப்பு True எனில், Docker ஒரு out of memory kill-ஐப் பதிவு செய்துள்ளது என்று அர்த்தம்; பாதிக்கப்பட்ட process-க்கு இறுதி log entry-ஐ எழுத வாய்ப்பு கிடைக்காது, இருப்பினும் முந்தைய container logs உதவக்கூடும். மதிப்பு False ஆக இருந்து, docker logs-ன் இறுதியில் fatal heap error இருந்தால், அது Node.js-ன் V8 heap தீர்ந்துவிட்டதைக் குறிக்கிறது. NODE_OPTIONS=--max-old-space-size=SIZE-ஐ உங்கள் container limit-க்குக் குறைவான MiB அளவில் அமைக்கவும், இது பிற memory பயன்பாட்டிற்கு இடமளிக்கும். இது V8 old space-ஐக் கட்டுப்படுத்தும், ஆனால் kernel OOM kill-க்கு முன்பே heap error ஏற்படும் என்பதற்கு உத்தரவாதம் அளிக்க முடியாது.

Execution தரவுகளை நீக்குவது disk இடத்தைப் உடனடியாக விடுவிக்குமா?

இல்லை. EXECUTIONS_DATA_PRUNE பழைய executions-ஐ நீக்குவதற்காகக் குறிக்கும், EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL-ல் அமைக்கப்பட்டுள்ள கால அட்டவணையின்படி பின்னர் ஒரு pass மூலம் அவை நீக்கப்படும். SQLite-ல், நீக்கப்பட்ட இடங்கள் மீண்டும் பயன்படுத்தப்படுமே தவிர, அவை உடனடியாக filesystem-க்குத் திரும்பாது; எனவே தரவுகள் நீக்கப்பட்ட பிறகும் disk-ல் கோப்பின் அளவு சிறிது காலத்திற்கு அப்படியே இருக்கும். EXECUTIONS_DATA_MAX_AGE மற்றும் EXECUTIONS_DATA_PRUNE_MAX_COUNT ஆகியவற்றை உங்கள் தேவைக்கேற்ப அமைத்துவிட்டு, உடனடியாகப் பார்க்காமல் அடுத்த நாள் சரிபார்க்கவும்.

n8n restart ஆகும்போது எனது scheduled workflow ஏன் இயங்கவில்லை?

n8n 2.45.0 முதல் இயல்பாகவே செயல்படுத்தப்பட்டுள்ள durable scheduler, வரவிருக்கும் runs-ஐ database-ல் சேமித்து வைக்கும். n8n அதன் grace period-க்குள் மீண்டும் இயங்கும்போது, பதிவு செய்யப்பட்ட runs தாமதமாகத் தொடங்கும். அந்த காலக்கெடுவைத் தாண்டிய பிறகு, trigger-ன் misfire policy, backlog-ஐத் தவிர்க்க வேண்டுமா அல்லது catch-up run செய்ய வேண்டுமா என்பதைத் தீர்மானிக்கும். உங்கள் பதிப்பு, scheduler configuration மற்றும் Schedule Trigger விருப்பங்களைச் சரிபார்க்கவும். பழைய in-memory scheduler-ஐப் பயன்படுத்தும் instances, downtime-ன் போது வர வேண்டிய runs-ஐத் தவிர்த்துவிடும்.

n8n பதிலளிக்காதபோது, healthcheck அதை restart செய்யுமா?

தானாகச் செய்யாது. ஒரு Compose healthcheck, container-ஐ healthy அல்லது unhealthy என்று மட்டுமே குறிக்கும். ஒரு restart policy, container வெளியேறும்போது மட்டுமே செயல்படும்; எனவே restart: unless-stopped, அது வேண்டுமென்றே நிறுத்தப்படாமல் Docker தொடங்கினால், வெளியேறிய பிறகும் host reboot-க்கு பிறகும் அதை மீண்டும் கொண்டு வரும். இதை sudo systemctl is-enabled docker மூலம் உறுதிப்படுத்தவும். Unhealthy நிலைக்கு ஏற்பச் செயல்பட, Docker-க்கு வெளியே status-ஐ வாசித்து service-ஐ restart செய்யும் ஒரு watcher தேவை.

இந்தக் கட்டுரை பயனுள்ளதாக இருந்ததா?