Applies to: Hospedagem Node.js da GoDaddy

Hospedagem Node.js da GoDaddy Ajuda

We tried our best to translate this page for you. The English page is also available.

Carregar meu aplicativo gerado por IA para GoDaddy Node.js Hosting

Carregue e implante seu aplicativo gerado por IA no GoDaddy Node.js Hosting com um arquivo zipado.

Observação: Prefere usar o GitHub? Consulte nossos artigos de implantação para aplicativos Cusor e Claude ou Loveable .
  1. Se você ainda não o fez, acesse seu agente de codificação de IA (Cursor, Replit, Claude ou outros) e crie seu aplicativo.
  2. Acesse seu agente de codificação de IA (Cursor, Replit, Claude ou outros) e insira o prompt abaixo para seu aplicativo. Isso atualiza seu aplicativo para atender melhor aos requisitos de GoDaddy Node.js Hosting.
    Preciso que você adapte meu projeto Node.js para que ele possa ser implantado em uma plataforma de hospedagem que tenha os seguintes requisitos. Analise todos os requisitos, verifique se meu projeto já os atende e faça as alterações mínimas necessárias para que ele cumpra. NÃO remova nenhuma funcionalidade existente. ## Requisitos ### 1. package.json A raiz do projeto deve conter um `package.json` válido com pelo menos estes campos: -` "nome" `- o nome do aplicativo -` "versão" `- um semver string de versão (ex. "1.0.0") - `" main "` - o arquivo de ponto de entrada (ex. "server.js" ou "index.js") ### 2. Crie e inicie scripts `package.json` deve definir estes scripts npm: - `" build "` - compila / empacota o aplicativo (pode ser um no-op como `" echo build "` se nada precisa ser compilado) - `" start "` - inicia o servidor de produção (ex. `" node server.js "`) ### 3. Vinculação de porta O aplicativo deve escutar na porta fornecida pela variável de ambiente `PORT` em vez de uma porta embutida em código. Por exemplo: `` `js const port = process.env.PORT || 3000; app.listen (porta); `` `### 4. Dependências Todas as dependências de tempo de execução devem ser listadas em` dependências` em `package.json`. A pasta `node_modules` NÃO deve ser incluída no upload - a plataforma executa o` npm install` automaticamente. ### 5. Variáveis de ambiente Quaisquer segredos, chaves de API ou URLs externas devem ser lidos em `process.env.VARIABLE_NAME`. Não fixe valores confidenciais em código. ### 6. Aplicativos Vite (se aplicável) Se o projeto usar o Vite, a plataforma atualizará automaticamente a configuração de hosts permitidos. Nenhuma alteração manual é necessária para o Vite, mas certifique-se de que os servidores de desenvolvimento e visualização ainda respeitem o `process.env.PORT`. ### 7. Limite de tamanho do arquivo O zip resultante deve ficar abaixo de 100 MB. Certifique-se de que `node_modules`, caches de construção e outros diretórios grandes gerados sejam excluídos. ## O que fazer 1. Auditar o projeto em relação a todos os requisitos acima. 2. Aplique o menor conjunto de alterações que torne o projeto compatível. 3. Liste todas as alterações feitas e por quê.
  3. Se você planeja ter atualizações contínuas, baixe o CLAUDE.md e carregue o arquivo na pasta raiz do repositório do seu aplicativo.
    # CLAUDE.md - Hospedagem Node.js Este projeto foi criado para implantar na Hospedagem Node.js, uma plataforma de hospedagem Node.js gerenciada. Use esse arquivo como contexto ao ajudar a criar, depurar ou preparar este aplicativo para implantação. ## Visão geral da plataforma A hospedagem Node.js é uma PaaS Node.js gerenciada que oferece suporte a aplicativos Node.js e sites estáticos. Os clientes fazem o upload da pasta do projeto por meio da interface GoDaddy - sem Docker, sem pipelines de CI / CD, sem necessidade de configuração de infraestrutura. A plataforma lida com SSL, CDN e computação do lado do servidor automaticamente. ## Fluxo de implantação 1. O cliente carrega sua pasta de projeto por meio da IU de hospedagem Node.js 2. A plataforma instala dependências e cria o aplicativo 3. O aplicativo é implantado em um ambiente de visualização privado (requer autorização GoDaddy para visualizar) 4. Quando estiver pronto, , o cliente pode publicar para produção e conectar um domínio personalizado ## Requisitos ### package.json Cada projeto deve ter um `package.json` válido no diretório raiz com um script` start`. É assim que a plataforma sabe como executar o aplicativo. `` `json {" name ":" my-app "," version ":" 1.0.0 "," scripts ": {" start ":" node server.js "}," dependencies ": {" express " : "^ 4.18.0"}} `` `A plataforma executa` npm install` seguido por `npm start` para inicializar o aplicativo. ### Ponto de entrada O aplicativo precisa de um ponto de entrada claro referenciado pelo script `start`. Padrões comuns: - `node server.js` -` node index.js` - `node app.js` -` next start` (para aplicativos Next.js) ### Vinculação de porta O aplicativo deve escutar na porta fornecida por a variável de ambiente `PORT`. Não codifique uma porta. `` `javascript const port = process.env.PORT || 3000; app.listen (port, () = > {console.log (\ `Servidor em execução na porta \ ${port} \ `); }); `` `### Sites estáticos Para sites estáticos sem lógica do lado do servidor, inclua um servidor simples que serve os arquivos estáticos:` `` javascript const express = require ('express'); const path = require ('path'); const app = express (); const port = 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 (porta); `` `## Frameworks compatíveis A hospedagem Node.js suporta qualquer aplicativo ou framework Node.js que possa ser executado via` npm start`. Isso inclui, mas não se limita a: - Express.js - Next.js - Fastify - Nuxt.js - Remix - Nest.js - Hono - Koa - Sites estáticos atendidos por um servidor Node.js Se sua estrutura produz uma compilação de produção e pode ser iniciado por um script `" start "`, ele funcionará na hospedagem Node.js. ## Aplicativo único por upload A hospedagem Node.js espera um único aplicativo por upload. Não há suporte para configurações mono e multi-aplicativo, a menos que um único comando `npm start` na raiz inicialize tudo o que o aplicativo precisa. Se seu projeto for um monorepo, extraia o aplicativo específico que deseja implantar em sua própria pasta com seu próprio `package.json` e carregue essa pasta. Por exemplo, se seu repo tem uma estrutura como `packages / api` e` packages / web`, carregue apenas `packages / web` como um projeto independente com seu próprio script` package.json` e `start` completo. ## Estrutura do projeto A plataforma é flexível com estrutura. Contanto que a raiz contenha um `package.json` válido com um script` start`, o aplicativo será implementado. Uma estrutura típica se parece com: `` `my-app / ├── package.json # Obrigatório - deve incluir o script" start "├── server.js # Ponto de entrada (ou index.js, app.js, etc.) ├── public / # Recursos estáticos (se aplicável) │ ├── index.html │ ├── styles.css │ └── script.js ├── routes / # Rotas de API (se aplicável) ├── views / # Modelos (se aplicável) ├── .env.example # Documento necessário. Env vars (não carregar .env) └── CLAUDE.md # Este arquivo `` `## Environment Variables -` PORT` é fornecido automaticamente pelo plataforma. Sempre use `process.env.PORT`. - Quaisquer variáveis de ambiente adicionais necessárias para o aplicativo podem ser configuradas por meio da IU de hospedagem do Node.js após o upload. - Nunca envie arquivos secretos ou `.env` na pasta de upload. ## Com o que a plataforma lida Você não precisa configurar ou se preocupar com: - Certificados SSL / TLS - provisionados automaticamente - CDN - incluídos fora da caixa - Gerenciamento de processos - a plataforma gerencia reinicializações e tempo de atividade - Infraestrutura do servidor - computação totalmente gerenciada # # Implantação de agentes de codificação de IA Muitos clientes criam seus aplicativos usando agentes com tecnologia de IA, como Replit, Lovable, Bolt, Cursor ou Claude. Esses aplicativos podem ser implantados na Hospedagem Node.js, mas geralmente precisam de pequenos ajustes antes de estarem prontos. ### Como obter seu código na Hospedagem Node.js 1. Exporte ou baixe seu projeto como um zip do agente de IA 2. Descompacte a pasta localmente 3. Verifique e corrija os problemas comuns abaixo 4. Carregue a pasta pelo Node .js Hosting UI ### Problemas comuns e correções ** `package.json` ausente ou incompleto ** Alguns agentes de IA não geram um` package.json` completo. Certifique-se de que o seu exista na raiz e inclua um script `" start "`. Se estiver faltando, crie um: `` `json {" name ":" my-app "," version ":" 1.0.0 "," scripts ": {" start ":" node server.js "}," dependências ":{} } `` `Então execute o` npm install` localmente para gerar as dependências corretas. ** Portas codificadas ** Os agentes de IA geralmente codificam uma porta como `3000` ou` 8080`. Substitua qualquer porta codificada por `process.env.PORT`:` `` javascript // Before (comum em código gerado por IA) app.listen (3000); // Depois (pronto para hospedagem Node.js) app.listen (process.env.PORT || 3000); `` `** Dependências no lugar errado ** Os agentes de IA às vezes colocam dependências de produção em` "devDependências" `. Mova tudo o que o aplicativo precisa em tempo de execução para as `" dependências "`. ** Ponto de entrada ausente ** Certifique-se de que o arquivo referenciado no script `" start "` realmente exista. Os agentes de IA às vezes geram um `main.js`, mas o script inicial aponta para` index.js`, ou vice-versa. ** Arquivos específicos do Replit ** Os projetos do Replit geralmente incluem arquivos de configuração `.replit` e` replit.nix`. Eles não são necessários e podem ser removidos antes do upload. Concentre-se em ter um `package.json` limpo com o script` "start" correto. Exportações de ** Lovable / Bolt ** Esses agentes geralmente exportam aplicativos somente de front-end sem servidor. Se sua exportação não incluir um arquivo do servidor, adicione um arquivo simples para servir seus arquivos estáticos: `` `javascript const express = require ('express'); const path = require ('path'); const app = express (); const port = 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 (porta); `` `Certifique-se de adicionar` express` às suas dependências: `npm install express --save` ### Validação rápida Antes de fazer o upload, execute isso localmente para confirmar que tudo funciona:` `` bash npm install npm start `` `Se seu aplicativo é iniciado e está acessível em `http://localhost:3000 `(ou qualquer porta), está pronto para hospedagem Node.js. ## Exemplos de configuração do Framework ### Express.js Certifique-se de que `express` esteja em` dependencies` (não em `devDependencies`) e que o script` start` aponte para o arquivo do seu servidor. ### Next.js Use `next build` como um script de` build` e `next start` como o script` start`: `` `json {" scripts ": {" build ":" next build "," start " ":" next start "}}` `` Aplicativos Next.js funcionam imediatamente com renderização do lado do servidor, rotas de API e geração estática. ### Nuxt.js Semelhante ao Next.js - compilar e iniciar: `` `json {" scripts ": {" build ":" nuxt build "," start ":" node .output / server / index.mjs " }} `` `### Remix` `` json {"scripts": {"build": "remix build", "start": "remix-serve build"}} `` `### Fastify Mesmo padrão que Express - vincule a `process.env.PORT` e use` 0.0.0.0` como o 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 verificação de pré-upload antes fazendo upload para a hospedagem Node.js, verifique: - [] `package.json` existe no diretório raiz - []` package.json` tem um script `" start "` - [] Todas as dependências de produção estão em `" dependências " `(não` "devDependencies" `) - [] O aplicativo escuta em` process.env.PORT` - [] Sem portas, segredos ou caminhos de arquivos locais embutidos no código - [] O aplicativo é executado localmente com `npm install && npm start` - [] Se estiver usando uma etapa de compilação, o script `" build "` está definido em `package.json` ## Solução de problemas ### O aplicativo não inicia - Verifique se o script` "start" `existe no` package.json` - Certifique-se de que o arquivo de ponto de entrada referenciado em `" start "` realmente exista - Verifique se todas as dependências estão listadas em `" dependências "` ### Erros de porta - Nunca codifique um número de porta - sempre use `process.env.PORT` - Para estruturas que precisam de um host, vinculam-se a `0.0.0.0` e não a` localhost` ### Módulos ausentes - Certifique-se de que todos os pacotes necessários estejam em `" dependências "`, não `" devDependencies "` - A plataforma executa `npm install --production`, portanto, as dependências dev não são instaladas ### Falhas de compilação - Se o aplicativo precisar de uma etapa de compilação (TypeScript, Next.js, etc. .), adicione um script `" build "` - Verifique se os caminhos de saída da compilação correspondem ao que o script `" start "` espera ## Como obter ajuda Se você encontrar problemas de implantação, entre em contato com a interface de hospedagem Node.js ou a GoDaddy suporte.
  4. Baixe seu aplicativo do agente de codificação de IA para o computador.
  5. Compacte os arquivos do aplicativo no seu computador Windows ou Mac .
  6. Vá para GoDaddy Node.js Hosting , selecione Carregar ZIP , selecione Procurar arquivos , carregue seu arquivo zip, selecione Eu não sou um robô e, em seguida, selecione Implementar .
  7. Selecione o URL de visualização para visualizar seu aplicativo em um navegador.
  8. (Opcional) Gerencie seu aplicativo selecionando:
    • Carregar novo código : Adicionar mais arquivos de código
    • Configurações : gerencie segredos, altere seu domínio ou exclua seu aplicativo
    • Reiniciar o aplicativo de visualização : Reinicie sua visualização.
    • Registros de tempo de execução : Visualize os registros do seu aplicativo.
    • Gerenciador de arquivos : Visualize e edite os arquivos do seu aplicativo.
    • Banco de dados : Visualize e edite o banco de dados do seu aplicativo.
  9. (Opcional) Se você precisar de arquivos persistentes entre as implantações, faça com que seu aplicativo os grave na pasta public / assets.
  10. Quando estiver pronto para ir ao ar, selecione Publicar agora .

Para gerenciar seus projetos, vá para GoDaddy Node.js Hosting e, no canto superior direito, selecione Meus aplicativos .

Saiba mais