YouMind
Entrar

Como usar o Google Colab como servidor SSH remoto

@jandisufg
PORTUGUÊS19 de nov. de 2026
206K
1.8K
97
40
3.6K

TL;DR

Este tutorial explica como usar a CLI oficial do Google Colab para estabelecer conexões SSH, transformando instâncias do Colab em servidores remotos. Ele detalha instalação, configuração, autenticação e boas práticas para gerenciar recursos computacionais e persistência de dados.

O Google Colab não é só notebook. Com o CLI oficial do Google, o google-colab-cli, dá para abrir um terminal SSH numa máquina do Colab, com ou sem GPU, direto do seu terminal, do VS Code ou de qualquer editor que fale SSH.

Neste artigo: instalar o CLI, configurar o ~/.ssh/config, fazer o primeiro login, conectar e desligar sem queimar unidades de computação à toa.

O que você precisa

  • Uma conta Google com acesso ao Colab (Assinatura Google AI - Plus, Pro ou Ultra)
  • Python 3 com uv ou pip
  • OpenSSH, que já vem no Linux, no macOS e no Windows 10/11
  • Uma chave SSH ed25519

1. Instale o CLI do Colab

O pacote oficial se chama google-colab-cli e instala o comando colab.

text
1uv tool install google-colab-cli
2# ou: pip install google-colab-cli
3colab version
Janderson F. | elyra.sh - inline image

2. Tenha uma chave SSH

Na hora de conectar, o colab envia a sua chave pública para a máquina. Por padrão ele procura ~/.ssh/id_ed25519.pub ou id_ecdsa.pub. Ainda não tem uma?

text
1ssh-keygen -t ed25519

Usa uma chave com outro nome? Tudo bem: você aponta para ela no próximo passo, com o -i.

3. Adicione o host no ~/.ssh/config

Abra (ou crie) o arquivo ~/.ssh/config e cole este bloco:

text
1Host colab
2 User root
3 ProxyCommand colab ssh --proxy-mode -s colab -i ~/.ssh/id_ed25519.pub
4 StrictHostKeyChecking no
5 UserKnownHostsFile /dev/null
Janderson F. | elyra.sh - inline image

O que cada linha faz:

  • Host colab: o apelido. Depois disso, é só digitar ssh colab.
  • ProxyCommand: em vez de abrir conexão para um IP, o SSH conversa com o colab ssh --proxy-mode, que faz a ponte até a máquina do Colab. O -s colab é o nome da sessão: se ela não existir, o CLI cria.
  • StrictHostKeyChecking no e UserKnownHostsFile /dev/null: cada sessão é uma máquina nova, com chave de host nova. Sem isso, o SSH reclama a cada conexão.

Duas pegadinhas que me custaram tempo:

  • Se o seu config tem um bloco Host \, coloque o colab antes dele. No SSH, o primeiro valor encontrado é o que vale: um StrictHostKeyChecking no Host \ de cima anula o do colab.
  • No Windows, use o caminho absoluto da chave no -i (C:/Users/voce/.ssh/id_ed25519.pub). O ~ dentro do ProxyCommand não é expandido.

4. Faça o primeiro login num terminal de verdade

Na primeira vez, o CLI pede autorização da sua conta Google: mostra um link, você aprova no navegador e cola de volta o código que o Google exibe.

text
1colab new -s colab
Janderson F. | elyra.sh - inline image

Atenção: faça esse primeiro login num terminal interativo (PowerShell, Terminal, iTerm). Se o primeiro ssh colab sair de algo sem teclado, como um agente de IA, um script ou um comando disparado de dentro de um chat, o CLI não tem onde ler o código e o login falha com "Malformed auth code". Depois que o login fica salvo, qualquer lugar serve.

Quer GPU? Crie a sessão já com ela: colab new -s colab --gpu T4. Também aceita L4, A100 e H100, e --high-mem para mais RAM.

5. Conecte

text
1ssh colab
Janderson F. | elyra.sh - inline image

Você cai como root em /content, num Ubuntu 24.04. A sessão sem GPU do print tem 2 vCPUs, 12 GB de RAM e uns 226 GB de disco.

Também dá para rodar um comando só, sem abrir o shell:

text
1ssh colab "nvidia-smi"

E como é SSH comum, o VS Code (Remote - SSH), o scp, o rsync e qualquer editor com máquina remota enxergam o host colab sem nenhuma configuração extra.

6. Desligue quando terminar

A sessão gasta unidades de computação enquanto estiver ligada, mesmo parada. Terminou? Desligue e confira:

text
1colab stop -s colab
2colab sessions
3colab usage
Janderson F. | elyra.sh - inline image

Para não depender da memória, o CLI tem o --rm, que desliga a sessão quando o SSH fecha. É só acrescentar no ProxyCommand:

text
1ProxyCommand colab ssh --proxy-mode -s colab --rm -i ~/.ssh/id_ed25519.pub

Quanto dura e quanto custa

  • Cada tipo de máquina consome unidades num ritmo próprio. Sem GPU é quase nada; a T4 gira em torno de 1,8 por hora, a L4 de 4,8 e a A100 de 11 a 13. Os valores mudam: confira com colab usage, com a sessão ligada.
  • Sessões têm teto de tempo (até cerca de 24 h no Pro) e caem por inatividade.
  • O disco é descartável. Quando a sessão acaba, tudo some. Dê git push ou copie seus arquivos antes (scp, rsync ou colab download), ou monte o Google Drive com colab drivemount.

Comandos do CLI que valem decorar

  • colab sessions: lista as sessões ativas
  • colab status: estado da sessão
  • colab usage: saldo e taxa de uso
  • colab upload / colab download: manda e traz arquivos
  • colab drivemount: monta o Google Drive na máquina
  • colab stop -s <nome>: desliga a sessão

Pronto: o Colab vira só mais um host no seu ~/.ssh/config. Um ssh colab e você está numa máquina Linux com GPU, pagando só pelo tempo em que ela fica ligada.

Salvar com um clique

Faça leitura profunda de artigos virais com IA no YouMind

Salve a fonte, faça perguntas específicas, resuma o argumento e transforme um artigo viral em notas reutilizáveis em um único espaço de trabalho com IA.

Explorar o YouMind
Para criadores

Transforme seu Markdown em um artigo 𝕏 impecável

Quando você publica seus próprios textos longos, formatar imagens, tabelas e blocos de código para o 𝕏 é uma dor de cabeça. O YouMind transforma um rascunho completo em Markdown em um artigo 𝕏 impecável e pronto para publicar.

Experimente Markdown para 𝕏

Mais padrões para decifrar

Artigos virais recentes

Explorar mais artigos virais