Desplegar una aplicación Node.js (Express) con dominio propio y HTTPS
Esta guía te explica cómo desplegar una aplicación web Node.js (sitio web, API REST, panel de control…) en un servidor Node.js de OuiHeberg que gestionas en OuiPanel. Después te muestra cómo conectarla a tu propio dominio con HTTPS mediante el Proxy Manager. El ejemplo usa Express. Necesitas una aplicación Node.js que funcione y, si quieres una dirección propia, un nombre de dominio.
| Tipo de aplicación | Ejemplos |
|---|---|
| Sitio web | Web corporativa, blog, portfolio |
| API REST | Backend de una aplicación móvil o web |
| Panel de control | Panel de administración, interfaz de gestión |
| Aplicación web | Comercio electrónico, SaaS, herramienta en línea |
Preparar los archivos de la aplicación
Estructura de archivos
Tu aplicación debe tener esta estructura.
MiApp/
├── index.js ← Archivo principal (o app.js, server.js...)
├── package.json ← Dependencias npm
├── .env ← Variables de entorno (creado en el servidor)
├── public/ ← (Opcional) Archivos estáticos (CSS, JS, imágenes)
├── views/ ← (Opcional) Plantillas (EJS, Pug, Handlebars)
└── routes/ ← (Opcional) Rutas de la aplicación
El archivo package.json
Crea un archivo package.json con tus dependencias.
{
"name": "mi-aplicacion-web",
"version": "1.0.0",
"description": "Mi aplicación web Node.js",
"main": "index.js",
"scripts": {
"start": "node index.js"
},
"dependencies": {
"express": "^4.18.2",
"dotenv": "^16.3.1"
}
}
Adapta
"main": "index.js"al nombre de tu archivo principal (app.js,server.js, etc.).
El archivo principal (index.js)
Este es un ejemplo de aplicación Express lista para OuiPanel. Escucha en el puerto que da el servidor, SERVER_PORT.
// Cargar las variables de entorno desde .env
require('dotenv').config();
const express = require('express');
const app = express();
// Puerto: utiliza SERVER_PORT (OuiPanel) o PORT (.env) o 3000 por defecto
const PORT = process.env.SERVER_PORT || process.env.PORT || 3000;
// Middleware para analizar JSON
app.use(express.json());
app.use(express.urlencoded({ extended: true }));
// Servir archivos estáticos (CSS, JS, imágenes)
app.use(express.static('public'));
// Ruta principal
app.get('/', (req, res) => {
res.send(`
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Mi Aplicación</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>Mi Aplicación Node.js</h1>
<div>
¡La aplicación funciona correctamente!
</div>
<p>Servidor iniciado en el puerto ${PORT}</p>
</body>
</html>
`);
});
// Ruta de ejemplo de API
app.get('/api/status', (req, res) => {
res.json({
status: 'online',
message: 'API funcional',
timestamp: new Date().toISOString()
});
});
// Ruta de API con parámetro
app.get('/api/hello/:name', (req, res) => {
res.json({
message: `¡Hola ${req.params.name}!`
});
});
// Iniciar el servidor en 0.0.0.0 (importante para OuiPanel)
app.listen(PORT, '0.0.0.0', () => {
console.log(`Servidor iniciado en http://0.0.0.0:${PORT}`);
console.log(`${new Date().toLocaleString('es-ES')}`);
});
El servidor debe escuchar en
0.0.0.0(todas las interfaces), no enlocalhostni en127.0.0.1. Si no, la aplicación no será accesible desde fuera.
Ejemplo con plantillas EJS
Si usas plantillas EJS, añade ejs a las dependencias.
package.json:
{
"name": "mi-aplicacion-web",
"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;
// Configuración EJS
app.set('view engine', 'ejs');
app.set('views', './views');
// Archivos estáticos
app.use(express.static('public'));
// Ruta principal
app.get('/', (req, res) => {
res.render('index', {
title: 'Mi Aplicación',
message: '¡Bienvenido a mi sitio!'
});
});
app.listen(PORT, '0.0.0.0', () => {
console.log(`Servidor iniciado en el puerto ${PORT}`);
});
views/index.ejs:
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title><%= title %></title>
</head>
<body>
<h1><%= message %></h1>
</body>
</html>
Subir los archivos a OuiPanel
El Gestor de archivos no tiene botón de subida. Los archivos se envían arrastrándolos y soltándolos.
Inicia sesión en OuiPanel en dash.ouipanel.com y abre tu servidor Node.js.
En el menú lateral, haz clic en Gestor de archivos.
Borra los archivos por defecto, si los hay.
Desde tu ordenador, arrastra a la página
index.js,package.jsony tus carpetas (public/,views/,routes/…).Cuando aparezca la capa «Arrastra tus archivos aquí», suelta.
Cada archivo enviado así está limitado a 100 MB. No subas la carpeta node_modules, el servidor la instala solo.

No subas tu archivo
.env. Créalo directamente en el servidor, es más seguro.
Por SFTP
Para muchos archivos, o archivos de más de 100 MB, usa el SFTP. Conéctate con FileZilla, arrastra todo el contenido de la carpeta de tu aplicación y comprueba que todo ha llegado. La guía FileZilla y SFTP: cómo conectarte a tu servidor de juego explica la conexión.
Crear el archivo .env
El archivo .env mantiene tus variables de entorno fuera del código.
En el Gestor de archivos, en la Raíz, haz clic en Crear un archivo.
En la ventana «Crear un nuevo archivo», escribe
.enven Nombre del archivo, con el punto delante, y haz clic en Crear el archivo.Haz clic en
.envpara abrirlo en el editor, añade tus variables y haz clic en Guardar.
# Configuración de la aplicación
PORT=3000
NODE_ENV=production
# Base de datos (si es necesario)
DATABASE_URL=mysql://user:password@host:3306/database
# Claves API (ejemplos)
API_KEY=your_api_key
SECRET_KEY=your_secret_key
OuiPanel proporciona la variable
SERVER_PORT, el puerto asignado a tu servidor. Úsala con prioridad en tu código, como en el ejemploindex.js.

Esta es la estructura final en el servidor.
Raíz del servidor/
├── .env ← Variables de entorno
├── index.js ← Su código
├── package.json ← Dependencias
├── public/ ← Archivos estáticos
├── views/ ← Plantillas
└── node_modules/ ← (creado automáticamente)
Elegir el archivo principal y la versión de Node.js
OuiPanel tiene que saber qué archivo lanzar al arrancar. En un servidor Node.js, este ajuste es una variable del servidor.
Abre Configuración › Parámetros del servidor.
En la tarjeta Lanzamiento del servidor, elige la Versión del sistema. La lista ofrece Node.js 12, 14 y todas las versiones de la 16 a la 26. La 24 es la versión LTS recomendada.
En la tarjeta Variables de entorno, escribe el nombre de tu archivo en Archivo principal (archivo principal; los nombres de las variables aparecen en francés).
Haz clic en la marca a la derecha del campo (Guardar).
| Tu archivo principal | Valor de Archivo principal |
|---|---|
index.js | index.js |
app.js | app.js |
server.js | server.js |
src/index.js | src/index.js |

El nombre debe coincidir exactamente con tu archivo, mayúsculas incluidas.
Arrancar y probar la aplicación
Iniciar el servidor
En el menú lateral, haz clic en Consola y luego en Iniciar. Al arrancar, el servidor instala las dependencias de package.json con npm install y después lanza tu archivo.
> npm install
added 62 packages in 4s
> node index.js
Servidor iniciado en http://0.0.0.0:25639
15/12/2025 14:30:00
Abrir la aplicación en el navegador
Anota el puerto que aparece en la consola, por ejemplo
25639.Consulta la dirección IP de tu servidor en Vista Global, línea Dirección principal.
Abre
http://IP:PUERTOen tu navegador, por ejemplohttp://203.0.113.10:25639.
Para una dirección más sencilla, con nombre de dominio y HTTPS, pasa a la siguiente sección.
Conectar un dominio con el Proxy Manager
El Proxy Manager hace accesible la aplicación en una dirección como https://miapp.com. Necesitas tu propio dominio y acceso a su zona DNS.
Crear el registro DNS
En el menú lateral, haz clic en Proxy Manager.
La tarjeta El destino DNS de este servidor indica el registro que hay que crear: Tipo
A, Nombre@y la IP del proxy como Valor.En tu registrador (OVH, Cloudflare, etc.), crea ese registro en la zona DNS del dominio.
| Tipo | Nombre | Valor |
|---|---|---|
A | @ o app | La dirección IP del proxy |

En Cloudflare, deja el proxy desactivado (icono gris, DNS only). Si no, el certificado HTTPS no se puede emitir.
Conectar el dominio
En el Proxy Manager, haz clic en Añadir un dominio. Se abre el formulario Nueva conexión.
En Nombre de dominio, escribe
miapp.comoapp.ejemplo.com.En Puerto, elige en la lista el puerto en el que escucha tu aplicación.
Deja HTTPS en Certificado solicitado.
Haz clic en Comprobar el DNS. Cuando el panel muestre «El DNS apunta aquí», haz clic en Crear la redirección.

El dominio aparece en Dominios conectados. Tu aplicación responde en https://miapp.com, con un certificado Let's Encrypt que se renueva automáticamente. La guía Cómo configurar un proxy inverso (Gestor de proxy) detalla cada paso y los mensajes de error.
Desplegar desde un repositorio Git
¿Tu código está en GitHub, GitLab, Bitbucket o Codeberg? La página Despliegue descarga el repositorio e instala las dependencias por ti, en lugar de subir los archivos a mano.
En el menú lateral, haz clic en Despliegue.
En el bloque Vincular un repositorio, rellena Dirección del repositorio y Rama.
En Acceso al repositorio, elige Repositorio público o una de las dos opciones de repositorio privado (clave de despliegue o token de acceso).
Marca Desplegar en cada push a la rama si quieres actualizaciones automáticas y haz clic en Guardar.
Haz clic en Desplegar ahora.
Cada despliegue reinicia el servidor, que queda detenido mientras se instalan las dependencias. Si la instalación o la compilación falla, vuelve a arrancar la versión anterior. Los archivos no seguidos por Git, como tu .env, se mantienen. Antes del primer despliegue, el panel hace una copia de seguridad del servidor.

Una aplicación Next.js o Nuxt debe compilarse antes de arrancar. En Opciones avanzadas, rellena el Comando de compilación (opcional), por ejemplo
npm run build.
Resolver un problema
La aplicación no arranca
| Error | Solución |
|---|---|
Cannot find module 'express' | Revisa package.json y reinicia. |
Cannot find module 'dotenv' | Añade dotenv a package.json. |
Error: Cannot find module './index.js' | Valor incorrecto en la variable Archivo principal. |
SyntaxError | Error en tu código JavaScript. |
La aplicación arranca pero no es accesible
| Causa | Solución |
|---|---|
Escucha en localhost | Cambia a 0.0.0.0. |
| Puerto incorrecto | Usa process.env.SERVER_PORT. |
| Cortafuegos | El puerto debe ser el asignado por OuiPanel. |
Revisa tu código:
// INCORRECTO - escucha solo en local
app.listen(3000, 'localhost', () => {});
app.listen(3000, '127.0.0.1', () => {});
// CORRECTO - escucha en todas las interfaces
app.listen(PORT, '0.0.0.0', () => {});
Error 502 Bad Gateway (Proxy Manager)
| Causa | Solución |
|---|---|
| Aplicación no iniciada | Inicia el servidor en OuiPanel. |
| Puerto incorrecto en el Proxy Manager | Revisa el puerto del dominio conectado. |
| Aplicación caída | Consulta la Consola. |
La aplicación se cae al arrancar
| Causa | Solución |
|---|---|
| Falta una variable de entorno | Revisa el archivo .env. |
| Error de sintaxis | Corrige el código. |
| Falta un paquete | Revisa package.json. |
Añade una gestión de errores:
// Gestionar errores no capturados
process.on('uncaughtException', (error) => {
console.error('Error no capturado:', error);
});
process.on('unhandledRejection', (error) => {
console.error('Promesa rechazada:', error);
});
npm install falla
| Error | Solución |
|---|---|
package.json not found | Comprueba que el archivo está en la raíz. |
ERESOLVE unable to resolve | Actualiza las versiones en package.json. |
Seguridad y buenas prácticas
Proteger el archivo .env
| Haz esto | Evita esto |
|---|---|
Crear el .env en el servidor | Subir el .env desde tu ordenador |
Añadir .env al .gitignore | Publicar el .env en GitHub |
| Pasar los secretos por variables | Escribir las claves API en el código |
Archivo .gitignore recomendado en tu proyecto:
# Variables de entorno
.env
.env.local
.env.production
# Módulos de Node
node_modules/
Proteger las cabeceras y limitar las peticiones
Los paquetes helmet y express-rate-limit protegen las cabeceras HTTP y limitan el número de peticiones por dirección IP.
const helmet = require('helmet'); // Seguridad HTTP
const rateLimit = require('express-rate-limit'); // Anti-DDoS
// Agregar en package.json: "helmet": "^7.1.0", "express-rate-limit": "^7.1.5"
app.use(helmet());
const limiter = rateLimit({
windowMs: 15 * 60 * 1000, // 15 minutos
max: 100 // 100 solicitudes máximas por IP
});
app.use(limiter);
Rendimiento
Usa
NODE_ENV=productionen producción.Activa la compresión con el paquete compression.
Guarda en caché los archivos estáticos.
const compression = require('compression');
app.use(compression());
// Caché de archivos estáticos (1 día)
app.use(express.static('public', { maxAge: '1d' }));
Estructura avanzada
Para una aplicación más compleja:
MiApp/
├── index.js ← Punto de entrada
├── package.json
├── .env
├── config/
│ └── database.js ← Configuración BD
├── routes/
│ ├── index.js ← Rutas principales
│ ├── api.js ← Rutas API
│ └── auth.js ← Rutas de autenticación
├── controllers/
│ └── userController.js
├── models/
│ └── User.js
├── middleware/
│ └── auth.js
├── public/
│ ├── css/
│ ├── js/
│ └── images/
└── views/
├── index.ejs
└── layout.ejs
Otros frameworks
El mismo principio vale para los demás frameworks Node.js: escuchar en 0.0.0.0, en el puerto que da OuiPanel.
| Framework | Descripción |
|---|---|
| Express.js | Framework minimalista, usado en esta guía |
| Fastify | Alternativa rápida a Express |
| Koa | Framework ligero del equipo de Express |
| NestJS | Framework TypeScript estructurado |
| Next.js | Framework React con renderizado en el servidor |
| Nuxt.js | Framework Vue.js con renderizado en el servidor |
¿Necesitas ayuda?
Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha de tu servidor en el área de cliente. También puedes preguntar en el Discord de OuiHeberg.
Despliega tus aplicaciones Node.js con nuestro alojamiento optimizado y soporte dedicado.
Ver ofertas →