Node-RED: node nejde nainstalovat kvůli „EBADENGINE“
Cíl: nainstalovat node do Node-RED, když instalace přes Manage palette spadne na EBADENGINE Unsupported engine, protože některá závislost hluboko ve stromu chce novější Node.js, než má image Node-RED.
Předpoklady: přístup do terminálu serveru (SSH nebo terminál v Umbrelu), cesta ke složce /data Node-RED na hostiteli. Uživatelská data včetně nainstalovaných nodů jsou v Dockeru v /data.1
Příznak
npm error code EBADENGINE
npm error notsup Not compatible with your version of node/npm: cookie@2.0.2
npm error notsup Required: {"node":">=22"}
npm error notsup Actual: {"npm":"10.9.9","node":"v20.20.2"}
Palette instaluje s volbou --engine-strict (je vidět v řádku příkazu na začátku logu instalace). S ní npm balíček s nesedícím polem engines odmítne, bez ní by to bylo jen varování.2
Proč se to děje
Samotný node Node.js 20 podporovat může. Stačí ale jedna nepřímá závislost, která chce Node 22. Ověřený případ node-red-contrib-shelly 11.12.32:
node-red-contrib-shelly (Node ≥ 20) → fastify 5.12 → light-my-request 6.8.x → cookie 2.0.2 (Node ≥ 22)
light-my-request 6.6.0 závisí na cookie 1.x a fastify bere jakoukoli ^6.0.0, takže starší verze mu stačí.2
Postup
- Najdi viníka. Z chyby vezmi balíček z řádku
Not compatible … <balíček>@<verze>a zjisti, kdo ho tahá a jaká starší verze rodiče Node 20 stačí (npm view <balíček>@<verze> engines,npm view <rodič>@<verze> dependencies). Jde to i v kontejneru Node-RED, npm v něm je:sudo docker exec -it <kontejner-node-red> sh -c "cd /tmp && npm view light-my-request@6.6.0 dependencies" - Otevři
package.jsonve složce/dataNode-RED (na Umbrelu~/umbrel/app-data/node-red-standalone/data/package.json):nano ~/umbrel/app-data/node-red-standalone/data/package.json - Přidej
overridesna nejvyšší úroveň souboru (čárkou odděl od sousedního pole).overridesnahradí verzi balíčku kdekoliv ve stromu závislostí.2 Pro Shelly:"overrides": { "light-my-request": "6.6.0" } - Nainstaluj node znovu přes Manage palette. Palette instaluje do
/data, takžeoverridesz tohotopackage.jsonpoužije.
Ověření
- Instalace v palette skončí
rc=0a node je v paletě. package.jsonmá node vdependenciesaoverrideszůstal.
Rollback
- Odinstaluj node v palette a smaž blok
overrideszpackage.json. - Až image Node-RED přejde na Node.js 22 (u oficiálních image tag končí
-22), pin smaž: Node-RED 5 stejně vyžaduje Node.js 22.9+.1
Troubleshooting
--engine-strict=false/ instalace ručně bez kontroly: nedoporučuju. Balíček, který chce Node 22, může na Node 20 za běhu selhat.cookie2 je navíc čisté ESM.2 Syntéza- Chyba
EJSONPARSEpři instalaci: rozbitýpackage.json, typicky chybějící nebo přebývající čárka kolem blokuoverrides. - Starší verze nejde: když starší verze závislosti s rodičem nesedí (rozsah verzí v jeho
dependencies), zkus místo toho starší verzi samotného nodu.
Souvislosti
Zdroje
- Node-RED Documentation + release notes ↗ —
/datav Dockeru, požadavek Node.js pro Node-RED 5. - npm Docs (package.json overrides, engine-strict) + metadata registru npm ↗ —
overrides,engine-strict, metadata balíčků v registru.
Intellihome