NodeJSVeröffentlicht am 15. Dezember 20259 Min. Lesezeit

Node.js-App (Express) mit eigener Domain und HTTPS bereitstellen

Diese Anleitung zeigt, wie Sie eine Node.js-Webanwendung (Website, REST-API, Dashboard…) auf einem Node.js-Server von OuiHeberg bereitstellen, den Sie in OuiPanel verwalten. Anschließend verbinden Sie sie mit dem Proxy-Manager über HTTPS mit Ihrer eigenen Domain. Das Beispiel nutzt Express. Sie brauchen eine funktionierende Node.js-App und, für eine eigene Adresse, einen Domainnamen.

Art der AnwendungBeispiele
WebsiteFirmenwebsite, Blog, Portfolio
REST-APIBackend für eine Mobil- oder Web-App
DashboardAdmin-Panel, Verwaltungsoberfläche
Web-AppE-Commerce, SaaS, Online-Tool

Die Dateien der Anwendung vorbereiten

Dateistruktur

Ihre Anwendung sollte diese Struktur haben.

MeineApp/
├── index.js           ← Hauptdatei (oder app.js, server.js...)
├── package.json       ← npm-Abhängigkeiten
├── .env               ← Umgebungsvariablen (auf dem Server erstellt)
├── public/            ← (Optional) Statische Dateien (CSS, JS, Bilder)
├── views/             ← (Optional) Vorlagen (EJS, Pug, Handlebars)
└── routes/            ← (Optional) Anwendungswege

Die Datei package.json

Legen Sie eine Datei package.json mit Ihren Abhängigkeiten an.

{
  "name": "meine-webanwendung",
  "version": "1.0.0",
  "description": "Meine Node.js-Webanwendung",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "express": "^4.18.2",
    "dotenv": "^16.3.1"
  }
}

Passen Sie "main": "index.js" an den Namen Ihrer Hauptdatei an (app.js, server.js usw.).

Die Hauptdatei (index.js)

Hier ein Beispiel einer Express-App, die für OuiPanel bereit ist. Sie lauscht auf dem Port, den der Server vorgibt: SERVER_PORT.

// Umgebungsvariablen aus .env laden
require('dotenv').config();

const express = require('express');
const app = express();

// Port: verwendet SERVER_PORT (OuiPanel) oder PORT (.env) oder standardmäßig 3000
const PORT = process.env.SERVER_PORT || process.env.PORT || 3000;

// Middleware zum Parsen von JSON
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

// Statische Dateien (CSS, JS, Bilder) bereitstellen
app.use(express.static('public'));

// Hauptweg
app.get('/', (req, res) => {
    res.send(`
        <!DOCTYPE html>
        <html lang="fr">
        <head>
            <meta charset="UTF-8">
            <meta name="viewport" content="width=device-width, initial-scale=1.0">
            <title>Meine Anwendung</title>
            <style>
                body { font-family: Arial, sans-serif; max-width: 800px; margin: 50px auto; padding: 20px; }
                h1 { color: #333; }
                .status { background: #d4edda; padding: 15px; border-radius: 5px; color: #155724; }
            </style>
        </head>
        <body>
            <h1>Meine Node.js-Anwendung</h1>
            <div>
                Die Anwendung funktioniert einwandfrei!
            </div>
            <p>Server gestartet auf Port ${PORT}</p>
        </body>
        </html>
    `);
});

// Beispiel-API-Weg
app.get('/api/status', (req, res) => {
    res.json({
        status: 'online',
        message: 'API funktioniert',
        timestamp: new Date().toISOString()
    });
});

// API-Weg mit Parameter
app.get('/api/hello/:name', (req, res) => {
    res.json({
        message: `Hallo ${req.params.name}!`
    });
});

// Server auf 0.0.0.0 starten (wichtig für OuiPanel)
app.listen(PORT, '0.0.0.0', () => {
    console.log(`Server gestartet auf http://0.0.0.0:${PORT}`);
    console.log(`${new Date().toLocaleString('fr-FR')}`);
});

Der Server muss auf 0.0.0.0 lauschen (alle Schnittstellen), nicht auf localhost oder 127.0.0.1. Sonst ist die App von außen nicht erreichbar.

Beispiel mit EJS-Templates

Wenn Sie EJS-Templates nutzen, fügen Sie ejs zu den Abhängigkeiten hinzu.

package.json:

{
  "name": "meine-webanwendung",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "express": "^4.18.2",
    "ejs": "^3.1.9",
    "dotenv": "^16.3.1"
  }
}

index.js:

require('dotenv').config();

const express = require('express');
const app = express();
const PORT = process.env.SERVER_PORT || process.env.PORT || 3000;

// EJS-Konfiguration
app.set('view engine', 'ejs');
app.set('views', './views');

// Statische Dateien
app.use(express.static('public'));

// Hauptweg
app.get('/', (req, res) => {
    res.render('index', { 
        title: 'Meine Anwendung',
        message: 'Willkommen auf meiner Website!'
    });
});

app.listen(PORT, '0.0.0.0', () => {
    console.log(`Server gestartet auf Port ${PORT}`);
});

views/index.ejs:

<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <title><%= title %></title>
</head>
<body>
    <h1><%= message %></h1>
</body>
</html>

Die Dateien zu OuiPanel hochladen

Der Dateimanager hat keine Upload-Schaltfläche. Dateien werden per Drag-and-drop gesendet.

  1. Melden Sie sich unter dash.ouipanel.com bei OuiPanel an und öffnen Sie Ihren Node.js-Server.

  2. Klicken Sie im Seitenmenü auf Dateimanager.

  3. Löschen Sie gegebenenfalls die Standarddateien.

  4. Ziehen Sie index.js, package.json und Ihre Ordner (public/, views/, routes/…) von Ihrem Computer auf die Seite.

  5. Sobald die Ebene „Dateien hier ablegen“ erscheint, lassen Sie los.

Jede so gesendete Datei ist auf 100 MB begrenzt. Laden Sie den Ordner node_modules nicht hoch, der Server installiert ihn selbst.

Ebene Dateien hier ablegen während eines Drag-and-drop im Dateimanager

Laden Sie Ihre Datei .env nicht hoch. Legen Sie sie direkt auf dem Server an, das ist sicherer.

Per SFTP

Für viele Dateien oder Dateien über 100 MB nutzen Sie SFTP. Verbinden Sie sich mit FileZilla, ziehen Sie den gesamten Inhalt Ihres App-Ordners hinüber und prüfen Sie, ob alles angekommen ist. Die Anleitung Per SFTP mit FileZilla verbinden erklärt die Verbindung.


Die Datei .env erstellen

Die Datei .env hält Ihre Umgebungsvariablen aus dem Code heraus.

  1. Klicken Sie im Dateimanager, im Stammverzeichnis, auf Datei erstellen.

  2. Geben Sie im Fenster „Neue Datei erstellen“ unter Dateiname .env ein, mit dem Punkt am Anfang, und klicken Sie auf Datei erstellen.

  3. Klicken Sie auf .env, um die Datei im Editor zu öffnen, tragen Sie Ihre Variablen ein und klicken Sie auf Speichern.

# Anwendungskonfiguration
PORT=3000
NODE_ENV=production

# Datenbank (falls erforderlich)
DATABASE_URL=mysql://user:password@host:3306/database

# API-Schlüssel (Beispiele)
API_KEY=your_api_key
SECRET_KEY=your_secret_key

OuiPanel stellt die Variable SERVER_PORT bereit, den Port Ihres Servers. Nutzen Sie sie in Ihrem Code vorrangig, wie im Beispiel index.js.

Dateimanager im Stammverzeichnis eines Node.js-Servers mit index.js, package.json und package-lock.json

So sieht die fertige Struktur auf dem Server aus.

Serverroot/
├── .env               ← Umgebungsvariablen
├── index.js           ← Ihr Code
├── package.json       ← Abhängigkeiten
├── public/            ← Statische Dateien
├── views/             ← Vorlagen
└── node_modules/      ← (automatisch erstellt)

Hauptdatei und Node.js-Version festlegen

OuiPanel muss wissen, welche Datei beim Start ausgeführt wird. Auf einem Node.js-Server ist das eine Servervariable.

  1. Öffnen Sie Konfiguration › Servereinstellungen.

  2. Wählen Sie in der Karte Serverstart die Systemversion. Die Liste bietet Node.js 12, 14 und alle Versionen von 16 bis 26. Empfohlen ist die LTS-Version 24.

  3. Tragen Sie in der Karte Umgebungsvariablen den Namen Ihrer Datei unter Hauptdatei ein (Hauptdatei; die Variablennamen erscheinen auf Französisch).

  4. Klicken Sie auf das Häkchen rechts neben dem Feld (Speichern).

Ihre HauptdateiWert von Hauptdatei
index.jsindex.js
app.jsapp.js
server.jsserver.js
src/index.jssrc/index.js

Einstellungen eines Node.js-Servers mit der Version Nodejs 24 und der Variable Hauptdatei

Der Name muss genau Ihrer Datei entsprechen, einschließlich Groß- und Kleinschreibung.


Die Anwendung starten und testen

Den Server starten

Klicken Sie im Seitenmenü auf Konsole und dann auf Starten. Beim Start installiert der Server die Abhängigkeiten aus package.json mit npm install und führt dann Ihre Datei aus.

> npm install
added 62 packages in 4s

> node index.js
Server läuft unter http://0.0.0.0:25639
15/12/2025 14:30:00

Die App im Browser öffnen

  1. Notieren Sie den in der Konsole angezeigten Port, zum Beispiel 25639.

  2. Lesen Sie die IP-Adresse Ihres Servers unter Globale Ansicht in der Zeile Hauptadresse ab.

  3. Öffnen Sie http://IP:PORT im Browser, zum Beispiel http://203.0.113.10:25639.

Für eine einfachere Adresse mit Domainnamen und HTTPS gehen Sie zum nächsten Abschnitt.


Eine Domain mit dem Proxy-Manager verbinden

Mit dem Proxy-Manager ist die App unter einer Adresse wie https://meineapp.de erreichbar. Sie brauchen eine eigene Domain und Zugriff auf deren DNS-Zone.

Den DNS-Eintrag anlegen

  1. Klicken Sie im Seitenmenü auf Proxy-Manager.

  2. Die Karte Das DNS-Ziel dieses Servers nennt den anzulegenden Eintrag: Typ A, Name @ und die IP-Adresse des Proxys als Wert.

  3. Legen Sie diesen Eintrag bei Ihrem Registrar (OVH, Cloudflare usw.) in der DNS-Zone der Domain an.

TypNameWert
A@ oder appDie IP-Adresse des Proxys

Seite Proxy-Manager mit der Karte Das DNS-Ziel dieses Servers

Lassen Sie bei Cloudflare den Proxy ausgeschaltet (graues Symbol, DNS only). Sonst kann das HTTPS-Zertifikat nicht ausgestellt werden.

Die Domain verbinden

  1. Klicken Sie im Proxy-Manager auf Domain hinzufügen. Das Formular Neue Verbindung öffnet sich.

  2. Geben Sie unter Domainname meineapp.de oder app.beispiel.de ein.

  3. Wählen Sie unter Port aus der Liste den Port, auf dem Ihre App lauscht.

  4. Lassen Sie HTTPS auf Zertifikat angefordert.

  5. Klicken Sie auf DNS prüfen. Zeigt das Panel „Das DNS zeigt hierher“, klicken Sie auf Weiterleitung anlegen.

Formular Neue Verbindung mit Domainname, Port und HTTPS

Die Domain erscheint unter Verbundene Domains. Ihre App antwortet unter https://meineapp.de, mit einem Let's-Encrypt-Zertifikat, das automatisch erneuert wird. Die Anleitung Eigene Domain mit dem Proxy-Manager auf den Server leiten beschreibt jeden Schritt und die Fehlermeldungen.


Aus einem Git-Repository bereitstellen

Ihr Code liegt auf GitHub, GitLab, Bitbucket oder Codeberg? Die Seite Bereitstellung holt das Repository und installiert die Abhängigkeiten für Sie, statt dass Sie Dateien von Hand hochladen.

  1. Klicken Sie im Seitenmenü auf Bereitstellung.

  2. Füllen Sie im Block Repository verknüpfen die Felder Repository-Adresse und Branch aus.

  3. Wählen Sie unter Zugriff auf das Repository Öffentliches Repository oder eine der beiden Optionen für private Repositorys (Deploy-Schlüssel oder Zugriffstoken).

  4. Haken Sie Bei jedem Push auf den Branch bereitstellen an, wenn Sie automatische Updates möchten, und klicken Sie auf Speichern.

  5. Klicken Sie auf Jetzt bereitstellen.

Jede Bereitstellung startet den Server neu, der während der Installation der Abhängigkeiten angehalten bleibt. Schlägt die Installation oder der Build fehl, startet die vorherige Version wieder. Nicht von Git verfolgte Dateien wie Ihre .env bleiben erhalten. Vor der ersten Bereitstellung erstellt das Panel ein Backup des Servers.

Seite Git-Bereitstellung mit Repository verknüpfen, Repository-Adresse, Branch und Zugriff auf das Repository

Eine Next.js- oder Nuxt-App muss vor dem Start gebaut werden. Tragen Sie unter Erweiterte Optionen den Build-Befehl (optional) ein, zum Beispiel npm run build.


Fehlerbehebung

Die App startet nicht

FehlerLösung
Cannot find module 'express'Prüfen Sie package.json und starten Sie neu.
Cannot find module 'dotenv'Fügen Sie dotenv zu package.json hinzu.
Error: Cannot find module './index.js'Falscher Wert in der Variable Hauptdatei.
SyntaxErrorFehler in Ihrem JavaScript-Code.

Die App startet, ist aber nicht erreichbar

UrsacheLösung
Lauscht auf localhostWechseln Sie zu 0.0.0.0.
Falscher PortNutzen Sie process.env.SERVER_PORT.
FirewallDer Port muss der von OuiPanel zugewiesene sein.

Prüfen Sie Ihren Code:

// FALSCH - nur lokal hören
app.listen(3000, 'localhost', () => {});
app.listen(3000, '127.0.0.1', () => {});

// RICHTIG - auf allen Schnittstellen hören
app.listen(PORT, '0.0.0.0', () => {});

Fehler 502 Bad Gateway (Proxy-Manager)

UrsacheLösung
App nicht gestartetStarten Sie den Server in OuiPanel.
Falscher Port im Proxy-ManagerPrüfen Sie den Port der verbundenen Domain.
App abgestürztSehen Sie in der Konsole nach.

Die App stürzt beim Start ab

UrsacheLösung
Fehlende UmgebungsvariablePrüfen Sie die Datei .env.
SyntaxfehlerKorrigieren Sie den Code.
Fehlendes PaketPrüfen Sie package.json.

Fügen Sie eine Fehlerbehandlung hinzu:

// Behandlung von unerfassten Fehlern
process.on('uncaughtException', (error) => {
    console.error('Unerfasster Fehler:', error);
});

process.on('unhandledRejection', (error) => {
    console.error('Abgelehntes Versprechen:', error);
});

npm install schlägt fehl

FehlerLösung
package.json not foundPrüfen Sie, ob die Datei im Stammverzeichnis liegt.
ERESOLVE unable to resolveAktualisieren Sie die Versionen in package.json.

Sicherheit und bewährte Vorgehensweisen

Die Datei .env schützen

EmpfohlenZu vermeiden
.env auf dem Server anlegen.env vom eigenen Computer hochladen
.env in die .gitignore aufnehmen.env auf GitHub committen
Geheimnisse über Variablen übergebenAPI-Schlüssel in den Code schreiben

Empfohlene .gitignore für Ihr Projekt:

# Umgebungsvariablen
.env
.env.local
.env.production

# Node-Module
node_modules/

Header absichern und Anfragen begrenzen

Die Pakete helmet und express-rate-limit schützen die HTTP-Header und begrenzen die Zahl der Anfragen pro IP-Adresse.

const helmet = require('helmet');  // HTTP-Sicherheit
const rateLimit = require('express-rate-limit');  // Schutz vor DDoS

// Hinzufügen in package.json: "helmet": "^7.1.0", "express-rate-limit": "^7.1.5"

app.use(helmet());

const limiter = rateLimit({
    windowMs: 15 * 60 * 1000, // 15 Minuten
    max: 100 // Maximal 100 Anfragen pro IP
});
app.use(limiter);

Leistung

  • Setzen Sie in der Produktion NODE_ENV=production.

  • Aktivieren Sie die Komprimierung mit dem Paket compression.

  • Cachen Sie statische Dateien.

const compression = require('compression');
app.use(compression());

// Cache für statische Dateien (1 Tag)
app.use(express.static('public', { maxAge: '1d' }));

Erweiterte Struktur

Für eine komplexere Anwendung:

MeineApp/
├── index.js              ← Einstiegspunkt
├── package.json
├── .env
├── config/
│   └── database.js       ← DB-Konfiguration
├── routes/
│   ├── index.js          ← Haupt-Routen
│   ├── api.js            ← API-Routen
│   └── auth.js           ← Authentifizierungs-Routen
├── controllers/
│   └── userController.js
├── models/
│   └── User.js
├── middleware/
│   └── auth.js
├── public/
│   ├── css/
│   ├── js/
│   └── images/
└── views/
    ├── index.ejs
    └── layout.ejs

Andere Frameworks

Für andere Node.js-Frameworks gilt dasselbe Prinzip: auf 0.0.0.0 lauschen, auf dem von OuiPanel bereitgestellten Port.

FrameworkBeschreibung
Express.jsMinimalistisches Framework, in dieser Anleitung verwendet
FastifySchnelle Alternative zu Express
KoaLeichtes Framework vom Express-Team
NestJSStrukturiertes TypeScript-Framework
Next.jsReact-Framework mit serverseitigem Rendering
Nuxt.jsVue.js-Framework mit serverseitigem Rendering

Brauchen Sie Hilfe?

Eröffnen Sie ein Ticket über Tickets › Ticket öffnen oder über die Kachel Support kontaktieren unten auf der Seite Ihres Servers im Kundenbereich. Sie können Ihre Frage auch auf dem Discord von OuiHeberg stellen.

War dieser Artikel hilfreich?

264 Aufrufe
Diesen Artikel teilen
Node.js
Node.js-Hosting benötigt?

Stellen Sie Ihre Node.js-Anwendungen mit unserem optimierten Hosting und dediziertem Support bereit.

Angebote ansehen →

Verwandte Artikel