NodeJSPublicado el 15 de diciembre de 2025Lectura de 10 min

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ónEjemplos
Sitio webWeb corporativa, blog, portfolio
API RESTBackend de una aplicación móvil o web
Panel de controlPanel de administración, interfaz de gestión
Aplicación webComercio 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 en localhost ni en 127.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.

  1. Inicia sesión en OuiPanel en dash.ouipanel.com y abre tu servidor Node.js.

  2. En el menú lateral, haz clic en Gestor de archivos.

  3. Borra los archivos por defecto, si los hay.

  4. Desde tu ordenador, arrastra a la página index.js, package.json y tus carpetas (public/, views/, routes/…).

  5. 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.

Capa Arrastra tus archivos aquí mostrada al arrastrar archivos en el Gestor de archivos

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.

  1. En el Gestor de archivos, en la Raíz, haz clic en Crear un archivo.

  2. En la ventana «Crear un nuevo archivo», escribe .env en Nombre del archivo, con el punto delante, y haz clic en Crear el archivo.

  3. Haz clic en .env para 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 ejemplo index.js.

Gestor de archivos en la raíz de un servidor Node.js con index.js, package.json y package-lock.json

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.

  1. Abre Configuración › Parámetros del servidor.

  2. 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.

  3. 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).

  4. Haz clic en la marca a la derecha del campo (Guardar).

Tu archivo principalValor de Archivo principal
index.jsindex.js
app.jsapp.js
server.jsserver.js
src/index.jssrc/index.js

Parámetros de un servidor Node.js con la versión Nodejs 24 y la variable Archivo principal

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

  1. Anota el puerto que aparece en la consola, por ejemplo 25639.

  2. Consulta la dirección IP de tu servidor en Vista Global, línea Dirección principal.

  3. Abre http://IP:PUERTO en tu navegador, por ejemplo http://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

  1. En el menú lateral, haz clic en Proxy Manager.

  2. 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.

  3. En tu registrador (OVH, Cloudflare, etc.), crea ese registro en la zona DNS del dominio.

TipoNombreValor
A@ o appLa dirección IP del proxy

Página Proxy Manager con la tarjeta El destino DNS de este servidor

En Cloudflare, deja el proxy desactivado (icono gris, DNS only). Si no, el certificado HTTPS no se puede emitir.

Conectar el dominio

  1. En el Proxy Manager, haz clic en Añadir un dominio. Se abre el formulario Nueva conexión.

  2. En Nombre de dominio, escribe miapp.com o app.ejemplo.com.

  3. En Puerto, elige en la lista el puerto en el que escucha tu aplicación.

  4. Deja HTTPS en Certificado solicitado.

  5. Haz clic en Comprobar el DNS. Cuando el panel muestre «El DNS apunta aquí», haz clic en Crear la redirección.

Formulario Nueva conexión con el nombre de dominio, el puerto y HTTPS

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.

  1. En el menú lateral, haz clic en Despliegue.

  2. En el bloque Vincular un repositorio, rellena Dirección del repositorio y Rama.

  3. En Acceso al repositorio, elige Repositorio público o una de las dos opciones de repositorio privado (clave de despliegue o token de acceso).

  4. Marca Desplegar en cada push a la rama si quieres actualizaciones automáticas y haz clic en Guardar.

  5. 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.

Página Despliegue Git con Vincular un repositorio, Dirección del repositorio, Rama y Acceso al repositorio

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

ErrorSolució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.
SyntaxErrorError en tu código JavaScript.

La aplicación arranca pero no es accesible

CausaSolución
Escucha en localhostCambia a 0.0.0.0.
Puerto incorrectoUsa process.env.SERVER_PORT.
CortafuegosEl 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)

CausaSolución
Aplicación no iniciadaInicia el servidor en OuiPanel.
Puerto incorrecto en el Proxy ManagerRevisa el puerto del dominio conectado.
Aplicación caídaConsulta la Consola.

La aplicación se cae al arrancar

CausaSolución
Falta una variable de entornoRevisa el archivo .env.
Error de sintaxisCorrige el código.
Falta un paqueteRevisa 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

ErrorSolución
package.json not foundComprueba que el archivo está en la raíz.
ERESOLVE unable to resolveActualiza las versiones en package.json.

Seguridad y buenas prácticas

Proteger el archivo .env

Haz estoEvita esto
Crear el .env en el servidorSubir el .env desde tu ordenador
Añadir .env al .gitignorePublicar el .env en GitHub
Pasar los secretos por variablesEscribir 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=production en 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.

FrameworkDescripción
Express.jsFramework minimalista, usado en esta guía
FastifyAlternativa rápida a Express
KoaFramework ligero del equipo de Express
NestJSFramework TypeScript estructurado
Next.jsFramework React con renderizado en el servidor
Nuxt.jsFramework 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.

¿Te ha sido útil este artículo?

264 vistas
Compartir este artículo
Node.js
¿Necesitas alojamiento Node.js?

Despliega tus aplicaciones Node.js con nuestro alojamiento optimizado y soporte dedicado.

Ver ofertas →

Artículos relacionados

¿No encontraste lo que buscabas?

El equipo de soporte responde 7 días a la semana.

Abrir un ticketDesde tu área de clienteDiscord de la comunidadAyuda y anunciosEstado de los serviciosstatus.ouiheberg.com