Español
English
Français
Português
🤖 O que você precisa
Para deixar o seu bot online 24/7 você precisa de um servidor do plano Node.js / Python: na contratação você escolhe Node.js ou Python, e ele é gerenciado pelo ZentexGame, o mesmo painel dos servidores de jogos. Serve para bots do Discord, APIs, scrapers ou qualquer aplicação que precise ficar sempre ligada. Você também vai precisar de:- O código do bot, com o arquivo principal: index.js no Node.js ou app.py no Python (ou o nome que você usa).
- A lista de dependências: package.json no Node.js ou requirements.txt no Python. O servidor instala tudo sozinho a cada inicialização.
- O token do bot, que você pega no portal de desenvolvedores do Discord. Ele é como uma senha: não deixe no código nem em um repositório público (passo 4).
Cannot find module '/home/container/index.js' no Node.js ou can't open file '/home/container/app.py' no Python. É normal: assim que você enviar os arquivos, ele inicia.⚙️ 1. As variáveis de Inicialização
Abra o seu servidor no ZentexGame e entre em Inicialização. Estas são as que importam:| Variável | Para que serve |
|---|---|
| Arquivo principal (Node.js) | O arquivo que inicia o bot; por padrão index.js. Se terminar em .ts, roda como TypeScript. |
| Arquivo .py principal (Python) | Por padrão app.py. |
| Arquivo de requisitos (Python) | Por padrão requirements.txt. É instalado a cada inicialização. |
| Pacotes Node adicionais / Pacotes Python adicionais | Pacotes avulsos instalados ao iniciar, separados por espaços. Não precisa se já estiverem no package.json ou no requirements.txt. |
| Endereço do repositório Git e Branch do Git | Para instalar o bot a partir do GitHub (passo 3). |
| Usuário do Git e Token de acesso do Git | Só para repositórios privados. |
| Atualizar ao iniciar | Se o bot veio do GitHub, baixa as últimas mudanças do repositório a cada inicialização. |
📤 2. Opção A: enviar o seu código
É o jeito mais direto:- Por SFTP, com FileZilla ou WinSCP: o mais prático se forem muitos arquivos. Veja como conectar por SFTP.
- Ou pela aba Arquivos do painel, enviando pelo navegador.
🔗 3. Opção B: instalar a partir do GitHub
Se o seu bot está em um repositório:- Em Inicialização, coloque a URL em Endereço do repositório Git (por exemplo, https://github.com/usuario/meu-bot) e, se não usar a branch padrão, o nome dela em Branch do Git.
- Vá em Configurações e clique em Reinstalar Servidor. O repositório só é baixado ao reinstalar: salvar a variável não basta.
- O download precisa da pasta vazia. Se você já tinha enviado arquivos à mão, apague-os antes de reinstalar; senão a instalação deixa tudo como está e não baixa nada.
- Com Atualizar ao iniciar ligado, cada inicialização traz as últimas mudanças do repositório. Só funciona se o bot veio do GitHub (se existir a pasta
.git).
🔑 4. O token fora do código
Guarde o token em um arquivo .env (ou em um config.json) que você não envia para o repositório (adicione ao.gitignore), e envie à parte por SFTP ou pela aba Arquivos. O seu bot lê o token ao iniciar, por exemplo com o pacote dotenv no Node.js ou python-dotenv no Python. Se você instalar a partir do GitHub, envie o .env depois de reinstalar, porque o download precisa da pasta vazia.▶️ 5. Iniciar e conferir
- Clique em Iniciar e acompanhe o Console: ali aparecem a instalação das dependências e as mensagens do seu bot.
- O painel marca o servidor como Em execução quando o console mostra uma linha com
Estoy listo!(no Node.js,readytambém vale). Se o seu bot não escrever isso, ele funciona do mesmo jeito, mas o painel continua mostrando Iniciando. - Se ele parar, o último erro do console diz o motivo: um arquivo principal com outro nome, uma dependência faltando ou um token inválido.
- Depois de mudar o código ou as variáveis, clique em Reiniciar.