Implantar um editor de código online em VPS (2025) - Guia completo de instalação do Code-server

Certifique-se de que o Docker e o Docker Compose estejam instalados no VPS:

# 安装 Docker (如果还没装)
curl -fsSL https://get.docker.com | sh
sudo systemctl enable --now docker

# 验证安装
docker --version
docker compose version

Antes de começar a implantação, certifique-se de que as seguintes portas estejam liberadas no firewall do VPS ou no grupo de segurança do provedor de nuvem:

• 80 (TCP): validação do certificado Let's Encrypt
• 443 (TCP): acesso HTTPS

# UFW 示例
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload

Observação: se você usa um provedor nacional como Alibaba Cloud ou Tencent Cloud, também é preciso adicionar regras no "Grupo de segurança" do console.

mkdir -p ~/code-server/{config,workspace}
cd ~/code-server

version: "3.8"

services:
  code-server:
    image: codercom/code-server:latest
    container_name: code-server
    restart: unless-stopped
    ports:
      - "127.0.0.1:8443:8080"  # 只绑定本地，通过反向代理暴露
    environment:
      - PASSWORD=YourStrongPassword123!  # 修改为强密码
      - TZ=Asia/Shanghai
    volumes:
      - ./config:/home/coder/.config
      - ./workspace:/home/coder/project
    user: "1000:1000"  # 使用非 root 用户

Dica de segurança: vincular a porta a 127.0.0.1 é essencial! Isso impede que o Code-server fique exposto diretamente à internet; todo o tráfego precisa passar pelo proxy reverso.

docker compose up -d

Agora o Code-server já está rodando na porta local 8443, mas ainda não é acessível de fora. O próximo passo é configurar o HTTPS.

# Debian/Ubuntu
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

Vá ao Cloudflare (ou ao seu provedor de DNS) e adicione um registro A:

类型: A
名称: code
值: 你的 VPS IP
代理状态: 仅 DNS（灰色云朵）  # 重要！SSL 由 Caddy 处理

Verifique se o DNS está em vigor (é preciso confirmar isso antes de iniciar o Caddy):

dig code.yourdomain.com +short
# 应该返回你的 VPS IP 地址

Se nenhum IP for retornado, aguarde a propagação do DNS (normalmente alguns minutos); caso contrário, a solicitação do certificado SSL falhará.

Edite /etc/caddy/Caddyfile:

code.yourdomain.com {
    reverse_proxy 127.0.0.1:8443
    
    # 可选：添加基础认证双重保护
    # basicauth {
    #     admin $2a$14$... # caddy hash-password 生成的 bcrypt
    # }
}

sudo systemctl enable --now caddy
sudo systemctl reload caddy

Após alguns segundos, acesse https://code.yourdomain.com e você verá a tela de login do VS Code! Digite a senha definida em docker-compose.yml para entrar.

Defina em docker-compose.yml uma senha complexa de pelo menos 16 caracteres, com letras maiúsculas e minúsculas, números e caracteres especiais.

sudo apt install fail2ban -y

Crie /etc/fail2ban/jail.local:

[code-server]
enabled = true
port = http,https
filter = code-server
logpath = /var/log/caddy/access.log
maxretry = 5
bantime = 3600

cd ~/code-server
docker compose pull
docker compose up -d

Se você acessa o servidor apenas pelo Code-server, pode desativar o login SSH por senha e permitir somente a autenticação por chave.

tar -czvf code-server-backup-$(date +%Y%m%d).tar.gz ~/code-server

Recomendamos usar o Rclone para sincronizar com armazenamento em nuvem (S3/OneDrive/Google Drive). Veja: Soluções de backup automático para VPS

Se várias pessoas compartilham um servidor, você pode criar um contêiner independente para cada usuário:

services:
  alice:
    image: codercom/code-server:latest
    ports:
      - "127.0.0.1:8444:8080"
    volumes:
      - ./alice:/home/coder
    environment:
      - PASSWORD=AlicePassword
      
  bob:
    image: codercom/code-server:latest
    ports:
      - "127.0.0.1:8445:8080"
    volumes:
      - ./bob:/home/coder
    environment:
      - PASSWORD=BobPassword

Depois, configure subdomínios diferentes no Caddyfile apontando para portas diferentes.

Depois de entrar no Code-server, pressione Ctrl+Shift+X para abrir o marketplace de extensões. Recomendamos instalar:

• Python / Go / Rust Analyzer - Suporte a linguagens
• GitLens - Melhorias de Git
• Remote - SSH - Desenvolvimento remoto (se precisar conectar a outros servidores)
• Docker - Gerenciamento de contêineres

• Certifique-se de que o VPS esteja em uma região de baixa latência (como Hong Kong ou Japão)
• Faça upgrade para 2 núcleos e 2GB ou mais
• Use o Argo Tunnel da Cloudflare para otimizar a conexão

• Verifique se a resolução DNS está em vigor: dig code.yourdomain.com +short
• Certifique-se de que a porta 80 esteja aberta (necessária para o Let's Encrypt)
• O proxy da Cloudflare precisa estar desativado (nuvem cinza)

Sim, mas atenção:

• O domínio precisa de registro ICP
• Solicite o certificado SSL por conta própria (provedores nacionais nem sempre oferecem suporte à automação)