VPS: Instalador de Apps com Um Clique
Os produtos ideais para este guia
Comece agora mesmo — peça o produto adequado e siga este guia passo a passo.
Introdução
O Instalador de Apps com Um Clique permite que você navegue por um catálogo extenso de apps e os implemente diretamente pela interface web do seu VPS. Neste guia, você vai aprender como preparar seu servidor, escolher o tipo de instalação correto, instalar e gerenciar apps, além de usar as configurações avançadas e ferramentas de solução de problemas quando necessário.
Preparação
Antes de usar o Instalador de Apps com Um Clique, seu VPS precisa atender aos requisitos mínimos e usar um sistema operacional suportado.
O recurso de apps exige que seu VPS esteja online e configurado com recursos suficientes para rodar tanto os serviços da plataforma quanto os apps instalados de forma confiável.
| Requisito | Mínimo | Recomendado |
|---|---|---|
| Status do servidor | Online | Online |
| Armazenamento | 30 GB | 50 GB |
| RAM | 2 GB | 4 GB |
| CPU | 2 núcleos | 4 núcleos |
| Sistema operacional | Debian ou Ubuntu LTS | Debian 13 - PT - 64bit |
É altamente recomendado configurar o recurso de apps em uma instalação limpa do sistema operacional. Isso ajuda a evitar conflitos com serviços existentes, portas ocupadas, configurações Docker ou customizações já presentes no servidor.
Se precisar reinstalar seu VPS antes de continuar, use uma imagem limpa suportada do Debian ou Ubuntu LTS pelo painel de gerenciamento do VPS.
Acessando o Instalador de Apps com Um Clique
Abra seu VPS na interface web da ZAP-Hosting e localize a seção One Click Apps. A partir daí, você pode iniciar a configuração inicial e depois voltar para gerenciar todos os apps instalados no servidor.
Na primeira vez que abrir esse recurso, você precisará escolher como a plataforma deve ser instalada no seu VPS.
Escolhendo o Tipo de Instalação
Você pode escolher entre uma instalação completa ou uma instalação apenas como nó. A opção correta depende se este VPS deve hospedar tanto o painel de gerenciamento quanto os apps, ou apenas atuar como um nó vinculado a outro painel.
Instalação Completa
Escolha Instalação Completa se quiser configurar o servidor com o painel e o próprio servidor como nó. Essa é a opção recomendada para usuários iniciantes e para a maioria das implantações padrão.
Com esse método, você pode:
- implementar apps do catálogo
- gerenciar projetos e ambientes
- organizar todos os apps em um só lugar
- usar as ferramentas integradas de gerenciamento pela interface web
- acessar o painel avançado depois, se precisar
Se esta é sua primeira vez usando o recurso de apps, selecione a opção de instalação completa. Ela oferece a configuração mais simples e dá controle total direto pela interface web da ZAP-Hosting.
Instalação Apenas como Nó
Escolha Instalação Apenas como Nó se quiser que este VPS atue só como um nó. Você poderá vinculá-lo a outro servidor VPS ou a uma instância externa de painel.
Essa opção é útil se você quiser:
- escalar entre vários sistemas VPS
- centralizar o gerenciamento em um painel só
- vincular este servidor a uma implantação já existente
- expandir uma configuração multi-nó já em uso
A instalação apenas como nó é destinada a usuários que já têm outra instância de painel disponível ou que querem conectar este servidor a um ambiente externo.
Instalando o Recurso de Apps
Depois de escolher o tipo de instalação, inicie a configuração pela interface web. A instalação inicial geralmente leva apenas alguns minutos.
Durante esse processo, os serviços da plataforma necessários para o recurso One Click Apps são implantados no seu VPS. Quando concluído, o catálogo de apps e as seções de gerenciamento ficam disponíveis na interface web.
Os detalhes exatos do progresso da instalação podem variar dependendo do desempenho do VPS, estado do sistema operacional e condições da rede. Se a configuração não for concluída com sucesso, confira a seção de solução de problemas mais abaixo neste guia.
Navegando pelo Catálogo de Apps
Quando a instalação terminar, você pode abrir o catálogo de apps e navegar pelas opções disponíveis. O catálogo contém mais de 300 apps prontos para deploy e suporta filtros para ajudar a encontrar o app certo rapidinho.
Buscando e Filtrando Apps
No catálogo, você pode buscar apps pelo nome e filtrar por categoria. Isso ajuda a reduzir as opções disponíveis na interface estilo loja de apps e encontrar o alvo certo para seu projeto.
Ações típicas incluem:
- buscar pelo nome do app
- filtrar por categoria
- revisar as entradas disponíveis
- selecionar um app para instalar
Esse fluxo é especialmente útil se você gerencia muitos apps ou compara vários serviços antes de instalar.
Iniciando a Instalação de um App
Depois de escolher um app no catálogo, comece a instalação pela interface web. Dependendo do app, pode ser necessário definir valores como:
[your_project_name][your_environment_name][your_domain][your_app_name]
Esses placeholders representam valores específicos da sua implantação. Por exemplo, [your_domain] deve ser substituído pelo domínio que você quer usar para o app.
Use projetos e ambientes para manter sua implantação organizada. Isso é especialmente útil quando você hospeda vários apps, testa versões ou separa serviços de produção e staging.
Gerenciando Apps Instalados
Depois do deploy, seus apps instalados aparecem na seção de gerenciamento da interface web. De lá, você pode monitorar e controlar seus serviços sem precisar mexer manualmente nos containers.
Ações de Gerenciamento Disponíveis
A seção de apps instalados permite realizar ações comuns do ciclo de vida direto pela interface web.
| Ação | Propósito |
|---|---|
| Iniciar | Inicia um app parado |
| Parar | Para um app em execução |
| Ver logs | Abre os logs do app para solução de problemas |
| Reinstalar | Reimplanta o app |
Essas ferramentas facilitam gerenciar todos os apps num só lugar, especialmente se você quer controle simples via web em vez de administração manual por linha de comando.
Organizando Projetos e Ambientes
Projetos e ambientes ajudam a estruturar suas implantações de forma clara. Você pode usá-los para separar:
- apps pessoais e de produção
- ambientes de teste e produção
- múltiplos clientes ou equipes
- diferentes stacks no mesmo VPS
Essa organização fica cada vez mais importante conforme sua coleção de apps cresce e você gerencia mais serviços em um ou vários nós.
Domínios, Acesso Cloud e SSL
O recurso One Click Apps suporta domínios personalizados e integração com o ZAP Cloud. Isso permite expor apps de forma segura e provisionar certificados SSL para suas implantações.
Você pode usar domínios personalizados para seus apps e aproveitar o provisionamento de certificados SSL onde suportado pela configuração da plataforma.
Ao atribuir um domínio, certifique-se que seus registros DNS apontem para [your_server_ip]. Se o domínio não estiver configurado corretamente, o app pode não ficar acessível pela internet.
| Valor | Descrição |
|---|---|
[your_domain] | O domínio ou subdomínio atribuído ao seu app |
[your_server_ip] | O endereço IP público do seu VPS |
Se o DNS de [your_domain] não apontar para [your_server_ip], a validação do domínio e o acesso ao app podem falhar.
Usando Configurações Avançadas
Usuários avançados podem acessar funcionalidades extras pelo painel externo disponível na seção de configurações avançadas.
Isso pode ser útil se você precisar de personalização mais profunda, controle expandido de deploy ou acesso direto a recursos além da interface web padrão.
Limitação Importante de Suporte
Usuários avançados são bem-vindos para usar o painel externo Coolify para personalizações e funcionalidades extras. Porém, o suporte é limitado à interface web da ZAP-Hosting. Se fizer alterações fora da interface web, o suporte pode não estar disponível para essas customizações.
Quando Usar o Painel Avançado
Você pode querer usar o painel avançado se precisar de:
- personalização detalhada do deploy
- fluxos diretos de vinculação de nós
- configuração avançada de apps
- gerenciamento no nível do painel além da interface simplificada
Se perder acesso ou a integração parar de responder, use as ferramentas de solução de problemas descritas abaixo antes de fazer mudanças manuais.
Vinculando Nós
Se escolheu a instalação apenas como nó, pode vincular este VPS a outro servidor VPS ou a uma instância externa de painel. Isso permite escalar sua infraestrutura e gerenciar múltiplos nós de um único lugar.
A vinculação de nós é útil quando você quer:
- distribuir apps entre vários sistemas VPS
- centralizar o gerenciamento
- expandir capacidade sem criar implantações isoladas
- conectar a um ambiente externo de painel
Você pode vincular seu nó a outro VPS ou a uma instância externa de painel. Os detalhes exatos da vinculação dependem do ambiente alvo já em uso.
Solução de Problemas de Status Degradado
Se a interface web mostrar um status degradado, significa que a plataforma não consegue contatar ou obter dados da instância que roda o recurso One Click Apps. Siga os passos de solução de problemas na ordem.
Indicadores de Status
O popup de solução de problemas pode mostrar indicadores como:
| Status | Significado |
|---|---|
| Status Coolify: Ativo | O serviço do painel parece estar rodando |
| Status API: Acessível | A API está acessível no momento |
| Status Serviço: Online | Seu VPS está online |
Se uma ou mais partes não estiverem funcionando direito, continue com os passos abaixo.
Passo 1: Confirme que o VPS Está Online
Primeiro, confirme que seu VPS está online na interface web da ZAP-Hosting. Se o servidor estiver offline, a plataforma de apps não funciona.
Passo 2: Atualize o Status
Use a ação Atualizar Status para rodar a checagem de saúde novamente com dados atualizados. Isso pode resolver problemas temporários e intermitentes.
Um estado degradado pode ser causado por uma falha rápida na comunicação. Atualizar o status é o primeiro passo mais rápido.
Passo 3: Reinicie o Docker
Se o status continuar degradado, use a ação Reiniciar Docker. Isso força a reinicialização da instância da plataforma. Após resposta bem-sucedida, espere 1-2 minutos e atualize o status novamente.
Reiniciar o Docker pode interromper temporariamente os apps em execução enquanto os serviços reiniciam.
Passo 4: Atualize as Credenciais
Como último passo, use Atualizar Credenciais. Isso é especialmente importante se o status parecer online, mas funções da interface web como instalação de apps não estiverem funcionando.
Essa ação:
- não apaga seus dados
- atualiza as credenciais do usuário root
- atualiza o token da API usado pela interface web
- atualiza automaticamente as credenciais do painel em caso de sucesso
Atualizar credenciais não remove seus apps instalados ou dados de implantação. Apenas renova as credenciais necessárias para acesso e comunicação.
Quando Contatar o Suporte
Se o problema persistir após todos os passos, abra um ticket de suporte pelo site da ZAP-Hosting.
Melhores Práticas
Para manter o Instalador de Apps com Um Clique estável e fácil de gerenciar, siga essas recomendações:
| Melhor prática | Motivo |
|---|---|
| Use uma instalação limpa do SO | Reduz conflitos com serviços e portas existentes |
| Atenda aos recursos recomendados | Melhora desempenho e confiabilidade |
| Organize apps em projetos e ambientes | Mantém implantações gerenciáveis |
| Configure DNS antes de atribuir domínios | Evita problemas de acesso e SSL |
| Use configurações avançadas com cuidado | Evita mudanças customizadas não suportadas |
Se planeja hospedar muitos apps, crie um esquema claro de nomes para [your_project_name], [your_environment_name] e [your_app_name] antes de implantar seus primeiros serviços.
Conclusão
Parabéns, você configurou e usou com sucesso o Instalador de Apps com Um Clique do VPS para implementar e gerenciar apps no seu servidor. Para dúvidas ou ajuda, não hesite em contatar nosso time de suporte, disponível diariamente para te ajudar!