Como você deseja acessar?
Escolha uma opção para ver somente as instruções necessárias.
Qual painel de controle você utiliza?
Escolha o painel da sua hospedagem para abrir o tutorial certo.
Gerar sua chave
A chave é criada aqui, dentro do seu navegador. Leva menos de um segundo.
Serve apenas para você reconhecer a chave depois. Fica como comentário no final da chave pública.
Funciona como a fechadura. Pode ser copiada, enviada e instalada no servidor da sua hospedagem sem risco.
Funciona como a chave física. Guarde-a com segurança. Para deploy automático, salve-a somente nos Secrets do GitHub Actions, nunca nos arquivos do repositório.
Sua chave foi criada
—
Chave privada
uaucloud_sshGuarde esta chave com segurança. No passo 03, você pode salvá-la como secret do GitHub Actions para o deploy. Nunca cole em chats de IA nem instale no servidor.
Chave pública
uaucloud_ssh.pubEsta é a chave que será instalada na sua hospedagem. Pode ser copiada e colada à vontade.
Agora vamos instalar sua chave SSH
Instalar significa colocar a chave pública dentro da sua hospedagem. A privada não entra aqui.
-
1
Acesse o terminal da hospedagem
—
-
2
Execute os comandos, um de cada vez
Copie cada comando, cole no terminal e pressione Enter. Nenhum deles devolve mensagem quando dá certo — o silêncio é bom sinal.
01Criar a pasta de chaves$02Ajustar a permissão da pasta$03Adicionar sua chave pública$Este comando já contém a sua chave pública. Copie pelo botão para não perder nenhum caractere.
04Proteger o arquivo de chaves$05Fechar a pasta pessoal para outros usuários$O passo 05 evita o erro mais comum do OpenSSH: se a sua pasta pessoal puder ser escrita por outros usuários, o servidor recusa a chave por segurança e continua pedindo senha.
-
3
Verificar se sua chave foi instalada
Rode o comando abaixo. Ele mostra todas as chaves autorizadas na conta — a sua chave pública, começando por
ssh-ed25519, deve aparecer na lista.06Conferir as chaves instaladas$Se a linha aparecer inteira, igual à chave pública desta página, a instalação terminou. Se não aparecer nada, repita o passo 03.
- 1Gere e guarde sua chave
No passo 01, gere o par de chaves e baixe a chave privada. A pública aparecerá abaixo, pronta para copiar.
Ver minha chave pública - 2Abra o acesso SSH do site
No StackCP, abra a hospedagem desejada e acesse Security → SSH Access.
- 3Cadastre a chave pública
Em Add New Public Key, cole no campo Public Key a chave copiada pelo botão abaixo.
Gere sua chave no passo 01 para liberar a cópia.
O botão copia somente sua chave pública completa, em uma única linha no formato OpenSSH.
Em Handle, use um nome para reconhecer a chave, como Meu computador, se o campo estiver vazio. Depois clique em Add Public Key.
- 4Aguarde a ativação e prepare o deploy
A ativação pode levar até 30 minutos. Copie usuário, hostname e porta do topo de SSH Access para o passo 03. O usuário costuma ser o domínio do site; sem porta informada, use 22.
Conecte-se com sua chave privada
Use os dados de SSH apresentados no seu painel.
- 1Localize e proteja a chave privada
Use o arquivo
uaucloud_sshbaixado nesta página. Ele fica somente no seu computador; não envie, não cole no servidor e não compartilhe em chats.01macOS ou Linux: proteger o arquivo$ - 2Abra a conexão SSH
Troque HOST, USUARIO e PORTA pelos dados informados no painel.
02macOS ou Linux$03Windows PowerShellPS>Na primeira conexão, confira a impressão digital do servidor por um canal confiável antes de aceitar. Se o painel não mostrar uma porta, use
22.
Use o plugin do Codex
Siga o passo a passo para instalar e utilizar o plugin oficial da UauCloud.
Publique com o UauCloud Deploy
O plugin analisa o projeto, encontra a pasta correta do domínio, cria backup, publica os arquivos e verifica o site por HTTPS. Se algo falhar, também orienta a reversão com segurança.
Depois, abra uma nova tarefa no Codex e escreva: “Publique este projeto na minha hospedagem UauCloud.”
Para começar, tenha em mãos o domínio que deseja publicar. A senha será solicitada somente na janela protegida do plugin, fora da conversa.
Veja tudo o que o plugin pode fazer e os limites atuais
O plugin pode:
- Analisar HTML, CSS, JavaScript, builds estáticos e projetos sem repositório.
- Criar backup, publicar, verificar por HTTPS e orientar a reversão.
- Ajudar a criar ou integrar um repositório e configurar GitHub Actions.
- Detectar WordPress, Laravel, Joomla, Node, dumps e migrations.
- Analisar e importar bancos MariaDB de forma controlada.
Ainda exige análise ou configuração manual:
- Instalação completa de WordPress, Laravel, Joomla ou Node.
- Versões, extensões e serviços PHP ou processos permanentes.
- DNS, e-mail, firewall, serviços do servidor e comandos root.
- Outros provedores e migrations automáticas sem validação prévia.
- Suspensão ou exclusão de contas de hospedagem.
1. Cadastre os secrets no repositório do seu site
Seu código precisa estar em um repositório no GitHub. Com permissão para configurá-lo, abra Settings → Secrets and variables → Actions → Secrets → New repository secret. Não é a seção Deploy keys: ela serve para outro tipo de acesso.
- 1No campo Name, digite SSH_PRIVATE_KEY
No resultado do passo 01, clique em Copiar na chave privada. Cole no campo Secret do GitHub, incluindo as linhas BEGIN e END, com todas as quebras de linha. Não use a chave pública neste campo.
- 2Clique em Add secret
Limpe a área de transferência depois. A chave pública correspondente deve estar autorizada na hospedagem pelo passo 02. Use um par exclusivo para deploy e um usuário com acesso somente ao site necessário, não root.
- 3Repita para os dados abaixo
Use os nomes exatamente como estão escritos. O prompt pedirá que o workflow leia esses secrets, sem gravar seus valores no código.
- SSH_HOST
- Hostname ou IP mostrado no acesso SSH da hospedagem, sem https://.
- SSH_USER
- Usuário SSH da hospedagem, não seu usuário do GitHub.
- SSH_PORT
- Porta SSH informada pelo provedor; normalmente 22.
- DEPLOY_PATH
- Caminho absoluto e confirmado da pasta de publicação. Veja como encontrá-lo abaixo antes de cadastrar.
- SSH_KNOWN_HOSTS
- Entrada known_hosts da identidade do servidor, não a chave pública gerada aqui. Peça ao suporte a chave de host ou confira a impressão digital por um canal confiável antes de salvar. Em porta diferente de 22, a entrada usa [hostname]:porta. Rodar ssh-keyscan sozinho não comprova a identidade do servidor.
3. Peça o workflow ao Codex ou Claude Code
Abra o projeto do seu site no Codex ou Claude Code. Gere e copie o prompt abaixo, cole no assistente e responda às dúvidas sobre o ambiente. A ferramenta gera uma instrução, não executa o deploy e não configura o GitHub por você.
Preencha os dados e confirme o diretório para gerar seu prompt.
Revise o workflow em .github/workflows/deploy.yml antes de enviá-lo ao GitHub. Faça primeiro uma simulação e uma execução manual controlada em Actions → workflow de deploy → Run workflow (o workflow precisa existir na branch padrão para aparecer ali). Confira o diretório e o site no navegador.
Só depois ative o automático: em Settings → Secrets and variables → Actions → Variables → New repository variable, cadastre DEPLOY_ENABLED com valor true. O prompt pede que os deploys por push fiquem bloqueados enquanto essa variável não estiver habilitada.
Proteja sua chave privada
- Nunca envie sua chave privada por WhatsApp, e-mail ou chat.
- Nunca coloque a chave privada dentro do servidor.
- No GitHub, use apenas Actions Secrets para a chave privada. Nunca arquivos, commits, issues ou prompts de IA.
- A UauCloud nunca solicitará sua chave privada. Se pedirem, não é a UauCloud.
- Somente a chave pública deve ser adicionada ao servidor.
- Se a chave privada for comprometida, gere uma nova e remova a antiga do
authorized_keys.