VPSలో n8n offline అవుతుందా? అసలు కారణం తెలుసుకోండి
n8n offlineగా కనిపించడానికి నాలుగు కారణాలు ఉన్నాయి: websocket banner, restart loop, out of memory kill లేదా dead schedule. ప్రతి దాన్ని వేరు చేసే విధానం తెలుసుకోండి.
n8n offline అవుతూనే ఉండటానికి కారణం: నాలుగు వైఫల్యాలు, ఒకే లక్షణం
"n8n keeps going offline" అనేది నాలుగు వేర్వేరు వైఫల్యాలను సూచించే ఒకే వాక్యం. ప్రతి వైఫల్యానికి వేర్వేరు పరిష్కారం అవసరం. Container సాధారణంగా నడుస్తున్నప్పటికీ editor లో connection lost banner కనిపించవచ్చు. Container స్వయంగా restart కావచ్చు. అధిక memory వినియోగం కారణంగా kernel Node.js process ను terminate చేయవచ్చు. లేదా process లో ఎలాంటి సమస్య లేకపోయినా active workflow అసలు trigger కాకపోవచ్చు. తప్పు setting ను మార్చితే, మీకు లేని సమస్యపై మొత్తం వారాంతాన్ని వెచ్చించాల్సి రావచ్చు.
కాబట్టి configuration ను మార్చే ముందు మీకు ఎదురైన వైఫల్యం ఏదో నిర్ధారించండి. n8n ప్రధాన Node.js process ను నడుపుతుంది. ఇది సాధారణంగా TLS (transport layer security) ను terminate చేసే reverse proxy వెనుక Docker container లో ఉంటుంది. Code nodes task runner processes ను కూడా ఉపయోగిస్తాయి. Internal mode child process ను ప్రారంభిస్తుంది. External mode వాటిని విడిగా, సాధారణంగా sidecar container లో, నడుపుతుంది. ఈ layers లో ప్రతి ఒక్కటి తనదైన విధంగా విఫలమవుతుంది. అయినప్పటికీ browser connection failures ను ఒకే message తో చూపిస్తుంది.
ఈ క్రమంలో నిర్ధారించండి
VPS (virtual private server) పై ఈ commands ను అమలు చేసి, మీ స్వంత machine చూపించే values ను పరిశీలించండి. Forum thread లోని numbers తో వాటిని పోల్చవద్దు. ఇక్కడ ముఖ్యమైన values మీ box ను వివరిస్తాయి, మరెవరైనా ఉపయోగించే machine ను కాదు.
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-streamdocker ps -a లోని STATUS column, container ప్రస్తుత state లో ఎంతకాలంగా ఉందో చూపిస్తుంది. మీ సమస్య ప్రారంభమైన సమయంతో దాన్ని పోల్చండి. Banner కనిపించడానికి చాలా ముందునుంచే container up లో ఉంటే, ఆ సమయంలో container restart కాలేదని చెప్పవచ్చు. అయితే n8n అందుబాటులోనే ఉందని అది నిరూపించదు. తరువాతి section లో వివరించే websocket path కు వెళ్లే ముందు reachability కోసం /healthz ను, connected మరియు migrated database కోసం /healthz/readiness ను పరిశీలించండి.
RestartCount Docker ఈ container ను ఎన్నిసార్లు restart చేసిందో చూపిస్తుంది. ఆ number ను రాసుకుని, ఒక నిమిషం వేచి, మళ్లీ చదవండి. మీరు పరిశీలిస్తున్నప్పుడు number పెరుగుతూ ఉంటే అది restart loop. ప్రతి restart కు కాస్త ముందు ఉన్న log lines కారణాన్ని చూపిస్తాయి.
OOMKilled true లేదా false flag. True అంటే container లో out of memory kill జరిగినట్లు Docker నమోదు చేసిందని అర్థం. ఏ process kill అయిందో, memory pressure container limit వల్ల వచ్చిందో లేదా మొత్తం machine వల్ల వచ్చిందో నిర్ధారించడానికి దీన్ని logs మరియు kernel messages తో కలిసి పరిశీలించండి.
ExitCode మీ container చివరిసారి exit అయినప్పుడు పొందిన value ను చూపిస్తుంది. ప్రతి code అర్థాన్ని కంఠస్థం చేసుకోవాల్సిన అవసరం లేదు. మీ value ను చదివి, అదే timestamp నుండి docker logs చివరిని కూడా చదవండి. Log tail మరియు out of memory flag ను కలిపి పరిశీలిస్తే ఏమి జరిగిందో తెలుస్తుంది. అయితే వాటిలో ఏదో ఒకదానినే పరిశీలిస్తే తప్పుదారి పట్టవచ్చు.
docker stats ప్రస్తుత memory use ను అమలులో ఉన్న limit పక్కన చూపిస్తుంది. దీన్ని రెండో terminal లో అమలులో ఉంచండి. సమస్య కలిగించే workflow ను trigger చేసి, failure జరుగుతున్నప్పుడు number ఎలా మారుతుందో పరిశీలించండి.
కనెక్షన్ కోల్పోయిన banner సాధారణంగా మీ reverse proxy వల్ల కనిపిస్తుంది
n8n editor backendకు ఒక దీర్ఘకాలిక push connectionను తెరిచి ఉంచుతుంది. అందువల్ల execution progressను canvasలో ప్రత్యక్షంగా చూపించగలదు. డిఫాల్ట్గా ఆ connection ఒక WebSocket. దీన్ని N8N_PUSH_BACKEND ఎంపిక చేస్తుంది. దాని డిఫాల్ట్ విలువ websocket. WebSocket మొదట Connection: Upgrade మరియు Upgrade: websocket headersను కలిగిన సాధారణ HTTP requestగా ప్రారంభమవుతుంది. Server 101 Switching Protocolsతో సమాధానం ఇస్తుంది. ఆ తర్వాత రెండు వైపులూ ఒకే TCP socketను రెండు దిశల్లో ఉపయోగిస్తాయి.
రెండు proxy సమస్యలు ఈ connectionను విరిగేలా చేస్తాయి. Proxy upstreamకు HTTP/1.0 ఉపయోగించడం లేదా upgrade headersను తొలగించడం వల్ల upgrade జరగదు. అప్పుడు editor నిరంతరం మళ్లీ connect అవుతూనే ఉంటుంది. మరొక సందర్భంలో upgrade విజయవంతమైనా, కొంతసేపు traffic లేకపోతే proxy socketను మూసివేస్తుంది. కారణం, messages లేని WebSocket idle connectionలాగే కనిపిస్తుంది. Authentication లేదా request-validation విఫలమైనప్పుడు n8n కూడా push connectionsను తిరస్కరిస్తుంది. ఇందులో pushRef లేకపోవడం లేదా invalid origin ఉండటం కూడా ఉన్నాయి. ఈ banner browser తన channelను కోల్పోయిందని చెబుతుంది. Container ఆరోగ్యంగా లేదని ఇది నిరూపించదు.
ఏదైనా మార్చే ముందు browserలో దీన్ని నిర్ధారించండి. Developer toolsను తెరిచి, Network tabకు వెళ్లి, WSకు filter చేసి editorను reload చేయండి. Push request 101 Switching Protocolsకు చేరుకుని openగా కొనసాగాలి. Push request సాధారణ status codeను return చేస్తే, లేదా ప్రతి కొన్ని సెకన్లకు మళ్లీ కనిపిస్తే, దాని responseను పరిశీలించాలి. Proxy, authentication లేదా origin errors కోసం n8n logsను కూడా తనిఖీ చేయాలి.
ఎడిటర్ కనెక్ట్ అయి ఉండేలా చేసే nginx సెట్టింగ్లు
nginx ను మీరు స్పష్టంగా అడగకపోతే అది upgrade ను forward చేయదు. Connection మరియు Upgrade hop-by-hop headers. nginx వీటిని request మార్గంలో తొలగిస్తుంది. అందువల్ల రెండింటినీ మళ్లీ జోడించాలి. upstream protocol మీ nginx release పై ఆధారపడి ఉంటుంది: 1.29.7 (March 2026) నుంచి proxy_pass backend తో default గా HTTP/1.1 ఉపయోగిస్తుంది. అంతకుముందు ఇది HTTP/1.0 ఉపయోగించేది. HTTP/1.0 upgrade ను అసలు తీసుకెళ్లలేదు. మీ వద్ద ఏది ఉందో చూడటానికి nginx -v అమలు చేయండి. దిగువ config లో proxy_http_version 1.1 ను స్పష్టంగా ఉంచారు. అందువల్ల ఇది రెండు సందర్భాల్లోనూ పనిచేస్తుంది. 1.29.7 లేదా తరువాతి version లో ఆ line default విలువనే మళ్లీ పేర్కొంటుంది. map block ను http context లో ఉంచాలి. దాన్ని server లోపల ఉంచకూడదు. దిగువ server block లోని మిగతా భాగం అర్థం కాకపోతే, nginx server block లోని ప్రతి line వివరణ ప్రతి 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 default గా 60 seconds ఉంటుంది. ఇది upgraded WebSocket కు కూడా వర్తిస్తుంది. backend నుంచి reads మధ్య గడిచిన సమయాన్ని ఇది కొలుస్తుంది. n8n ప్రతి 60 seconds కు push pings పంపుతుంది. అందువల్ల workflow instance ప్రశాంతంగా కనిపించినా socket లో traffic ఉండదని అర్థం కాదు. timeout ను పెంచితే default timeout తో పోటీ పడకుండా ఆ pings చేరేందుకు సమయం లభిస్తుంది. క్రమం తప్పకుండా వచ్చే ping frames కూడా timeout ను మళ్లీ ప్రారంభిస్తాయి.
sudo nginx -t && sudo systemctl reload nginx
sudo nginx -T | grep -iE 'proxy_http_version|upgrade|proxy_read_timeout'nginx -T running process ఇప్పటికే load చేసిన configuration ను పరిశీలించదు. దానికి బదులుగా included files తో సహా configuration files ను పరీక్షించి print చేస్తుంది. reload విజయవంతమైందో కూడా నిర్ధారించండి. సరైన fix పనిచేయనట్లు కనిపించడానికి కారణం, config file లో ఉన్న setting ను include line చదవకపోవడమే.
తర్వాత n8n కు అది proxy వెనుక ఉందని చెప్పాలి. ఎందుకంటే n8n ఈ విలువల ఆధారంగా URLs నిర్మిస్తుంది.
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 default గా 0 ఉంటుంది. అంటే n8n connecting address నే client address గా పరిగణిస్తుంది. X-Forwarded-For ను విస్మరిస్తుంది. container ముందు ఉన్న proxies సంఖ్యను దీనిలో సెట్ చేయండి. October 2026 నాటికి N8N_WEBHOOK_URL ప్రస్తుత పేరు. పాత WEBHOOK_URL కూడా ఇంకా పనిచేస్తుంది. అయితే startup సమయంలో deprecation warning చూపిస్తుంది.
Traefik WebSocketలను స్వయంచాలకంగా forward చేస్తుంది
Traefik middleware లేదా అదనపు labels లేకుండానే WebSocket upgrade ను forward చేస్తుంది. దాని HTTP timeoutల default విలువలు upgrade అయిన WebSocket కోసం timeout ను ఏర్పాటు చేయవు. దిగువ knobs entryPoint పై ఉంటాయి: October 2026 నాటికి Traefik v3లో, idleTimeout idle HTTP keep-alive connections కోసం defaultగా 180 seconds, readTimeout request మరియు దాని bodyని చదవడానికి defaultగా 60 seconds. Response write timeout protocol upgrades ను స్పష్టంగా మినహాయిస్తుంది. ఈ ఉదాహరణ HTTP timeoutలను మారుస్తుంది; ఇది WebSocket banner కోసం నిర్ధారిత పరిష్కారం కాదు.
entryPoints:
websecure:
address: ":443"
transport:
respondingTimeouts:
readTimeout: 0
idleTimeout: 3600sCaddy reverse_proxy లో upgrade ను స్వయంచాలకంగా నిర్వహిస్తుంది. దానికి ఎలాంటి directive అవసరం లేదు. Proxyని మీరు మార్చలేకపోతే, దాని నిర్వహణ మరొకరి వద్ద ఉన్నందున, push channelను N8N_PUSH_BACKEND=sse తో మార్చండి. SSE (server-sent events) అనేది తెరిచి ఉంచే సాధారణ HTTP response. అందువల్ల upgrades ను నిరాకరించే proxyలో కూడా అది కొనసాగుతుంది. అయితే చాలా తక్కువ idle timeout ఉంటే అది కూడా నిలిచిపోతుంది. Proxyని ఎంచుకోవడం ప్రత్యేక నిర్ణయం. nginx, Caddy మరియు Traefik పోలిక ప్రతి దానిని నిర్వహించడానికి మీకు అయ్యే ఖర్చును వివరిస్తుంది.
కంటైనర్ నిజంగా పునఃప్రారంభం అవుతున్నప్పుడు
RestartCount పెరుగుతుంటే, కంటైనర్ విఫలమవుతోంది మరియు Docker దాన్ని మళ్లీ ప్రారంభిస్తోంది. ప్రతి restart సమయానికి సంబంధించిన log timestamps ను సరిపోల్చి, దానికి వెంటనే ముందు ఏమి జరిగిందో పరిశీలించండి. సాధారణ కారణాల్లో startup ను ఆపివేసే configuration error, n8n చేరుకోలేని database, ప్రారంభమైన తర్వాత సంభవించే crash, అలాగే memory kill ఉన్నాయి.
ముందుగా volume ను పరిశీలించండి, ఎందుకంటే permissions సమస్య నిశ్శబ్దంగా ఉండవచ్చు. Official image privileged కాని user node గా నడుస్తుంది మరియు తన data ను /home/node/.n8n లో ఉంచుతుంది. Bind mount ఆ user కు writable గా లేకపోతే, తన data రాయడానికి ప్రయత్నించినప్పుడు 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/.n8nDocker named volume ను మొదటిసారి populate చేసినప్పుడు, అది image directory యొక్క ownership ను స్వీకరిస్తుంది. ఇప్పటికే ఉన్న volume కు permissions ను ఇంకా తనిఖీ చేయాలి. Bind mount అవసరమైతే, chown host directory ను id command చూపించిన numeric user id కు కేటాయించండి. Host మరియు container మధ్య ownership mapping ను ఒకసారి అర్థం చేసుకోవడం ఉపయోగకరం. ఈ images files ను ఎవరు రాస్తారో నిర్ణయించే విధానాన్ని PUID మరియు PGID వివరణ వివరిస్తుంది.
క్రాష్లా కనిపించే out-of-memory kill
n8n process పై రెండు వేర్వేరు memory ceilings ఉంటాయి. అవి వేర్వేరు విధాలుగా విఫలమవుతాయి. Container control group limit ను kernel అమలు చేస్తుంది. Usage ఆ పరిమితిని చేరుకుని తగ్గించలేకపోతే, kernel OOM killer ను ప్రారంభిస్తుంది. Usage తాత్కాలికంగా ఆ పరిమితిని మించవచ్చు. OOM kill జరిగినప్పుడు, ప్రభావితమైన process చివరి log entry రాయడానికి కూడా అవకాశం ఉండదు. Docker దాన్ని OOMKilled లో నమోదు చేస్తుంది. V8 heap limit ను Node.js అంతర్గతంగా అమలు చేస్తుంది. ఈ పరిమితి పూర్తిగా వినియోగిస్తే fatal heap error ఏర్పడి, kernel OOM kill లేకుండానే process నిష్క్రమిస్తుంది. Browser నుంచి ఈ రెండు పరిస్థితులు ఒకేలా కనిపిస్తాయి. వాటిని వేరు చేయడానికి logs తో పాటు docker inspect ను చదవండి.
Node heap ceiling ను container limit కంటే తక్కువగా సెట్ చేయండి. Native allocations, buffers, ఇతర heap regions మరియు container లోని ఇతర processes కోసం తగిన స్థలం మిగలాలి. అధిక heap ceiling వలన V8 తన పరిమితిని చేరకముందే kernel OOM kill జరిగే ప్రమాదం పెరుగుతుంది. అయితే అది తప్పనిసరిగా జరుగుతుందని అర్థం కాదు. Memory reclaim కావచ్చు లేదా swap ఉపయోగించబడవచ్చు. Workload ఏ పరిమితినీ పూర్తిగా వినియోగించకపోవచ్చు. తక్కువ heap ceiling ఉన్నా, 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 లోని numeric value తో, --max-old-space-size=SIZE రూపాన్ని ఉపయోగించి భర్తీ చేయండి. మీ VPS లో వాస్తవంగా ఉన్న memory ఆధారంగా రెండు సంఖ్యలను ఎంచుకోండి. Database, proxy మరియు operating system కోసం స్థలం మిగలాలి. అమలులో ఉన్న limit పక్కన ప్రస్తుత use ను docker stats --no-stream చూపిస్తుంది. అందువల్ల మీరు రాసిన limit నే Docker వర్తింపజేసిందో తనిఖీ చేయవచ్చు. Compose memory limits ఎలా వర్తిస్తాయి అనేక limits సెట్ చేసినప్పుడు ఏ key ప్రాధాన్యం పొందుతుందో వివరిస్తుంది.
మీ కింద పెరుగుతూనే ఉండే execution data
ఒక executionలో run కొనసాగుతున్నంతకాలం ప్రతి node output నిల్వ ఉంటుంది. తరువాత n8n తన execution saving settings ప్రకారం ఆ dataను భద్రపరుస్తుంది. దీనివల్ల రెండు విషయాలు జరుగుతాయి. Data పరిమాణం మరియు ప్రతి node చేసే పని peak memoryపై ప్రభావం చూపుతాయి. అందువల్ల ఒకేసారి పది వేల rowsను ప్రాసెస్ చేసే workflow, ఒకేసారి రెండు వందల rowsను ప్రాసెస్ చేసే అదే workflowతో సమానమైన program కాదు. అలాగే, ఏదైనా దాన్ని తొలగించే వరకు నిల్వ చేసిన copy పెరుగుతూనే ఉంటుంది.
Pruning రెండవ సమస్యను పరిష్కరిస్తుంది. October 2026 నాటికి defaults pruning enabled, EXECUTIONS_DATA_MAX_AGE 336 hours (14 days) వద్ద మరియు EXECUTIONS_DATA_PRUNE_MAX_COUNT 10000 వద్ద ఉన్నాయి. SQLite నడుస్తున్న చిన్న VPSకు ఇవి ఎక్కువ పరిమితులు. ఎందుకంటే మొత్తం data ఒకే fileలో ఉంటుంది. Editorను అందించే అదే process ఆ fileను read చేసి write చేయాలి.
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 అనేది aggressive setting. ఇది successful executionsను save చేయడాన్ని నిలిపివేస్తుంది. EXECUTIONS_DATA_SAVE_ON_ERROR దాని default అయిన all వద్ద ఉంటే failed executions భద్రపరచబడతాయి. Individual workflow settings ఈ ఎంపికలను override చేయవచ్చు. దీన్ని ఉద్దేశపూర్వకంగా నిర్ణయించండి. ఎందుకంటే error రాకపోయినా తప్పు output ఇచ్చిన workflowను పరిశీలించడానికి మీ వద్ద ఏ data లేకపోవచ్చు. Pruning ముందుగా rowsను deletedగా mark చేస్తుంది. తరువాతి passలో వాటిని తొలగిస్తుంది. SQLite ఖాళీ అయిన pagesను తిరిగి వినియోగిస్తుంది, కానీ వాటిని filesystemకు తిరిగి ఇవ్వదు. అందువల్ల setting మార్చిన వెంటనే diskలోని file పరిమాణం తగ్గదు.
నిల్వ చేసిన మొత్తం dataను కాకుండా peak memoryను తగ్గించాలంటే ప్రతి runలో తక్కువ dataను తరలించండి. పెద్ద jobsను parentకు చిన్న resultsను తిరిగి ఇచ్చే sub-workflowsగా విభజించండి. Loop Over Items nodeతో batch processing చేయండి. మొత్తం datasetsను Code nodeకు పంపకుండా ఉండండి.
బైనరీ ఫైళ్లు మెమరీ ద్వారా వెళ్లకూడదు
N8N_DEFAULT_BINARY_DATA_MODE డిఫాల్ట్గా default కు సెట్ అవుతుంది. ఇది బైనరీ డేటాను నడుస్తున్న execution యొక్క memoryలో ఉంచుతుంది. Workflow డౌన్లోడ్ చేసే ఫైళ్లు ఆ memory వినియోగాన్ని పెంచుతాయి. కొన్ని పెద్ద attachments ను పొందే ఒక workflow, సాధారణ JSON పనికి ఎప్పుడూ చేరని పరిమితిని process దాటేలా చేయవచ్చు. అందుకే crash సమయాన్ని అనుసరించకుండా ఒక నిర్దిష్ట workflow తర్వాత మాత్రమే కనిపిస్తుంది.
environment:
- N8N_DEFAULT_BINARY_DATA_MODE=filesystemfilesystem ఉపయోగించినప్పుడు, బైనరీ డేటా N8N_BINARY_DATA_STORAGE_PATH కింద రాయబడుతుంది. ఇది డిఫాల్ట్గా n8n user folder లో ఉంటుంది. అందువల్ల డేటా మిగతా వాటితో ఉన్న అదే volume పై నిల్వ అవుతుంది. మార్పు చేయడానికి ముందు volumeలో తగినంత స్థలం ఉందో తనిఖీ చేయండి. N8N_PAYLOAD_SIZE_MAX ద్వారా incoming webhook payload యొక్క గరిష్ఠ పరిమాణాన్ని MiB (mebibytes)లో సెట్ చేయవచ్చు. దీని డిఫాల్ట్ విలువ 16. దీన్ని పెంచితే పెద్ద requests అనుమతించబడతాయి. దానికి అవసరమైన అదనపు memoryని మీరు స్వీకరిస్తున్నారు.
ఆ సర్వర్లో నడుస్తున్న ఇతర సేవలన్నీ అదే RAM కోసం పోటీ పడతాయి. Database container జోడించిన తర్వాత OOM kills ప్రారంభమైతే, database ను Dockerలో లేదా hostపై నడపడం మీరు ఇప్పుడు తీసుకుంటున్న trade-off.
పునఃప్రారంభ విధానం మరియు reboot తర్వాత మళ్లీ ప్రారంభించడం
restart policy లేని container exit అయిన తర్వాత ఆగిపోయిన స్థితిలోనే ఉంటుంది. host reboot అయిన తర్వాత కూడా అదే పరిస్థితి ఉంటుంది. restart: unless-stopped ఈ రెండు సందర్భాల్లోనూ దాన్ని మళ్లీ ప్రారంభిస్తుంది. అయితే మీరు చేతితో ఆపిన 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 dockerhealthcheck ఒక్కటే ఉంటే ఏదీ మళ్లీ ప్రారంభం కాదు. Compose container ను unhealthy గా గుర్తించి అక్కడితో ఆగుతుంది. restart policy container exits పై పనిచేస్తుంది. Container unhealthy అయినందుకు ప్రత్యేకంగా దాన్ని మళ్లీ ప్రారంభించాలంటే external watcher అవసరం. రెండు అంశాల గురించి నిజంగా పనిచేసే healthcheck రాయడం మరియు reboot తర్వాత stack ను మళ్లీ ప్రారంభించడం చూడండి.
n8n సరిగ్గా పనిచేస్తున్నప్పటికీ workflow ఎప్పుడూ అమలు కాకపోవడం
ఇది ఎలాంటి banner ను చూపదు మరియు restart కూడా చేయదు. container నడుస్తూనే ఉంటుంది, editor పనిచేస్తుంది, కానీ మీరు ఆశించిన run executions జాబితాలో కనిపించదు. కింది నాలుగు విషయాలను పరిశీలించండి.
- workflow publish కాలేదు. Schedule Trigger ఉపయోగించి workflow ను save చేసి publish చేయండి. అప్పుడు దాని production schedule అమలవుతుంది.
- timezone మీది కాదు. workflow timezone సెట్ చేయకపోతే Schedule Trigger ముందుగా workflow timezone ను, తరువాత instance timezone ను ఉపయోగిస్తుంది.
GENERIC_TIMEZONEకు డిఫాల్ట్గాAmerica/New_Yorkఉంటుంది. workflow timezone ను సెట్ చేయండి లేదా instance default ను మీ timezone కు మార్చండి. - run కు కేటాయించిన grace period దాటిపోయింది. n8n 2.45.0 నుండి durable scheduler డిఫాల్ట్గా enable అయి ఉంటుంది మరియు రాబోయే runs ను database లో నమోదు చేస్తుంది. restart సమయంలో downtime తర్వాత grace period లోపల ఉంటే నమోదు చేసిన runs ఆలస్యంగా అమలవుతాయి. grace period దాటితే, configured misfire policy ఆ run ను skip చేయాలా లేదా catch-up run చేయాలా నిర్ణయిస్తుంది. పాత in-memory scheduler downtime సమయంలో అమలు కావాల్సిన runs ను skip చేస్తుంది.
- workflow మీకు తెలియకుండా deactivate అయింది.
N8N_WORKFLOW_AUTODEACTIVATION_ENABLEDడిఫాల్ట్గా off లో ఉంటుంది. ఇది on లో ఉండి workflow పదేపదే crash అయితే, ఆ workflow unpublished అవుతుంది. అందువల్ల ఇది ఎప్పుడూ activate చేయని workflow లాగే కనిపిస్తుంది.
Executions జాబితాను తెరిచి ఆ workflow కు filter చేయండి. విఫలమైన entry ఉంటే అది workflow సమస్య. అదే server లో మీరు host చేస్తున్న మరో service కు చేసిన అభ్యర్థనలో 429తో విఫలమైతే, ఆ limit n8nకు కాకుండా ఆ serviceకు సంబంధించినది. SearXNG 429 walkthrough ద్వారా దాని స్వంత rate limiter ను మీ server IP ను block చేస్తున్న engines నుంచి ఎలా వేరు చేయాలో తెలుసుకోవచ్చు. execution saving disabled గా ఉన్నప్పుడు లేదా pruning ఆ record ను తొలగించినప్పుడు కూడా ఎలాంటి entry కనిపించదు. అందువల్ల దీన్ని trigger సమస్యగా పరిగణించే ముందు ఆ settings ను పరిశీలించండి.
ముందుగా ఏం మార్చాలి
- ఏదైనా ఫైల్ను సవరించే ముందు మీ స్వంత container లో
STATUS,RestartCountమరియుOOMKilledచదవండి. - container అమలులోనే ఉంటే, n8n అందుబాటులో ఉందో మరియు database సిద్ధంగా ఉందో తనిఖీ చేయండి. తరువాత proxy, authentication, origin లేదా timeout errors కోసం push connection ను పరిశీలించండి.
OOMKilledtrue అయితే, మీరు ఉద్దేశపూర్వకంగా ఎంచుకున్న container limit ను సెట్ చేయండి. Node heap ceiling సెట్ చేసేటప్పుడు దాని కంటే తక్కువగా కొంత headroom ఉంచండి. తరువాత binary data నుfilesystemకు మార్చండి.- ఏదీ trigger కాలేకపోతే, workflow publish అయిందో, దాని effective timezone మీ timezone కాదో, అలాగే scheduler మరియు misfire settings మీ అంచనాలకు సరిపోతున్నాయో తనిఖీ చేయండి.
ఇవన్నీ పనిచేస్తున్న install పైన ఒక్కసారి సెట్ చేసి తరువాత మర్చిపోగలిగే configuration అంశాలే. మీరు ఇంకా ఆ install ను సిద్ధం చేస్తుంటే, HTTPSతో Dockerలో n8n అమలు చేసే మార్గదర్శకం ఈ settings కు ఆధారం.
FAQ
n8n container నడుస్తున్నప్పటికీ editor connection lost banner ఎందుకు చూపిస్తుంది?
Execution progress ను stream చేయడానికి editor ఒక WebSocket ను open గా ఉంచుతుంది. మీ reverse proxy Connection: Upgrade మరియు Upgrade: websocket headers ను forward చేయకపోతే, లేదా upstream కు HTTP/1.1 ఉపయోగించకపోతే, upgrade పూర్తికాదు. అప్పుడు n8n సక్రమంగా పనిచేస్తున్నప్పటికీ browser నిరంతరం reconnect అవుతుంది. nginx లో proxy_set_header lines రెండూ అవసరం. 1.29.7 కంటే పాత releases లో proxy_http_version 1.1 కూడా అవసరం. కొత్త releases లో HTTP/1.1 default గా ఉపయోగించబడుతుంది. Default 60 seconds కంటే proxy_read_timeout ను పెంచితే n8n యొక్క periodic pings చేరడానికి తగిన సమయం లభిస్తుంది. Workflow నిశ్శబ్దంగా ఉండటం వల్ల connection idle అవుతుందని అర్థం కాదు. Invalid push requests మరియు authentication failures ను n8n తిరస్కరిస్తుంది. అందువల్ల response మరియు application logs ను పరిశీలించండి. sudo nginx -T తో configuration files ను తనిఖీ చేసి, reload విజయవంతమైందో నిర్ధారించండి.
Out of memory kill ను సాధారణ crash నుంచి ఎలా గుర్తించాలి?
docker inspect n8n | grep -iE 'OOMKilled|ExitCode|RestartCount' ను run చేసి OOMKilled flag ను చదవండి. విలువ True అయితే Docker out of memory kill ను నమోదు చేసిందని అర్థం. ఆ process చివరి log entry రాయడానికి అవకాశం పొందదు. అయితే అంతకుముందు container logs సహాయపడవచ్చు. విలువ False గా ఉండి, docker logs చివరలో fatal heap error ఉంటే, Node.js తన V8 heap ను పూర్తిగా వినియోగించిందని సూచిస్తుంది. మీ container limit కంటే తక్కువగా ఉండే numeric size ను MiB లో ఉపయోగించి NODE_OPTIONS=--max-old-space-size=SIZE ను సెట్ చేయండి. దీనివల్ల V8 old space పరిమితం అవుతుంది. అయితే kernel OOM kill కంటే ముందే heap error వస్తుందని ఇది హామీ ఇవ్వదు.
Execution data ను prune చేస్తే disk space వెంటనే ఖాళీ అవుతుందా?
లేదు. EXECUTIONS_DATA_PRUNE పాత executions ను deletion కోసం గుర్తిస్తుంది. తరువాతి pass వాటిని తొలగిస్తుంది. ఈ pass EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL ద్వారా నిర్ణయించిన schedule ప్రకారం జరుగుతుంది. SQLite ఉపయోగించినప్పుడు file freed pages ను filesystem కు తిరిగి ఇవ్వకుండా మళ్లీ ఉపయోగిస్తుంది. అందువల్ల rows తొలగించిన తరువాత కొంతకాలం disk పై file size మారకుండా ఉంటుంది. మీ system కు సరిపోయే values తో EXECUTIONS_DATA_MAX_AGE మరియు EXECUTIONS_DATA_PRUNE_MAX_COUNT ను సెట్ చేయండి. వెంటనే కాకుండా మరుసటి రోజు మళ్లీ తనిఖీ చేయండి.
n8n restart అవుతున్న సమయంలో నా scheduled workflow ఎందుకు run కాలేదు?
n8n 2.45.0 నుంచి default గా enabled ఉన్న durable scheduler, upcoming runs ను database లో నిల్వ చేస్తుంది. n8n తన grace period లోపల తిరిగి వస్తే, నమోదు చేసిన runs ఆలస్యంగా ప్రారంభమవుతాయి. ఆ period దాటితే, trigger యొక్క misfire policy backlog ను skip చేయాలా లేదా catch-up run చేయాలా నిర్ణయిస్తుంది. మీ version, scheduler configuration మరియు Schedule Trigger options ను తనిఖీ చేయండి. పాత in-memory scheduler ఉపయోగించే instances downtime సమయంలో జరగాల్సిన runs ను skip చేస్తాయి.
Healthcheck స్పందించకుండా ఆగిపోయినప్పుడు n8n ను restart చేస్తుందా?
స్వయంగా చేయదు. Compose healthcheck container ను healthy లేదా unhealthy గా మాత్రమే గుర్తిస్తుంది. Restart policy container exit అయినప్పుడు పనిచేస్తుంది. అందువల్ల restart: unless-stopped, container exit అయిన తరువాత మరియు host reboot తరువాత దాన్ని తిరిగి ప్రారంభిస్తుంది, అయితే దాన్ని ఉద్దేశపూర్వకంగా stop చేయకపోయి, Docker ప్రారంభమై ఉండాలి. sudo systemctl is-enabled docker తో దీనిని నిర్ధారించండి. Unhealthy స్థితిపై ప్రత్యేకంగా చర్య తీసుకోవాలంటే, Docker వెలుపల status ను చదివి service ను restart చేసే watcher అవసరం.