Tutoriais de VPS
VS Code Remote SSH no VPS: chaves, servidor e agentes (2026)
Prepare Linux compatível, valide chaves e abra o workspace remoto. Encaminhe portas e diagnostique instalação do servidor e agentes.

Para editar projeto do VPS no VS Code local e executar agente no mesmo diretório remoto, não precisa instalar desktop no servidor. O Remote - SSH da Microsoft instala VS Code Server pelo SSH existente. Arquivos, terminais e a maioria das extensões de trabalho rodam no VPS; seu computador mostra o editor. O guia usa Ubuntu e um desenvolvedor, incluindo instalação do servidor travada.
Diferente do code-server no navegador, exige VS Code local e host SSH compatível. Código fica remoto. Desconectar o editor não preserva processos interativos; use tmux para agentes longos.
Teste SSH no terminal e confira sistema, memória, disco e ferramentas:
ssh [email protected]
uname -m
cat /etc/os-release
free -h
df -h "$HOME"
command -v bash tar curl || true
Troque usuário/IP: 203.0.113.10 é endereço documental. O guia Remote - SSH exige ao menos 1 GB e recomenda 2 GB e dois núcleos. Reserve mais para builds, testes e agentes. Os requisitos Linux incluem kernel 4.18+, glibc 2.28+, libstdc++ 3.4.25+, OpenSSH Server, Bash, tar e curl ou wget. Ubuntu 22.04/24.04/26.04 com glibc facilita; Alpine com musl fica fora deste host.
Instale ferramentas ausentes no terminal já conectado ao VPS:
sudo apt update
sudo apt install -y openssh-server bash curl tar ca-certificates git tmux
sudo systemctl status ssh --no-pager
SSH funcionando não exige trocar porta/autenticação por causa do VS Code. Valide chave antes de alterar sshd_config e preserve sessão aberta.
Execute no seu computador, não no VPS. Reutilize chave dedicada ou confira destino antes de criar:
ls -l ~/.ssh/vps_dev ~/.ssh/vps_dev.pub 2>/dev/null || true
ssh-keygen -t ed25519 -f ~/.ssh/vps_dev -C "vps-remote-dev"
Proteja privada com frase secreta; SSH agent pode lembrar. Adicione a pública .pub em ~/.ssh/authorized_keys do usuário remoto. No macOS/Linux com ssh-copy-id:
ssh-copy-id -i ~/.ssh/vps_dev.pub [email protected]
ssh -i ~/.ssh/vps_dev [email protected] 'whoami'
Sem ssh-copy-id, use recurso de chaves do provedor ou acrescente a saída pública de cat ~/.ssh/vps_dev.pub em ~/.ssh/authorized_keys por sessão confiável. Não envie a privada. Confira impressão digital; investigue reinstalação/IP antes de aceitar mudança. StrictHostKeyChecking no esconde problemas de identidade.
Edite ~/.ssh/config local:
Host dev-vps
HostName 203.0.113.10
User ubuntu
Port 22
IdentityFile ~/.ssh/vps_dev
IdentitiesOnly yes
Use porta real em Port se não for 22. Teste antes do VS Code:
chmod 600 ~/.ssh/config ~/.ssh/vps_dev
ssh -G dev-vps | grep -E '^(hostname|user|port|identityfile) '
ssh dev-vps 'whoami; pwd'
Se rejeitar, veja usuário/chave com ssh -v dev-vps. Permission denied (publickey) costuma indicar pública em outro usuário, IdentityFile incorreto ou permissões ~/.ssh/authorized_keys. Repetir senha root não corrige.
Instale Remote - SSH local. Use F1 ou paleta, execute Remote-SSH: Connect to Host... e escolha dev-vps. Aguarde VS Code Server; em File → Open Folder, abra pasta remota como /home/ubuntu/app. O canto inferior esquerdo deve mostrar SSH: dev-vps.
Execute hostname e pwd: hostname do VPS e caminho confirmam terminal remoto. Instale extensões de trabalho onde aparece Install in SSH: dev-vps. Extensões de interface normalmente ficam locais; de workspace, remotas.
Vincule serviços de desenvolvimento ao loopback, como 127.0.0.1:3000; encaminhe 3000 em Ports e use a URL local exibida. Confira se o framework exige localhost para redirecionamento. Porta local ocupada pode receber outro número. Não precisa abrir 3000 publicamente. Veja encaminhamento de portas.
Confirme pwd e use agente instalado sob usuário de desenvolvimento comum. Código e recursos são do VPS; requisições de modelo seguem serviço/autenticação da ferramenta. Use usuário e branch de desenvolvimento, em vez de acesso irrestrito à produção.
Veja Codex CLI remoto ou Claude Code no VPS. Para interrupções, inicie tmux new -s agent remoto e execute dentro; retorne com tmux attach -t agent. tmux preserva sessão, não código não salvo, commits ou backups.
| Sintoma | Conferir | Ação |
|---|---|---|
ssh dev-vps em timeout | IP, porta, firewall e rede local | Confirmar IP/SSH do provedor; VS Code não corrige SSH |
Permission denied (publickey) | Usuário/chave de ssh -v dev-vps e pública remota | User/IdentityFile e usuário |
| SSH funciona, instalação não | Output → Remote - SSH, disco e rede | df -h "$HOME" e download local oficial |
VS Code Server failed to start | Bibliotecas, disco e logs | Requisitos; Remote-SSH: Kill VS Code Server on Host... e reconectar |
| Prompt escondido/spinner | Frase secreta ou segundo fator | Ativar remote.SSH.showLoginTerminal |
| Arquivos abrem, extensão/agente falha | Local de instalação, saída e memória | Extensão remota, free -h e endpoints |
A documentação de downloads explica tentativa remota e fallback local com transferência. remote.SSH.localServerDownload em always força download local. Extensões ainda podem precisar de Marketplace/dependências no VPS. Use Kill/Uninstall oficiais e logs, sem apagar indiscriminadamente ~/.vscode-server.
Valide ssh dev-vps local repetível, espaço df -h "$HOME" e portas acessíveis apenas a usuários previstos. Preserve sessão e teste nova conexão antes de mudar SSH. Separe repositórios, chaves e processos do agente das contas produtivas.
Referências: Remote - SSH, requisitos Linux, diagnóstico remoto.