Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

​
O que é SSH?

SSH, que significa Secure Shell, é um protocolo seguro que facilita o acesso remoto à interface de linha de comando do seu Replit App. Com SSH, você pode transferir arquivos facilmente e aproveitar seu Ambiente de Desenvolvimento Integrado (IDE) local preferido para editar código no Replit, aprimorando a colaboração e a produtividade no seu fluxo de trabalho de desenvolvimento. A funcionalidade SSH está disponível para os planos Core, Pro e todos os outros planos pagos. Aqui está uma visão geral do processo:
  • Gere um par de chaves SSH na sua máquina local
  • Adicione essa chave SSH ao painel SSH dentro de qualquer Replit App
  • Conecte-se usando um cliente SSH ou um editor que possa funcionar via SSH (como VSCode ou Cursor)
As chaves SSH estão associadas à sua conta, não a um Replit App específico. Isso significa que você só precisa adicionar uma chave pública uma vez e, após isso, pode se conectar a qualquer Replit App ao qual tenha acesso.

​
Por que usar SSH?

  • Atualizações automáticas entre o Replit App e o editor: Quaisquer alterações feitas no Replit App são refletidas no seu editor instantaneamente, e quaisquer modificações no editor são atualizadas no Replit App. Essa sincronização perfeita garante que sua base de código esteja sempre atualizada em todas as plataformas.
  • Sincronização do gerenciamento de arquivos: Seja adicionando, excluindo ou atualizando arquivos, essas alterações são sincronizadas em tempo real entre seu editor e o Replit App. Esse recurso garante que a estrutura do seu projeto permaneça consistente, independentemente de onde as alterações sejam iniciadas.
  • Gerenciamento de pastas e movimentação de arquivos: A movimentação de arquivos entre pastas também é sincronizada entre seus editores e o Replit App. Isso garante que as mudanças organizacionais feitas em um ambiente sejam refletidas com precisão no outro, mantendo a integridade e a estrutura do seu projeto.

​
Encontrar ou criar um par de chaves

Para configurar SSH para sua conta, você precisará da sua chave pública SSH.

​
Verificar se você já tem um par de chaves

Você pode verificar se já tem uma chave pública executando o seguinte comando em um Terminal no seu computador local: 
ls -l ~/.ssh
Se você receber um erro, tudo bem, prossiga para Gerar um novo par de chaves. Se você vir um arquivo chamado replit.pub, prossiga para Obter o conteúdo da sua chave pública.

​
Gerar um novo par de chaves

Na sua máquina, abra uma janela de Terminal (ou Prompt de Comando) e cole o seguinte comando: 
ssh-keygen -t ed25519 -f ~/.ssh/replit -q -N ""
Este comando verifica se um arquivo de chave pública SSH específico já existe. Caso contrário, cria uma nova chave SSH com alguns parâmetros sensatos.

​
Obter o conteúdo da sua chave pública

Depois de confirmar que você tem um par de chaves ou de criar um, exiba o conteúdo da chave pública (um dos dois arquivos com nomes semelhantes, com o sufixo .pub), pois precisaremos dela posteriormente. 
cat ~/.ssh/replit.pub
Salve o conteúdo de replit.pub para usar mais adiante neste artigo e prossiga para adicionar a chave SSH à sua conta.

​
Adicionar a chave SSH à sua conta

​
Adicionar a chave pública diretamente em um Replit App, usando o painel SSH

  1. No seu Replit App em qualquer janela, selecione o botão + e pesquise por SSH.
Botão da ferramenta SSH na interface do Replit
  1. Navegue até a aba Keys e selecione New SSH key.
  2. Na janela popup, insira um Label para sua chave (por exemplo, my-ssh-key) e cole a chave pública que você copiou na seção Key. Selecione o botão Add SSH Key. Sua chave foi adicionada e autorizada para uso.
Diálogo para adicionar chave SSH com os campos de rótulo e chave preenchidos

​
Adicionar a chave pública diretamente nas Configurações

Você também pode adicionar uma chave SSH abrindo Settings e, em Account, selecionando Advanced (ou a opção SSH keys). Selecione Add SSH key e cole o conteúdo de replit.pub da seção anterior, Encontrar ou criar um par de chaves.
Quando você tem múltiplas chaves públicas na sua máquina, é importante garantir que você use a combinação correta de chaves privada e pública para a sua configuração SSH.

​
Conectando ao seu Replit App

​
Configurar seu config SSH

  1. Em um terminal, certifique-se de que o diretório ~/.ssh e o arquivo ~/.ssh/config existam:
mkdir -p ~/.ssh && chmod 700 ~/.ssh && touch ~/.ssh/config && chmod 600 ~/.ssh/config
open -a 'TextEdit' ~/.ssh/config || nano ~/.ssh/config
  1. Adicione um bloco de configuração para usar o par de chaves replit para todos os domínios *.replit.dev:
Host *.replit.dev
    Port 22
    IdentityFile ~/.ssh/replit
    StrictHostKeyChecking accept-new

​
Conectar a partir do VSCode ou Cursor

  1. Em um Replit App, abra o painel SSH
  2. No painel SSH, navegue até a aba Connect e selecione Launch VS Code.
Aba de conexão SSH mostrando a opção Launch VS Code
  1. Se você for solicitado a preencher ~/.ssh/config, insira o seguinte: 
    Host *.replit.dev
    Port 22
    IdentityFile ~/.ssh/replit
    StrictHostKeyChecking accept-new
    A adição da configuração SSH só é solicitada na primeira vez que você tenta se conectar ao VS Code ou outro editor. Para retornar ao arquivo de configuração, você precisará selecionar Configure SSH Hosts….
  2. Se solicitado por um aviso de aplicativo externo, selecione Yes para confirmar que deseja abrir seu projeto no seu editor preferido ou no VS Code.
  3. Você pode ser solicitado a instalar ou atualizar extensões SSH periodicamente. O Replit se esforçará para ser compatível com as versões mais recentes desses IDEs, e você também poderá receber atualizações de segurança importantes.

​
Conectar manualmente

Na parte inferior da aba “Connect” do painel SSH, você encontrará “Connect manually”. Copie esse comando, cole-o em um Terminal local (Mac ou Linux) ou no Prompt de Comando local (Windows) para se conectar diretamente. Essa também é uma boa maneira de depurar problemas de conexão com IDEs, bem como coletar informações de conexão “verbose” valiosas ao relatar bugs ao Suporte do Replit. Um erro indicando que estamos tentando nos conectar com uma chave privada inexistente: 
$ ssh -i ~/.ssh/replit -p 22 c96b6ade-d5e4-4f7a-bc5b-52334509b2a3@c96b6ade-d5e4-4f7a-bc5b-52334509b2a3-00-16nh2hskw3ql8.riker.replit.dev
Warning: Identity file /Users/user/.ssh/replit not accessible: No such file or directory.
Logs de depuração completos de uma tentativa de conexão SSH, para incluir em um relatório de bug: 
$ ssh -vvv -i ~/.ssh/replit -p 22 c96b6ade-d5e4-4f7a-bc5b-52334509b2a3@c96b6ade-d5e4-4f7a-bc5b-52334509b2a3-00-16nh2hskw3ql8.riker.replit.dev
OpenSSH_9.6p1, LibreSSL 3.3.6
debug1: Reading configuration data /Users/.../.ssh/config
debug1: /Users/.../.ssh/config line 1: Applying options for *
debug1: /Users/.../.ssh/config line 4: Applying options for *.replit.dev
debug3: channel_clear_timeouts: clearing
debug1: Connecting to c96b6ade-d5e4-4f7a-bc5b-52334509b2a3-00-16nh2hskw3ql8.riker.replit.dev port 22.
debug1: Connection established.
debug1: identity file /Users/dstewart/.ssh/replit type 3
debug1: Local version string SSH-2.0-OpenSSH_9.6
debug1: Remote protocol version 2.0, remote software version Replit-SSH-Proxy
debug1: compat_banner: no match: Replit-SSH-Proxy
debug3: fd 5 is O_NONBLOCK
...
Welcome to the Replit SSH Proxy.

Visit https:/.replit.com/replit-workspace/ssh to learn more about SSH on Replit.
debug3: receive packet: type 51
debug1: Authentications that can continue: password,publickey
debug3: start over, passed a different list password,publickey
debug3: preferred publickey,keyboard-interactive,password
debug3: authmethod_lookup publickey
debug3: remaining preferred: keyboard-interactive,password
debug3: authmethod_is_enabled publickey
debug1: Next authentication method: publickey
...
debug2: we did not send a packet, disable method
debug3: authmethod_lookup password
debug3: remaining preferred: ,password
debug3: authmethod_is_enabled password
debug1: Next authentication method: password

​
Conectar via uma ferramenta não listada aqui

Existem muitos clientes SSH disponíveis para diferentes plataformas e sistemas operacionais, muitos oferecendo diferentes recursos ou integrações. Você sempre pode decompor o comando exibido em “Connect Manually” em seus componentes constituintes para determinar como configurar cada cliente: 
ssh -i ~/.ssh/replit -p 22  c96b6ade-d5e4-4f7a-bc5b-52334509b2a3@c96b6ade-d5e4-4f7a-bc5b-52334509b2a3-00-16nh2hskw3ql8.riker.replit.dev
       ^-----v-----^    ^^  ^-----------------v----------------^ ^------------------------------v-------------------------------------^
        Private Key   Port                   User               @                           Hostname
Hostname: <your_hostname>.<cluster>.replit.dev Port: <port_number> User: Username Private Key: Caminho para o arquivo de chave privada no seu computador. Geralmente próximo a replit.pub.