Com os One-Click Apps, você instala aplicativos como Nextcloud, n8n, bancos de dados ou ferramentas de monitoramento do catálogo de apps no seu servidor dedicado e gerencia tudo diretamente no painel ZapX. Nos bastidores, o Coolify, uma plataforma de código aberto para aplicativos em contêineres, faz esse trabalho.
Diferentemente do VPS, você configura os aplicativos com um clique no servidor dedicado uma única vez: cria um comando no painel e o executa como root no servidor. O ZapX cuida do restante. Neste guia, você vai descobrir o que o servidor precisa para isso, como funciona a configuração, como gerenciar os aplicativos e o que o acesso de manutenção do ZapX faz no seu servidor.
O que seu servidor dedicado precisa ter: confira estes itens antes de executar o comando. O próprio comando verifica tudo e interrompe a execução sem fazer alterações se algum requisito não for atendido.
| Requisito | Mínimo |
|---|---|
| Sistema operacional | Debian ou Ubuntu com servidor SSH |
| RAM | 2 GB |
| CPU | 2 núcleos |
| Espaço livre | 30 GB |
| Endereço IP | Endereço IPv4 público configurado no servidor |
| Portas livres | 8000, 6001, 6002 e 8080 (seus apps precisam das portas 80 e 443) |
| SSH | A porta SSH do seu servidor precisa estar acessível ao ZapX |
Recomendamos um sistema operacional recém-instalado: o ideal é configurar os aplicativos com um clique em uma instalação limpa do Debian ou Ubuntu. Serviços que já ocupam portas, uma configuração própria do Docker ou uma instalação existente do Coolify com login próprio fazem a configuração ser interrompida. Para reinstalar, acesse a aba Instalação do seu servidor dedicado.
Host Proxmox e Windows: não é possível configurar os aplicativos com um clique diretamente no host Proxmox. Para isso, use uma VM no servidor que utilize um dos endereços IP do servidor. O Windows não é compatível.
Somente o titular do servidor pode configurar os aplicativos com um clique.
Abra seu servidor dedicado no painel ZapX e acesse a aba One-Click Apps. Lá, você verá o cartão Configurar One-Click Apps.
Escolha duas opções:
- Endereço IP do painel e dos apps: aqui aparecem os endereços IPv4 públicos do seu servidor; o endereço principal vem marcado. O painel Coolify e seus apps ficarão acessíveis por esse IP.
- E-mail do Admin para Coolify: você usará esse endereço de e-mail para entrar no painel Coolify.
Em seguida, clique em Criar comando. O ZapX prepara o endereço do seu painel, o que pode levar até um minuto.
Conecte-se ao servidor por SSH como root. Copie o comando exibido usando o ícone de cópia e execute-o. Ele começa com curl -fsSL e termina com | bash.
Se o curl não estiver instalado no servidor, instale-o antes com:
apt update && apt install -y curl
Depois disso, a instalação continuará em segundo plano. Você pode fechar o terminal.
Não compartilhe o comando: ele contém uma chave pessoal válida somente para esse servidor e por 24 horas. Não compartilhe essa chave. Se precisar de um novo comando, clique em Cancelar instalação manual e crie outro.
Na aba, você pode acompanhar o andamento da configuração:
| Status exibido | Significado |
|---|---|
| Estamos aguardando você executar o comando no servidor. | O comando ainda não foi iniciado |
| Conectado. A instalação está sendo executada no servidor. | O ZapX está instalando o Coolify; isso geralmente leva até 10 minutos |
| O Coolify foi instalado. Estamos conectando o painel. | Etapa final, leva cerca de um minuto |
Se, mesmo depois de alguns minutos, o ZapX não conseguir se conectar ao servidor por SSH, a aba mostrará um aviso. Nesse caso, verifique se o firewall permite conexões de entrada na porta SSH do servidor.
- Verifica o sistema operacional, os recursos, o endereço IP e as portas livres. Se algum requisito não for atendido, interrompe a execução e exibe uma mensagem.
- Cria o usuário
zapx-appscom permissões sudo. O ZapX usa esse usuário para gerenciar o Coolify e seus apps. O login só funciona com uma chave do ZapX e somente a partir de endereços do ZapX. Não é possível entrar com uma senha. - Instala o Coolify usando o instalador oficial, que também configura o Docker.
- Para fazer a configuração, o ZapX usa temporariamente uma chave root com permissões bastante limitadas e, se necessário, ajusta a configuração SSH. Os dois itens são removidos após a configuração.
- O comando não altera as regras do firewall.
Você encontra o registro da configuração no servidor em /var/lib/zapx-oneclick-apps/setup.log.
Quando a configuração estiver concluída, a aba One-Click Apps mostrará três seções:
| Seção | Conteúdo |
|---|---|
| Apps instalados | Seus apps, com status e ações disponíveis |
| Catálogo de apps | Todos os apps disponíveis para instalação |
| Acesso e configurações | Endereço do painel, login e acesso de manutenção |
- Abra o Catálogo de apps e procure o app desejado.
- Clique em Instalar.
- Na janela Instalar app, preencha os campos solicitados, por exemplo,
[dein_appname]ou[deine_domain]. - Clique em Colocar instalação em fila.
Se o servidor não tiver RAM suficiente para executar um app, você verá no catálogo o aviso “Seu servidor não tem RAM suficiente para este app”.
Ajuda do ZapX AI Agent: no ZapX AI Agent do seu servidor, você pode pedir sugestões de apps adequados, verificar o status dos seus apps ou preparar uma instalação. O agente só executa qualquer alteração depois da sua confirmação. Sempre gerencie as credenciais de acesso e os segredos na aba One-Click Apps.
Na seção Aplicações instaladas, você pode controlar cada app diretamente:
| Ação | Finalidade |
|---|---|
| Iniciar | Inicia um app parado |
| Parar | Para um app em execução |
| Reiniciar | Reinicia o app |
| Logs | Exibe os logs do app para ajudar a identificar problemas |
| Configurações | Altera variáveis de ambiente, domínio e outras opções do app |
O cartão Acesso de manutenção mostra se o ZapX consegue acessar seu servidor:
| Status | Significado |
|---|---|
| Ativo | O ZapX consegue acessar seu servidor e gerenciar o Coolify e seus apps |
| Interrompido | O ZapX não consegue mais acessar seu servidor, por exemplo, porque a chave de host SSH mudou ou a chave do ZapX não está mais sendo aceita |
| Removido | Você removeu o acesso de manutenção |
Ao clicar em Remover acesso, o ZapX apaga do servidor a própria chave, a regra sudo e o usuário zapx-apps. O Coolify e seus apps continuam funcionando, mas o ZapX não poderá mais gerenciá-los: instalar apps, solucionar problemas e fazer alterações no painel não será mais possível. Nesse caso, você gerenciará os apps diretamente no painel Coolify.
Se o servidor não estiver acessível quando você remover o acesso, o ZapX bloqueará o acesso do lado dele. Nesse caso, você poderá remover manualmente do servidor o usuário zapx-apps e o arquivo /etc/sudoers.d/zapx-apps.
Ao clicar em Restaurar acesso, você cria um novo comando que configura novamente somente o acesso de manutenção. O Coolify e seus apps não serão alterados. Execute o comando como root no servidor, da mesma forma que durante a configuração inicial.
| Evento | O que acontece |
|---|---|
| Reinstalação pela aba Instalação | A configuração é redefinida e os endereços em zap.cloud são excluídos. O sistema é instalado novamente; faça um backup dos dados dos apps antes disso. Depois, configure novamente os aplicativos com um clique. |
| Liberação do endereço IP do painel e dos apps | O acesso de manutenção é removido, os endereços em zap.cloud são excluídos e a configuração é redefinida. O Coolify e seus apps continuam funcionando no servidor. Para voltar a gerenciá-los pelo painel, configure novamente os aplicativos com um clique usando outro endereço IP. |
| Cancelamento ou fim do contrato | O acesso de manutenção e os endereços em zap.cloud são removidos. |
| Mensagem ou problema | Solução |
|---|---|
| Sem conexão SSH após alguns minutos | Verifique se o servidor SSH está em execução e se o firewall permite o acesso à porta SSH |
| As portas já estão ocupadas | Pare os serviços que usam as portas 8000, 6001, 6002 e 8080 ou reinstale o servidor |
| O Coolify já está instalado | O ZapX não assume o gerenciamento de uma instalação do Coolify com login próprio. Remova-a ou use um sistema limpo |
| O servidor SSH permite somente determinados usuários (AllowUsers) | Adicione zapx-apps à configuração SSH e execute o comando novamente |
| Há uma instalação em andamento no servidor | Aguarde até que a instalação na aba Instalação seja concluída |
| O servidor ainda não tem um endereço IPv4 público | Primeiro, configure um endereço IPv4 público para o servidor |
| Muitas tentativas | Aguarde alguns minutos e crie o comando novamente |
Você encontra mais detalhes sobre uma configuração com falha em /var/lib/zapx-oneclick-apps/setup.log. Se não conseguir resolver o problema, crie um chamado para o suporte e informe a mensagem de erro exibida na aba.
Fonte preferida no Google
