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 Anwendung | Beispiele |
|---|---|
| Website | Firmenwebsite, Blog, Portfolio |
| REST-API | Backend für eine Mobil- oder Web-App |
| Dashboard | Admin-Panel, Verwaltungsoberfläche |
| Web-App | E-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.jsusw.).
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.0lauschen (alle Schnittstellen), nicht auflocalhostoder127.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.
Melden Sie sich unter dash.ouipanel.com bei OuiPanel an und öffnen Sie Ihren Node.js-Server.
Klicken Sie im Seitenmenü auf Dateimanager.
Löschen Sie gegebenenfalls die Standarddateien.
Ziehen Sie
index.js,package.jsonund Ihre Ordner (public/,views/,routes/…) von Ihrem Computer auf die Seite.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.

Laden Sie Ihre Datei
.envnicht 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.
Klicken Sie im Dateimanager, im Stammverzeichnis, auf Datei erstellen.
Geben Sie im Fenster „Neue Datei erstellen“ unter Dateiname
.envein, mit dem Punkt am Anfang, und klicken Sie auf Datei erstellen.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_PORTbereit, den Port Ihres Servers. Nutzen Sie sie in Ihrem Code vorrangig, wie im Beispielindex.js.

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.
Öffnen Sie Konfiguration › Servereinstellungen.
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.
Tragen Sie in der Karte Umgebungsvariablen den Namen Ihrer Datei unter Hauptdatei ein (Hauptdatei; die Variablennamen erscheinen auf Französisch).
Klicken Sie auf das Häkchen rechts neben dem Feld (Speichern).
| Ihre Hauptdatei | Wert von Hauptdatei |
|---|---|
index.js | index.js |
app.js | app.js |
server.js | server.js |
src/index.js | src/index.js |

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
Notieren Sie den in der Konsole angezeigten Port, zum Beispiel
25639.Lesen Sie die IP-Adresse Ihres Servers unter Globale Ansicht in der Zeile Hauptadresse ab.
Öffnen Sie
http://IP:PORTim Browser, zum Beispielhttp://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
Klicken Sie im Seitenmenü auf Proxy-Manager.
Die Karte Das DNS-Ziel dieses Servers nennt den anzulegenden Eintrag: Typ
A, Name@und die IP-Adresse des Proxys als Wert.Legen Sie diesen Eintrag bei Ihrem Registrar (OVH, Cloudflare usw.) in der DNS-Zone der Domain an.
| Typ | Name | Wert |
|---|---|---|
A | @ oder app | Die IP-Adresse des Proxys |

Lassen Sie bei Cloudflare den Proxy ausgeschaltet (graues Symbol, DNS only). Sonst kann das HTTPS-Zertifikat nicht ausgestellt werden.
Die Domain verbinden
Klicken Sie im Proxy-Manager auf Domain hinzufügen. Das Formular Neue Verbindung öffnet sich.
Geben Sie unter Domainname
meineapp.deoderapp.beispiel.deein.Wählen Sie unter Port aus der Liste den Port, auf dem Ihre App lauscht.
Lassen Sie HTTPS auf Zertifikat angefordert.
Klicken Sie auf DNS prüfen. Zeigt das Panel „Das DNS zeigt hierher“, klicken Sie auf Weiterleitung anlegen.

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.
Klicken Sie im Seitenmenü auf Bereitstellung.
Füllen Sie im Block Repository verknüpfen die Felder Repository-Adresse und Branch aus.
Wählen Sie unter Zugriff auf das Repository Öffentliches Repository oder eine der beiden Optionen für private Repositorys (Deploy-Schlüssel oder Zugriffstoken).
Haken Sie Bei jedem Push auf den Branch bereitstellen an, wenn Sie automatische Updates möchten, und klicken Sie auf Speichern.
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.

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
| Fehler | Lö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. |
SyntaxError | Fehler in Ihrem JavaScript-Code. |
Die App startet, ist aber nicht erreichbar
| Ursache | Lösung |
|---|---|
Lauscht auf localhost | Wechseln Sie zu 0.0.0.0. |
| Falscher Port | Nutzen Sie process.env.SERVER_PORT. |
| Firewall | Der 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)
| Ursache | Lösung |
|---|---|
| App nicht gestartet | Starten Sie den Server in OuiPanel. |
| Falscher Port im Proxy-Manager | Prüfen Sie den Port der verbundenen Domain. |
| App abgestürzt | Sehen Sie in der Konsole nach. |
Die App stürzt beim Start ab
| Ursache | Lösung |
|---|---|
| Fehlende Umgebungsvariable | Prüfen Sie die Datei .env. |
| Syntaxfehler | Korrigieren Sie den Code. |
| Fehlendes Paket | Prü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
| Fehler | Lösung |
|---|---|
package.json not found | Prüfen Sie, ob die Datei im Stammverzeichnis liegt. |
ERESOLVE unable to resolve | Aktualisieren Sie die Versionen in package.json. |
Sicherheit und bewährte Vorgehensweisen
Die Datei .env schützen
| Empfohlen | Zu vermeiden |
|---|---|
.env auf dem Server anlegen | .env vom eigenen Computer hochladen |
.env in die .gitignore aufnehmen | .env auf GitHub committen |
| Geheimnisse über Variablen übergeben | API-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.
| Framework | Beschreibung |
|---|---|
| Express.js | Minimalistisches Framework, in dieser Anleitung verwendet |
| Fastify | Schnelle Alternative zu Express |
| Koa | Leichtes Framework vom Express-Team |
| NestJS | Strukturiertes TypeScript-Framework |
| Next.js | React-Framework mit serverseitigem Rendering |
| Nuxt.js | Vue.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.
Stellen Sie Ihre Node.js-Anwendungen mit unserem optimierten Hosting und dediziertem Support bereit.
Angebote ansehen →