Applies to: Alojamento Node.js da GoDaddy

Alojamento Node.js da GoDaddy Ajuda

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

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

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

Nota: prefere usar o GitHub? Consulte os nossos artigos de implantação para aplicativos Cusor e Claude ou Loveable .
  1. Se ainda não o fez, aceda ao seu agente de codificação de IA (Cursor, Replit, Claude ou outros) e crie a sua aplicação.
  2. Aceda ao seu agente de codificação de IA (Cursor, Replit, Claude ou outros) e introduza a mensagem abaixo para a sua aplicação. Isto atualiza a sua aplicação para melhor cumprir os requisitos do Node.js Hosting da GoDaddy.
    Preciso que adapte o meu projeto Node.js para que possa ser implementado numa plataforma de alojamento que tenha os seguintes requisitos. Analise todos os requisitos, verifique se o meu projeto já os satisfaz e efetue as alterações mínimas necessárias para isso. 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: -` "name" `- o nome da aplicação -` "version" `- um semver string de versão (por exemplo, "1.0.0") - `" main "` - o ficheiro de ponto de entrada (por exemplo, "server.js" ou "index.js") ### 2. Criar e iniciar scripts `package.json` deve definir estes scripts npm: - `" build "` - compila / agrupa o aplicativo (pode ser um no-op como o `" echo build "` se nada precisar de compilação) - `" start "` - inicia o servidor de produção (por exemplo, `" node server.js "`) ### 3. Ligação de portas O aplicativo deve escutar na porta fornecida pela variável de ambiente `PORT` em vez de uma porta embutida no 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 sob` dependências` no `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 externos devem ser lidos a partir de `process.env.VARIABLE_NAME`. Não fixe valores sensíveis em código. ### 6. Aplicativos Vite (se aplicável) Se o projeto usar o Vite, a plataforma irá atualizar automaticamente a configuração dos anfitriões permitidos. Nenhuma alteração manual é necessária para o Vite, mas certifique-se de que os servidores de desenvolvimento e de pré-visualização ainda respeitam o `process.env.PORT`. ### 7. Limite de tamanho de arquivo O zip resultante deve ficar abaixo de 100 MB. Certifique-se de que `node_modules`, construir caches e outros diretórios grandes gerados são 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 porquê.
  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 - Alojamento Node.js Este projeto foi concebido para implementar no Alojamento Node.js, uma plataforma de alojamento Node.js gerida. Use este 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 suporta aplicativos Node.js e sites estáticos. Os clientes carregam a pasta do seu projeto através 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 implementação 1. O cliente carrega a sua pasta de projetos através da IU de alojamento Node.js 2. A plataforma instala as dependências e cria a aplicação 3. A aplicação é implementada num ambiente de pré-visualização privado (requer autorização da 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 a aplicação. `` `json {" name ":" my-app "," version ":" 1.0.0 "," scripts ": {" start ":" node server.js "}," dependencies ": {" express " : "^ 4.18.0"}} `` `A plataforma executa` npm install` seguido de `npm start` para inicializar a aplicação. ### 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) ### Port Binding 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 forneça 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 pode ser executado através do` npm start`. Isto inclui, mas não está limitado a: - Express.js - Next.js - Fastify - Nuxt.js - Remix - Nest.js - Hono - Koa - Sites estáticos servidos através de um servidor Node.js Se a sua estrutura produzir uma compilação de produção e pode iniciar através de um script `" start "`, irá funcionar no alojamento Node.js. ## Aplicativo único por upload A hospedagem do 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 o seu projeto for um monorepo, extraia o aplicativo específico que deseja implantar em sua própria pasta com o seu próprio `package.json` e carregue essa pasta. Por exemplo, se o seu repo tiver uma estrutura como `packages / api` e` packages / web`, carregue apenas `packages / web` como um projecto autónomo com o seu próprio script` package.json` e `start` completo. ## Estrutura do projeto A plataforma tem uma estrutura flexível. Contanto que a raiz contenha um `package.json` válido com um script` start`, o aplicativo será implementado. Uma estrutura típica é semelhante a: `` `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 / # percursos de API (se aplicável) ├── views / # Modelos (se aplicável) ├── .env.example # Document required env vars (não carregar .env) └── CLAUDE.md # Este ficheiro `` `## 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 submeta segredos ou ficheiros `.env` na pasta de carregamento. ## Qual é a capacidade da plataforma? Não precisa de configurar nem de se preocupar com: - Certificados SSL / TLS - fornecidos automaticamente - CDN - incluídos fora da caixa - Gestão de processos - a plataforma gere reinícios e disponibilidade - Infra-estrutura do servidor - computação totalmente gerida # # Implantar a partir 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 no Node.js Hosting, mas geralmente precisam de pequenos ajustes antes de estarem prontos. ### Como obter o seu código para o Alojamento Node.js 1. Exportar ou descarregar o seu projeto como um arquivo compactado do agente de IA 2. Descompactar a pasta localmente 3. Verifique e corrija os problemas comuns abaixo 4. Carregue a pasta através do Nó .js Hosting UI ### Problemas comuns e correções ** `package.json` incompleto ou ausente ** Alguns agentes de IA não geram um` package.json` completo. Certifique-se de que o seu existe na raiz e inclui um script `" start "`. Se estiver faltando, crie um: `` `json {" name ":" my-app "," version ":" 1.0.0 "," scripts ": {" start ":" node server.js "}," dependências ":{} } `` `Em seguida, 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 o Alojamento 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 `" dependências "`. ** Ponto de entrada ausente ** Certifique-se de que o arquivo mencionado no script `" start "` realmente existe. Os agentes de IA às vezes geram um `main.js`, mas o script de início aponta para` index.js`, ou vice-versa. ** Ficheiros específicos do Replit ** Os projectos do Replit incluem frequentemente ficheiros de configuração `.replit` e` replit.nix`. Estes não são necessários e podem ser removidos antes do carregamento. Concentre-se em ter um `package.json` limpo com o script` "start" `correto. ** Exportações Lovable / Bolt ** Esses agentes geralmente exportam aplicativos apenas de front-end sem nenhum servidor. Se a sua exportação não incluir um ficheiro do servidor, adicione um simples para servir os seus ficheiros 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 carregar, execute isto localmente para confirmar que tudo funciona:` `` bash npm install npm start `` `Se o seu aplicativo é iniciado e está acessível em `http://localhost:3000 `(ou qualquer porta), está pronto para o alojamento Node.js. ## Exemplos de configuração do framework ### Express.js Certifique-se de que `express` está em` dependencies` (não em `devDependencies`) e que o script` start` aponta para o seu arquivo do servidor. ### Next.js Use `next build` como um script de` build` e `next start` como o script de` start`: `` `json {" scripts ": {" build ":" next build "," start " ":" next start "}}` `` Os aplicativos Next.js funcionam imediatamente com renderização do lado do servidor, rotas de API e geração estática. ### Nuxt.js Semelhante a 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 anfitrião: `` `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é-carregamento antes carregar para o alojamento 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 arquivo locais codificados - [] O aplicativo é executado localmente com `npm install && npm start` - [] Se estiver usando um passo de compilação, o script `" build "` está definido em `package.json` ## Resolução de problemas ### O aplicativo não inicia - Verifique se o script` "start" `existe no` package.json` - Certifique-se de que o ficheiro de ponto de entrada referido em `" start "` existe realmente - Verifique se todas as dependências estão listadas em `" dependências "` ### Erros de porta - Nunca codifique um número de porta - utilize sempre `process.env.PORT` - Para estruturas que precisam de um anfitrião, associam-se a `0.0.0.0` e não a` localhost` ### Módulos em falta - Certifique-se de que todos os pacotes necessários estão incluídos `" dependencies "`, não `" devDependencies "` - A plataforma executa o `npm install --production`, portanto, as dependências dev não são instaladas ### Build Falhas - Se o aplicativo precisar de um passo 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 ## Obter ajuda Se tiver problemas na implementação, contacte a interface de alojamento Node.js ou contacte a GoDaddy suporte.
  4. Baixe o aplicativo do seu agente de codificação de IA para o computador.
  5. Compacte os ficheiros do seu aplicativo no seu computador com o Windows ou Mac .
  6. Aceda a GoDaddy Node.js Hosting , selecione Carregar ZIP , selecione Procurar ficheiros , carregue o seu ficheiro ZIP, selecione Não sou um robô e, em seguida, selecione Implementar .
  7. Selecione o URL de pré-visualização para visualizar o aplicativo em um navegador.
  8. (Opcional) Gerencie seu aplicativo selecionando:
    • Carregar novo código : Adicionar mais ficheiros de código
    • Definições : gerir segredos, alterar o seu domínio ou eliminar a sua aplicação
    • Reiniciar aplicativo de visualização : reinicie sua visualização.
    • Registos de tempo de execução : Visualize os registos de aplicações.
    • Gestor de ficheiros : visualize e edite os ficheiros do seu aplicativo.
    • Base de dados : visualize e edite a base de dados da sua aplicação.
  9. (Opcional) Se precisar de arquivos persistentes entre as implementações, faça com que o seu aplicativo os grave na pasta public / assets.
  10. Quando estiver pronto para ir ao ar, selecione Publicar agora .

Para gerir os seus projetos, aceda a GoDaddy Node.js Hosting e, no canto superior direito, selecione My Apps .

Mais informações