Base de Conhecimento

code-server na VPS: VS Code no navegador

  • code-server, vs code, editor no navegador, ubuntu, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: code-server na VPS: VS Code no navegador

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:8080 limita 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.

Esta resposta lhe foi útil?

Artigos Relacionados