Applies to: Hosting de GoDaddy Node.js

Hosting de GoDaddy Node.js Ayuda

Hicimos lo mejor que pudimos para traducir esta página para ti. La página en inglés también está disponible.

Cargar mi aplicación generada por IA a GoDaddy Node.js Hosting

Carga e implementa tu aplicación generada por IA en GoDaddy Node.js Hosting con un archivo zip.

Nota: ¿Prefieres usar GitHub? Consulta nuestros artículos de implementación para las aplicaciones Cusor y Claude o Loveable .
  1. Si aún no lo has hecho, ve a tu agente de codificación de IA (Cursor, Replit, Claude u otros) y crea tu aplicación.
  2. Ve a tu agente de codificación de IA (Cursor, Replit, Claude u otros) e ingresa el mensaje a continuación para tu aplicación. Esto actualiza tu aplicación para cumplir mejor con los requisitos de GoDaddy Node.js Hosting.
    Necesito que adaptes mi proyecto de Node.js para que pueda implementarse en una plataforma de hosting que tenga los siguientes requisitos. Revisa todos los requisitos, verifica si mi proyecto ya los satisface y haz los cambios mínimos necesarios para que así los cumpla. NO elimines ninguna funcionalidad existente. ## Requisitos ### 1. package.json La raíz del proyecto debe contener un `package.json` válido con al menos estos campos: -` "name" ` - el nombre de la aplicación -` "version" ` - un semver cadena de versión (p. ej., "1.0.0") - `" main "` - el archivo de punto de entrada (p. ej., "server.js" o "index.js") ### 2. Generar e iniciar scripts `package.json` debe definir estos scripts npm: - `" build "` - compila / agrupa la aplicación (puede ser una operación no operativa como `" echo build "` si no es necesario compilar) - `" start "` - inicia el servidor de producción (p. ej. `" node server.js "`) ### 3. Enlace de puerto La aplicación debe escuchar en el puerto proporcionado por la variable de entorno `PORT` en lugar de en un puerto codificado. Por ejemplo: `` `js const port = process.env.PORT || 3000; app.listen (puerto); `` `### 4. Dependencias Todas las dependencias en tiempo de ejecución deben listarse en` dependencies` en `package.json`. La carpeta `node_modules` NO debe estar incluida en la carga - la plataforma ejecuta` npm install` automáticamente. ### 5. Variables de entorno Cualquier secreto, clave API o URL externa debe leerse de `process.env.VARIABLE_NAME`. No codifique valores sensibles. ### 6. Aplicaciones de Vite (si corresponde) Si el proyecto usa Vite, la plataforma actualizará automáticamente la configuración de hosts permitidos. No se necesitan cambios manuales para Vite, pero asegúrate de que los servidores de desarrollo y vista previa aún respeten `process.env.PORT`. ### 7. Límite de tamaño de archivo El zip resultante debe permanecer por debajo de 100 MB. Asegúrate de que se excluyan los módulos `node_modules`, los cachés de compilación y otros directorios generados de gran tamaño. ## Qué hacer 1. Audita el proyecto según todos los requisitos anteriores. 2. Aplicar el conjunto de cambios más pequeño que haga que el proyecto sea compatible. 3. Haz una lista de cada cambio que hiciste y por qué.
  3. Si planeas tener actualizaciones continuas, descarga CLAUDE.md y carga el archivo en la carpeta raíz del repositorio de tu aplicación.
    # CLAUDE.md - Hosting de Node.js Este proyecto está diseñado para implementarse en Node.js Hosting, una plataforma de hosting administrada de Node.js. Usa este archivo como contexto para ayudar a crear, depurar o preparar esta aplicación para su implementación. ## Descripción general de la plataforma El hosting de Node.js es una PaaS de Node.js administrada que admite aplicaciones y sitios estáticos de Node.js. Los clientes cargan su carpeta de proyecto a través de la interfaz de GoDaddy: sin Docker, sin canalizaciones CI/CD, no se necesita configuración de infraestructura. La plataforma maneja SSL, CDN y la computación del lado del servidor automáticamente. ## Flujo de implementación 1. El cliente carga su carpeta de proyecto a través de la IU de hosting de Node.js 2. La plataforma instala las dependencias y compila la aplicación 3. La aplicación se implementa en un entorno de vista previa privado (requiere autorización de GoDaddy para verla) 4. Una vez lista , el cliente puede publicar en producción y conectar un dominio personalizado ## Requisitos ### package.json Cada proyecto debe tener un `package.json` válido en el directorio raíz con un script de` start`. Así es como la plataforma sabe cómo ejecutar la aplicación. `` `json {" name ":" my-app "," version ":" 1.0.0 "," scripts ": {" start ":" node server.js "}," dependencies ": {" express " : "^4.18.0"}} `` `La plataforma ejecuta` npm install` seguido de `npm start` para iniciar la aplicación. ### Punto de entrada La aplicación necesita un punto de entrada claro al que hace referencia el script "start". Patrones comunes: - `node server.js` -` node index.js` - `node app.js` -` next start` (para aplicaciones Next.js) ### Port Binding La aplicación debe escuchar en el puerto proporcionado por la variable de entorno "PORT". No codifiques un puerto. `` `puerto constante de javascript = process.env.PORT || 3000; app.listen (port, () = > {console.log (\ `Servidor ejecutándose en el puerto \ ${port} \ `); }); `` `### Sitios estáticos Para sitios estáticos sin lógica del lado del servidor, incluye un servidor simple que sirva los archivos estáticos:` `` javascript const express = require ('express'); const ruta = require ('ruta'); aplicación const = express (); puerto constante = process.env.PORT || 3000; app.use (express.static (path.join (__ dirname, 'public'))); app.get ('*', (req, res) = > {res.sendFile (path.join (__ dirname, 'public', 'index.html'));}); app.listen (puerto); `` `## Frameworks compatibles El hosting de Node.js es compatible con cualquier aplicación o marco de Node.js que pueda ejecutarse a través de` npm start`. Esto incluye pero no se limita a: - Express.js - Next.js - Fastify - Nuxt.js - Remix - Nest.js - Hono - Koa - Sitios estáticos servidos a través de un servidor Node.js Si tu marco produce una compilación de producción y puede comenzar a través de un script de inicio, funcionará en el hosting de Node.js. ## Aplicación única por carga Node.js Hosting espera una sola aplicación por carga. Las configuraciones de monorepos y múltiples aplicaciones no son compatibles a menos que un solo comando `npm start` en la raíz inicie todo lo que la aplicación necesita. Si tu proyecto es un monorepo, extrae la aplicación específica que deseas implementar en su propia carpeta con su propio `package.json` y carga esa carpeta en su lugar. Por ejemplo, si tu repositorio tiene una estructura como `packages/api` y` packages/web`, carga solo `packages/web` como un proyecto independiente con su propio` package.json` y un script `start` completo. ## Estructura del proyecto La plataforma es flexible con estructura. Siempre que la raíz contenga un `package.json` válido con un script de` start`, la aplicación se implementará. Una estructura típica se ve así: `` `my-app/ ├── package.json # Obligatorio-debe incluir el script" start "├── server.js # Punto de entrada (o index.js, app.js, etc.) ├── public/ # Activos estáticos (si corresponde) │ ├── index.html │ ├── styles.css │ └── script.js ├── route/ # API route (if pertinente) ├── views/ # Plantillas (si corresponde) ├── .env.example # Documento requerido env vars (no cargar .env) └── CLAUDE.md # Este archivo `` `## Variables de entorno -` PORT` es proporcionado automáticamente por el plataforma. Usa siempre `process.env.PORT`. - Cualquier variable de entorno adicional necesaria para la aplicación se puede configurar a través de la IU de hosting de Node.js después de la carga. - Nunca confirmes archivos secretos o `.env` en la carpeta de carga. ## Qué maneja la plataforma No necesitas configurar ni preocuparte por: - Certificados SSL/TLS - aprovisionados automáticamente - CDN - incluido de fábrica - Administración de procesos - la plataforma administra los reinicios y el tiempo de actividad - Infraestructura del servidor - Computación completamente administrada # # Implementación desde agentes de codificación de IA Muchos clientes crean sus aplicaciones utilizando agentes con tecnología de IA como Replit, Lovable, Bolt, Cursor o Claude. Estas aplicaciones se pueden implementar en Node.js Hosting, pero a menudo necesitan pequeños ajustes antes de que estén listas. ### Cómo obtener tu código en el hosting de Node.js 1. Exporta o descarga tu proyecto como un zip desde el agente de IA 2. Descomprime la carpeta localmente 3. Revisa y soluciona los problemas comunes a continuación 4. Carga la carpeta a través del Nodo .js Hosting UI ### Problemas comunes y soluciones ** `package.json` faltante o incompleto ** Algunos agentes de IA no generan un` package.json` completo. Asegúrate de que el tuyo exista en la raíz e incluya un script de "inicio". Si falta, crea uno: `` `json {" name ":" my-app "," version ":" 1.0.0 "," scripts ": {" start ":" node server.js "}," dependencias ":{} } `` `Luego ejecuta` npm install` localmente para generar las dependencias correctas. ** Puertos codificados de forma rígida ** Los agentes de IA suelen codificar de forma rígida un puerto como `3000` o` 8080`. Reemplaza cualquier puerto codificado con `process.env.PORT`:` `` javascript // Before (común en el código generado por AI) app.listen (3000); // Después (listo para Hosting de Node.js) app.listen (process.env.PORT || 3000); `` `** Dependencias en el lugar incorrecto ** Los agentes de IA a veces colocan las dependencias de producción en` "devDependencies" `. Mueve todo lo que la aplicación necesite en tiempo de ejecución a "dependencias". ** Falta un punto de entrada ** Asegúrate de que el archivo al que se hace referencia en tu script de inicio realmente exista. Los agentes de IA a veces generan un `main.js` pero el script de inicio apunta a` index.js`, o viceversa. ** Archivos específicos de Replit ** Los proyectos de Replit a menudo incluyen archivos de configuración `.replit` y` replit.nix`. Estos no son necesarios y se pueden eliminar antes de cargarlos. Concéntrate en tener un `package.json` limpio con el script` "start" `correcto. ** Exportaciones Lovable / Bolt ** Estos agentes a menudo exportan aplicaciones solo de frontend sin servidor. Si tu exportación no incluye un archivo de servidor, agrega uno simple para servir tus archivos estáticos: `` `javascript const express = require ('express'); const ruta = require ('ruta'); aplicación const = express (); puerto constante = process.env.PORT || 3000; app.use (express.static (path.join (__ dirname, 'dist'))); app.get ('*', (req, res) = > {res.sendFile (path.join (__ dirname, 'dist', 'index.html'));}); app.listen (puerto); `` `Asegúrate de agregar` express` a tus dependencias: `npm install express --save` ### Validación rápida Antes de cargar, ejecuta esto localmente para confirmar que todo funciona:` `` bash npm install npm start `` `Si tu aplicación se inicia y es accesible enhttp://localhost:3000 `(o cualquier puerto), está listo para Hosting Node.js. ## Ejemplos de configuración de framework ### Express.js Asegúrate de que `express` esté en` dependencies` (no en `devDependencies`) y que el script` start` apunte a tu archivo del servidor. ### Siguiente.js Usa `next build` como un script de` build` y `next start` como el script de` start`: `` `json {" scripts ": {" build ":" next build "," start ":" next start "}}` `` Las aplicaciones de Next.js funcionan desde el primer momento con renderizado del lado del servidor, rutas API y generación estática. ### Nuxt.js Similar a Next.js - compila y luego comienza: `` `json {" scripts ": {" build ":" nuxt build "," start ":" node .output/server/index.mjs " }} `` `### Remix` `` json {"scripts": {"build": "remix build", "start": "remix-serve build"}} `` `### Fastify Mismo patrón que Express: enlace a `process.env.PORT` y use` 0.0.0.0` como host: `` `javascript fastify.listen ({port: process.env.PORT || 3000, host: '0.0.0.0'} ); `` `### Nest.js` `` json {"scripts": {"build": "nest build", "start": "node dist/main"}} `` `## Lista de verificación previa a la carga Antes cargando a Node.js Hosting, verifica: - [] `package.json` existe en el directorio raíz - []` package.json` tiene un script `" start "` - [] Todas las dependencias de producción están en `" dependencies " `(not` "devDependencies" `) - [] La aplicación escucha en` process.env.PORT` - [] Sin puertos, secretos o rutas de archivos locales codificados - [] La aplicación se ejecuta localmente con `npm install && npm start` - [] Si usas un paso de compilación, el script `" build "` está definido en `package.json` ## Solución de problemas ### La aplicación no se inicia - Comprueba que el script` "start" `existe en` package.json` - Asegúrese de que el archivo de punto de entrada al que se hace referencia en `" start "` realmente exista - Verifique que todas las dependencias estén listadas en `" dependencies "` ### Errores de puerto - Nunca codifique un número de puerto - use siempre `process.env.PORT` - Para frameworks que necesitan un host, enlazar a `0.0.0.0` no a` localhost` ### Módulos faltantes - Asegúrate de que todos los paquetes requeridos estén en `" dependencies "`, not `" devDependencies "` - La plataforma ejecuta `npm install --production` por lo que las dependencias de desarrollo no se instalan ### Fallos de compilación - Si la aplicación necesita un paso de compilación (TypeScript, Next.js, etc. .), agrega un script `" build "` - Verifica que las rutas de salida de la compilación coincidan con lo que espera el script `" start "` ## Obtención de ayuda Si tienes problemas de implementación, comunícate a través de la interfaz de hosting de Node.js o comunícate con GoDaddy apoyo.
  4. Descarga tu aplicación desde tu agente de codificación de IA a tu computadora.
  5. Comprime los archivos de tu aplicación en tu computadora Windows o Mac .
  6. Ve a GoDaddy Node.js Hosting , selecciona Cargar ZIP , selecciona Buscar archivos , carga tu archivo zip, selecciona No soy un robot y luego selecciona Implementar .
  7. Selecciona tu URL de vista previa para ver tu aplicación en un navegador.
  8. (Opcional) Administra tu aplicación seleccionando:
    • Cargar nuevo código : agregar más archivos de código
    • Configuración : Administra secretos, cambia tu dominio o elimina tu aplicación
    • Reiniciar la aplicación de vista previa : Reinicia tu vista previa.
    • Registros de tiempo de ejecución : Ver los registros de tu aplicación.
    • Administrador de archivos : Ver y editar los archivos de tu aplicación.
    • Base de datos : Ver y editar la base de datos de tu aplicación.
  9. (Opcional) Si necesitas archivos persistentes entre implementaciones, haz que tu aplicación los escriba en la carpeta public/assets.
  10. Cuando estés listo para la publicación, selecciona Publicar ahora .

Para administrar tus proyectos, ve a GoDaddy Node.js Hosting y, en la parte superior derecha, selecciona Mis aplicaciones .

Más información