code-server na VPS: VS Code no navegador
code-server 4.145.2 sob licença MIT: requisitos, instalação no Ubuntu, usuário comum, senha, HTTPS com Nginx e Certbot, túnel SSH, extensões do Open VSX, backup e atualização.
Por Redação Eleven Host · @robson.direitodigital · 14 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o tutorial: code-server na VPS: VS Code no navegador Arte: Eleven Host
code-server na VPS roda o editor VS Code no servidor e o abre pelo navegador. Em 14/11/2026, a última versão estável é a 4.145.2; instale a mais nova e, no mínimo, a 4.145.0, por causa de falhas de segurança corrigidas há pouco.
Atualizado em 14/11/2026. Confira cada comando no seu servidor antes de usar. Se a VPS ainda é novidade, o artigo O que é servidor VPS: guia simples para iniciantes explica o básico.
O que é o code-server
O repositório descreve o code-server como o VS Code no navegador: o editor roda numa máquina e você o acessa pelo navegador. O projeto é da Coder, e o código usa a licença MIT, com direitos autorais da Coder Technologies Inc.
Segundo os avisos de segurança do projeto, quem consegue entrar no code-server age como o usuário Linux que o executa, com terminal e arquivos. Recomendamos um usuário comum criado para isso, e não o root, com senha forte e acesso só por HTTPS ou por túnel SSH.
Versão mínima e falhas recentes
Duas falhas recentes explicam a versão pedida acima. Em linguagem simples:
- Uma permitia rodar código no servidor sem login, por um defeito no decodificador de dados Brotli do Node.js, que o code-server trazia junto. O aviso do projeto diz que o padrão de escutar só em
127.0.0.1:8080limita a exposição. A correção saiu na 4.141.1. - Outra expunha o cookie de sessão a serviços abertos pelo proxy de portas embutido, o que dava acesso ao code-server, com terminal e arquivos. Para isso, alguém precisava controlar um serviço acessível pelo proxy e um usuário logado precisava abri-lo. A correção saiu na 4.145.0. Quem abriu serviços duvidosos por esse proxy numa versão antiga deve trocar a senha depois de atualizar.
A 4.145.2, a última estável, atualiza a base do editor para o Code 1.145.2. Evite fixar uma versão antiga: se for usar uma versão específica, escolha a mais nova. A instalação por npm usa o Node do sistema, que precisa estar na 24.22.1 ou mais nova para fechar a falha do Brotli; no Ubuntu, prefira o script ou o pacote .deb.
Requisitos oficiais
A documentação recomenda, no mínimo, 1 GB de RAM e 2 núcleos de CPU. O ambiente precisa ter WebSockets habilitados, porque o navegador e o servidor conversam por eles. Os exemplos abaixo usam o Ubuntu. O pacote .deb existe para amd64 e arm64.
Ver os requisitos no papel é diferente de escolher o servidor: o artigo Onde hospedar API: como decidir ajuda a pensar em recursos de um servidor para aplicações.
Servidor virtual também se contrata na Eleven Host; confira na loja o que cada plano inclui. Ver as VPS
Preparar o servidor
Numa VPS Ubuntu nova, entre como administrador e atualize o sistema. Um exemplo de comandos; o segundo instala o curl, usado mais adiante:
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl
Crie o usuário comum que vai rodar o code-server. Como os passos de instalação usam sudo, ele entra no grupo sudo. Um exemplo, com o nome dev:
sudo adduser dev
sudo usermod -aG sudo dev
Escolha uma senha forte para esse usuário e, daqui em diante, trabalhe com ele (por exemplo, com su - dev): nos comandos com $USER, a variável vira o nome do usuário atual.
Domínio e portas antes do certificado
Para o caminho com HTTPS, a documentação pede um nome de domínio com um registro A apontando para o IP da VPS, e a instância precisa aceitar tráfego HTTP e HTTPS. Faça as duas coisas antes de rodar o Certbot. Se você usa o ufw no servidor, um exemplo que mantém o SSH liberado:
sudo ufw allow OpenSSH
sudo ufw allow 80,443/tcp
sudo ufw enable
Nos exemplos seguintes, o domínio é codigo.exemplo.com e o IP do servidor é 203.0.113.10; troque pelos seus.
Instalar o code-server
O caminho mais fácil no Linux, segundo a documentação, é o script oficial. A doc reconhece a preocupação com o padrão curl | sh, e a opção --dry-run mostra os comandos sem executá-los. Como usuário dev, faça primeiro a prévia:
curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run
Conferida a prévia, rode a instalação. No Debian e no Ubuntu, o script instala o pacote .deb mais recente e, ao final, imprime instruções de uso:
curl -fsSL https://code-server.dev/install.sh | sh
Como alternativa, baixe e instale o .deb à mão. O exemplo usa a 4.145.2 para amd64; para arm64, use o arquivo arm64 da mesma versão. Se já houver uma estável mais nova, troque o número:
curl -fOL https://github.com/coder/code-server/releases/download/v4.145.2/code-server_4.145.2_amd64.deb
sudo dpkg -i code-server_4.145.2_amd64.deb
No Ubuntu, os dois métodos instalam o pacote .deb; depois, ative o serviço, que é uma unidade do systemd por usuário. Rode como dev:
sudo systemctl enable --now code-server@$USER
Um exemplo de comando para conferir a versão, que deve ser a 4.145.0 ou mais nova (confira no seu servidor):
code-server --version
Senha e endereço de escuta
O arquivo ~/.config/code-server/config.yaml aparece depois do primeiro início do serviço. O conteúdo padrão traz estas linhas, além de uma senha gerada de forma aleatória:
bind-addr: 127.0.0.1:8080
auth: password
cert: false
Mantenha o bind-addr em 127.0.0.1:8080: assim o editor só atende conexões vindas do próprio servidor, e o proxy ou o túnel fazem o resto. Troque o valor de password por uma senha forte e reinicie o serviço:
sudo systemctl restart code-server@$USER
Quem entra age como o usuário
O terminal e os arquivos do code-server são os do usuário que o executa. Com o usuário dev, o estrago de um acesso indevido fica limitado ao que ele pode fazer; com o root, o alcance seria bem maior. Neste exemplo, o dev está no grupo sudo só para os comandos de instalação, então a senha dele também precisa ser forte. Por isso a senha forte e o endereço de escuta fechado importam.
HTTPS com Nginx e Certbot
A doc oferece este caminho com o Let's Encrypt, e também alerta para nunca expor o code-server direto na internet sem autenticação e criptografia. Instale o Nginx e o Certbot:
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx
Crie o arquivo /etc/nginx/sites-available/code-server com o bloco abaixo, trocando o nome pelo seu domínio. As linhas Upgrade e Connection são os cabeçalhos de WebSocket: sem eles, o editor não funciona.
server {
listen 80;
listen [::]:80;
server_name codigo.exemplo.com;
location / {
proxy_pass http://localhost:8080/;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection upgrade;
proxy_set_header Accept-Encoding gzip;
}
}
Ative o site. Um exemplo de comandos; o segundo, que testa a sintaxe e recarrega o Nginx, é uma sugestão a conferir no seu servidor:
sudo ln -s ../sites-available/code-server /etc/nginx/sites-enabled/code-server
sudo nginx -t && sudo systemctl reload nginx
Agora o certificado. Troque o domínio e o e-mail:
sudo certbot --non-interactive --redirect --agree-tos --nginx -d codigo.exemplo.com -m voce@exemplo.com
Abra https://codigo.exemplo.com e entre com a senha definida no config.yaml. Para ver se a renovação do certificado funciona, um exemplo de comando do Certbot, a conferir no seu servidor:
sudo certbot renew --dry-run
Alternativa com Caddy
Quem prefere o Caddy no lugar do Nginx segue a seção da documentação oficial: instala o Caddy pelo repositório apt que a doc indica e cria um Caddyfile que repassa o domínio para a porta do code-server. O Caddy cuida do certificado, e depois ele é recarregado com sudo systemctl reload caddy. O Caddyfile do exemplo oficial é este, com o seu domínio no lugar do nome:
codigo.exemplo.com {
reverse_proxy 127.0.0.1:8080
}
Alternativa sem domínio: túnel SSH
A doc recomenda fortemente o túnel SSH (port forwarding). Sem domínio e sem certificado, o editor continua preso ao servidor e só aparece no seu computador enquanto o túnel estiver aberto. Como a conexão já é autenticada pelo SSH, a doc mostra desligar a senha do code-server; isso só vale com o bind-addr em 127.0.0.1 e sem Nginx ou Caddy publicando o editor, porque senão o acesso ficaria sem senha na internet. Não troque o endereço de escuta nesse modo. No servidor:
sed -i.bak 's/auth: password/auth: none/' ~/.config/code-server/config.yaml
sudo systemctl restart code-server@$USER
No seu computador, abra o túnel e acesse http://127.0.0.1:8080 no navegador:
ssh -N -L 8080:127.0.0.1:8080 dev@203.0.113.10
Extensões
O code-server usa a galeria Open VSX, também usada por outros forks do VS Code. A FAQ explica que a Microsoft proíbe que um VS Code que não seja dela acesse o Marketplace, pelos termos que limitam essas ofertas aos produtos da própria Microsoft. Por isso, algumas extensões que existem lá podem faltar no Open VSX. Para uma extensão em arquivo .vsix, use o comando Extensions: Install from VSIX na paleta de comandos ou o terminal:
code-server --install-extension /caminho/da/extensao.vsix
Mais de uma pessoa
Para mais de uma pessoa, a FAQ recomenda uma máquina virtual por usuário. Para quem também quer publicar aplicações no servidor, há o artigo Dokploy na VPS: publique apps no seu servidor.
Backup e atualização
Atualizar é instalar a versão nova por cima da antiga, e os dados em ~/.local/share/code-server são preservados. Como sugestão a conferir no seu servidor, antes de atualizar guarde a configuração, os dados do code-server e a pasta dos projetos, de preferência com uma cópia fora da VPS. Um exemplo, com a pasta ~/projetos:
tar czf code-server-$(date +%F).tar.gz ~/.config/code-server ~/.local/share/code-server ~/projetos
Depois do backup, repita o comando de instalação escolhido (o script ou o .deb da versão nova) e reinicie o serviço, conferindo a versão:
sudo systemctl restart code-server@$USER
code-server --version
Resumo da ordem das etapas
A sequência é atualizar o sistema, criar o usuário comum, apontar o domínio, instalar, conferir a versão, ajustar o config.yaml e publicar com HTTPS ou túnel.
O registro A liga um nome de domínio ao IP do servidor. Buscar domínio
Perguntas frequentes
Qual é a licença do code-server?
O código usa a licença MIT, com direitos autorais da Coder Technologies Inc. O Marketplace da Microsoft tem termos próprios, que não fazem parte dessa licença.
Posso instalar extensões do Marketplace da Microsoft?
A FAQ diz que a Microsoft proíbe que um VS Code que não seja dela acesse o Marketplace, e por isso o code-server oferece o Open VSX. Para uma extensão específica, veja se ela existe no Open VSX.
Preciso de domínio para usar?
Não. O túnel SSH dispensa domínio e certificado. Com o Nginx ou o Caddy e o HTTPS, o domínio é necessário, com o registro A apontado para a VPS.
Posso dar acesso a outras pessoas?
Quem entra age como o usuário Linux que roda o code-server, com terminal e arquivos. Para vários usuários, a FAQ recomenda uma máquina virtual para cada um.