VPS para code-server: VS Code no navegador

Seu notebook tem cinco anos, o build leva oito minutos e você quer corrigir um bug de um tablet no trem. O code-server roda o Visual Studio Code num servidor e entrega o editor completo numa aba do navegador — mesmas extensões, mesmo terminal, mesmos atalhos. O trabalho pesado acontece no VPS; seu dispositivo só desenha a interface.

Por que um VPS funciona bem

• Um ambiente em todo lugar. O mesmo checkout, as mesmas ferramentas e configurações no notebook, num PC emprestado ou num iPad.
• Builds não drenam a bateria. Compilação e testes usam a CPU do servidor.
• Trabalhos longos sobrevivem. Feche a tampa, e uma tarefa no tmux continua rodando.
• Downloads rápidos. npm install e docker pull usam a conexão rápida do servidor, não o Wi-Fi do hotel.

Do que precisa

Os language servers são o custo escondido. Um projeto TypeScript com alguns milhares de arquivos pode consumir sozinho um gigabyte.

Instalação

Como usuário comum com sudo (não root — veja nosso guia de usuário sudo):

curl -fsSL https://code-server.dev/install.sh | sh
sudo systemctl enable --now code-server@$USER

O script escolhe o pacote certo para a sua distribuição. As configurações ficam em ~/.config/code-server/config.yaml:

bind-addr: 127.0.0.1:8080
auth: password
password: use-a-long-random-password
cert: false

Reinicie depois de editar: sudo systemctl restart code-server@$USER. Mantenha bind-addr em 127.0.0.1 — ele nunca deve escutar num endereço público sem HTTPS na frente.

Acesso 1: túnel SSH (funciona em qualquer plano)

Da sua máquina:

ssh -p 22 -N -L 8080:127.0.0.1:8080 you@203.0.113.10

Depois abra http://localhost:8080. Nada fica exposto na internet, e o SSH cuida da criptografia. Num plano NAT, use a porta SSH pessoal do painel em vez da 22. É a configuração que recomendamos para quem desenvolve sozinho.

Acesso 2: HTTPS no seu domínio

Para acessar de dispositivos onde não dá para usar SSH, coloque o nginx na frente num plano com IP dedicado. Aponte um subdomínio para o servidor (veja como) e faça o proxy com suporte a WebSocket:

server {
    server_name code.example.com;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection upgrade;
        proxy_set_header Accept-Encoding gzip;
    }
}

Obtenha um certificado com certbot --nginx -d code.example.com. Nosso guia de proxy reverso cobre os detalhes. Com uma URL pública, a senha em config.yaml é a única coisa entre a internet e um shell no seu servidor, então faça-a longa.

O que saber antes de migrar

• As extensões vêm do Open VSX. As mais populares estão lá; algumas exclusivas da Microsoft não. Confira as suas antes.
• Os atalhos do navegador às vezes ganham. Ctrl+W fecha a aba, não o arquivo. Instalar o code-server como PWA pelo menu do navegador resolve quase tudo.
• Sem GPU. É um servidor de CPU — ótimo para código, não para treinar modelos.
• Trabalhos longos no tmux. O terminal integrado morre junto com a aba.

Combina bem com

Se você usa agentes de programação com IA, o mesmo servidor pode rodá-los ao lado do editor — veja rodar um agente de programação num VPS e o caso de uso do Claude Code. Detalhes dos planos e upgrades estão na documentação dos planos.