Eine Node.js-App bereitstellen (Express)

Um eine Node.js-App auf Lizard (lizard.build) zu hosten, stelle einen Ordner mit einer package.json bereit. lizardpack wählt den Paketmanager anhand deiner Lock-Datei, installiert die Abhängigkeiten, führt das build-Skript aus, falls es eines gibt, und startet die App mit dem start-Skript auf Port 3000. Es nutzt Node.js 22, sofern .nvmrc oder engines.node keine andere Hauptversion nennt. Lizard übergibt den Port in PORT; lausche auf diesem Port.

Teststatus: Das Express-Beispiel unten lief lokal mit Express 5.3.0, die Datenbank-Route mit pg 8.23.1 gegen PostgreSQL 14. Seinen Build-Plan haben wir mit lizardpack geprüft, dem Build-Planer, den Lizard ausführt. Mit dieser Anleitung haben wir es noch nicht vollständig bereitgestellt.

Bevor du beginnst

• Node.js und npm auf deinem Rechner, um die Lock-Datei zu erzeugen und lokal zu testen.
• Lizard CLI, angemeldet mit lizard login, auf Pro oder in der 7-tägigen Pro-Testphase (Karte erforderlich). Siehe Preise.

Für Next.js, Nuxt, Astro, SvelteKit und Vite gibt es eigene Anleitungen: siehe Framework-Anleitungen.

Eine minimale Express-App

package.json:

{
  "name": "express-app",
  "private": true,
  "type": "module",
  "scripts": {
    "start": "node server.js"
  },
  "engines": {
    "node": "22.x"
  },
  "dependencies": {
    "express": "^5.1.0"
  }
}

server.js:

import express from "express";
 
const app = express();
const port = Number(process.env.PORT) || 3000;
 
app.get("/", (req, res) => {
  res.send("Hello from Express on Lizard");
});
 
app.get("/healthz", (req, res) => {
  res.json({ status: "ok" });
});
 
app.listen(port, "0.0.0.0", () => {
  console.log(`listening on ${port}`);
});

Führe npm install aus, um package-lock.json zu erzeugen, committe beide Dateien und trage node_modules und .env in .gitignore ein. Lokal prüfen:

npm start
curl http://localhost:3000/healthz

Was lizardpack mit einer Node.js-App macht

Ohne build-Skript setzt das Image NODE_ENV=production, bevor es die Pakete installiert, sodass devDependencies fehlen. Ein Startskript, das nodemon, tsx oder ts-node aus den devDependencies aufruft, schlägt dann fehl. Kompiliere TypeScript in build und starte die Ausgabe:

{
  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js"
  }
}

Versionsdateien und ihre Sonderfälle stehen unter Laufzeitversionen. Lass Build- und Startbefehl des Service leer: Ist einer davon gesetzt, schreibt Lizard ein eigenes Dockerfile auf Basis von node:22-alpine und ignoriert deine Versionsdateien. Siehe die Build-Pipeline.

Bereitstellen

Im Stammverzeichnis der App:

lizard init --name node-app
lizard add --service web
lizard up --service web --port 3000

lizard up lädt den Ordner hoch, baut ihn auf Lizard und gibt die URL aus. Innerhalb eines Git-Repositorys überspringt es alles, was in .gitignore steht; außerhalb von Git überspringt es node_modules, lädt aber .env-Dateien hoch. Siehe Aus lokalem Code deployen.

Für git push to deploy pushe das Repository zu GitHub und verbinde es mit lizard add -r your-org/your-app -n web. Siehe Von GitHub deployen.

Variablen setzen

lizard secrets set SESSION_SECRET="$(openssl rand -hex 32)" --service web

Lies die Werte mit process.env.SESSION_SECRET. Eine Änderung an einer Variable startet den Service ohne neuen Build neu. Siehe Variablen und Secrets.

Managed Postgres hinzufügen

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_PRIVATE_URL}}' --service web
npm install pg

Die einfachen Anführungszeichen verhindern, dass deine Shell ${{…}} auswertet; Lizard löst die Referenz beim Deployment zur Adresse der Datenbank im privaten Netzwerk des Projekts auf. Füge server.js einen Pool und eine Route hinzu:

import pg from "pg";
 
const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
 
app.get("/db", async (req, res) => {
  const { rows } = await pool.query("SELECT now() AS now");
  res.json(rows[0]);
});

Express 5 reicht ein abgelehntes Promise aus einer Route an seinen Error-Handler weiter, sodass eine fehlgeschlagene Abfrage HTTP 500 zurückgibt, statt den Prozess abstürzen zu lassen. Führe Migrationen von deinem Rechner aus mit der öffentlichen URL der Datenbank aus:

lizard run --service postgres -- npm run migrate

Für einen Cache oder eine Job-Warteschlange füge Managed Redis auf dieselbe Weise hinzu: lizard add redis, dann REDIS_URL='${{redis.REDIS_PRIVATE_URL}}'.

Prüfen, ob es funktioniert

lizard logs --build --service web
lizard logs --service web --tail 100
lizard ps

Das Laufzeit-Log zeigt listening on 3000. Rufe /healthz und /db unter der URL auf, die lizard up ausgegeben hat.

Häufige Probleme

Ein Node.js-Prozess, der kein HTTP ausliefert, etwa ein Queue-Consumer oder ein Discord-Bot, läuft als Hintergrund-Worker.

Siehe auch

• Framework-Anleitungen
• Laufzeitversionen
• Managed Postgres
• Logs

Aktualisiert 12. Oktober 2026