Conexão SSH na Raspberry Pi

Nesta aula, você aprenderá como configurar e utilizar a conexão SSH (Secure Shell) na sua Raspberry Pi. Abordaremos desde os fundamentos do SSH, passando pelos motivos para usá-lo, os materiais e softwares necessários, até o passo a passo para configurar e solucionar problemas comuns que podem surgir durante o processo.

O que é uma conexão SSH?

SSH (Secure Shell) é um protocolo de rede que permite a comunicação segura entre dois dispositivos em uma rede, geralmente usado para acessar remotamente sistemas operacionais baseados em Unix/Linux, como o Raspberry Pi OS. Ele fornece um canal criptografado através de uma rede insegura, garantindo que os dados transmitidos entre o cliente (seu computador) e o servidor (a Raspberry Pi) sejam protegidos contra interceptações e ataques.

Com uma conexão SSH, você pode acessar a linha de comando da placa Raspberry Pi a partir de qualquer outro dispositivo, como um PC, notebook ou até mesmo um smartphone, sem a necessidade de estar fisicamente presente. Isso permite realizar uma ampla gama de operações, como administração de sistema, execução de scripts, instalação de software, transferências de arquivos e muito mais.

O SSH funciona em um modelo cliente-servidor, onde o dispositivo que deseja se conectar (cliente) envia uma solicitação de conexão ao dispositivo remoto (servidor, neste caso, a Raspberry Pi). Ao estabelecer uma conexão, todas as comunicações entre os dois dispositivos são criptografadas, garantindo segurança e privacidade.

Por que utilizar a conexão SSH na Raspberry Pi?

Utilizar uma conexão SSH na Raspberry Pi oferece várias vantagens, especialmente quando se trata de acessibilidade, conveniência e segurança. Abaixo, destacamos os principais motivos para usar SSH na Raspberry Pi:

• Acesso Remoto: O SSH permite que você acesse sua Raspberry Pi de qualquer lugar da sua rede local, ou até mesmo pela internet, sem precisar estar fisicamente próximo do dispositivo. Isso é especialmente útil se a Raspberry Pi estiver em um local de difícil acesso ou se você estiver longe dela.
• Gerenciamento Sem Periféricos: Com SSH, não há necessidade de conectar um monitor, teclado ou mouse diretamente à Raspberry Pi. Você pode realizar todas as operações necessárias diretamente do seu computador ou smartphone. Isso economiza espaço, reduz a necessidade de periféricos adicionais e é ideal para projetos onde a Raspberry Pi é usada de forma headless (sem monitor).
• Automação e Administração Remota: O SSH permite executar comandos e scripts remotamente, facilitando a automação de tarefas e o gerenciamento da Raspberry Pi. Isso é particularmente útil para administrar múltiplas Raspberry Pis ou para aplicações de servidor, como controle de mídia, servidor web ou até mesmo IoT (Internet das Coisas).
• Segurança nas Comunicações: O SSH utiliza criptografia para proteger todos os dados transmitidos entre o cliente (seu computador) e o servidor (a Raspberry Pi), garantindo que informações sensíveis, como senhas e comandos, não sejam interceptadas.
• Transferência Segura de Arquivos: Além do acesso ao terminal, o SSH também permite a transferência segura de arquivos entre seu computador e a Raspberry Pi usando ferramentas como SCP (Secure Copy Protocol) e SFTP (SSH File Transfer Protocol). Isso torna o SSH uma solução completa para gerenciar e transferir dados.
• Suporte Amplo e Fácil Configuração: O SSH é amplamente suportado em praticamente todos os sistemas operacionais (Windows, macOS, Linux) e é fácil de configurar. Na maioria dos casos, a única coisa necessária é habilitar o serviço SSH na Raspberry Pi e usar um cliente SSH, como o PuTTY para Windows ou o Terminal para macOS e Linux.
• Eficiência em Projetos de Automação e IoT: Muitos projetos de automação e Internet das Coisas utilizam a Raspberry Pi como um controlador central. O SSH permite monitorar e interagir com a Raspberry Pi sem a necessidade de uma interface física, tornando o gerenciamento remoto mais eficiente e dinâmico.

Materiais e Softwares necessários para a conexão SSH com a Raspberry Pi

Para configurar e utilizar uma conexão SSH com a Raspberry Pi, você precisará de alguns materiais e softwares essenciais. Abaixo, listamos o que é necessário para realizar essa conexão de forma eficiente e segura:

• Raspberry Pi: Qualquer modelo da Raspberry Pi pode ser utilizado, desde os básicos, como a Raspberry Pi Zero 2 W, até os mais recentes, como a Raspberry Pi 5.
• Fonte de Alimentação: Uma fonte de alimentação adequada para o modelo da sua Raspberry Pi. A maioria das Raspberry Pis utilizam uma fonte de 5V com corrente de 3A.
• Cartão microSD: Um cartão microSD de pelo menos 16GB, classe 10.
• Cabo de Rede (opcional): Se a sua Raspberry Pi não tiver Wi-Fi integrado ou se você preferir uma conexão de rede com fio, será necessário um cabo Ethernet para conectá-la ao roteador ou switch de rede.
• Computador ou Dispositivo de Controle: Um PC, laptop, tablet ou smartphone a partir do qual você irá se conectar à Raspberry Pi via SSH.

Para instalar o sistema operacional na Raspberry Pi e configurar a conexão SSH, você precisa instalar o Raspberry Pi Imager. 

Além disso, dependendo do sistema operacional que você estiver usando, você precisará de um software cliente SSH para estabelecer a conexão com a Raspberry Pi. Aqui estão algumas opções populares:

• Windows: Use o PuTTY, um cliente SSH gratuito e amplamente utilizado. Alternativamente, a partir do Windows 10, você pode usar o Windows Terminal ou o PowerShell, que já vêm com o cliente SSH integrado.
• macOS e Linux: O Terminal padrão desses sistemas já possui o cliente SSH embutido. Basta abrir o Terminal e digitar o comando ssh.
• Smartphones (Android/iOS): Aplicativos como Termius ou JuiceSSH permitem que você se conecte via SSH a partir de um dispositivo móvel.

Importante! A Raspberry Pi e o dispositivo de controle (PC, laptop, smartphone) devem estar conectados à mesma rede local (via cabo ou Wi-Fi).

Configurando a conexão SSH no Raspberry Pi Imager

O Raspberry Pi Imager é uma ferramenta oficial e fácil de usar para gravar o sistema operacional no cartão microSD da placa Raspberry Pi. A partir de suas versões mais recentes, o Raspberry Pi Imager também permite configurar diversas opções, incluindo a habilitação da conexão SSH, antes mesmo de iniciar a Raspberry Pi pela primeira vez. Isso facilita o processo de configuração, especialmente para quem deseja utilizar a Raspberry Pi sem monitor ou teclado (modo “headless”).

Abaixo está o passo a passo para habilitar o SSH usando o Raspberry Pi Imager:

Insira o cartão microSD no leitor de cartões do seu computador. Este será o cartão onde o sistema operacional e as configurações SSH serão gravados.

Clique em Choose OS (Escolher SO) e selecione o sistema operacional desejado. Para a maioria dos usuários, a melhor opção é o Raspberry Pi OS Lite (64-bit).

Clique em Choose Storage (Escolher Armazenamento) e selecione o cartão microSD onde o sistema será instalado.

Pressione Ctrl + Shift + X (no Windows ou Linux) ou Cmd + Shift + X (no macOS) para abrir o menu de configurações avançadas do Raspberry Pi Imager. Este menu permite pré-configurar diversas opções, incluindo a habilitação do SSH.

• Marque a opção Set username and password e configure um nome e uma senha para a sua placa Raspberry Pi. Este nome e senha serão usados para a conexão SSH.
• Se você pretende usar a Raspberry Pi via Wi-Fi, marque a opção Configure wireless LAN (Configurar rede sem fio).
• Em Wireless LAN country, selecione o país onde você está utilizando a Raspberry Pi.

• No menu de configurações de serviços, marque a opção Enable SSH (Habilitar SSH).
• Escolha o método de autenticação: Use password authentication (Usar autenticação por senha).

Em seguida, clique em Write (Gravar) e em seguida em Next para iniciar a gravação da imagem do sistema operacional no cartão microSD.

Depois que a gravação estiver concluída, insira o cartão microSD na Raspberry Pi. Conecte a alimentação e a Raspberry Pi irá iniciar com o SSH já habilitado e configurado para uso imediato.

Conectando a Raspberry Pi via SSH

Depois de configurar a placa Raspberry Pi para permitir conexões SSH, o próximo passo é conectar-se a ela usando um cliente SSH a partir do seu computador ou dispositivo móvel. A conexão SSH permite que você acesse o terminal da Raspberry Pi remotamente, possibilitando o controle completo do dispositivo sem precisar de um monitor, teclado ou mouse conectados diretamente a ela.

Obter o Endereço IP da Raspberry Pi

Para se conectar via SSH, você precisa conhecer o endereço IP da sua Raspberry Pi na rede local. Aqui estão algumas maneiras de descobrir o endereço IP:

• Verificar no Roteador: Acesse a interface de administração do seu roteador e procure pela lista de dispositivos conectados. A Raspberry Pi aparecerá com um nome de host semelhante a “raspberrypi”.
• Usar um Scanner de Rede: Aplicativos como Advanced IP Scanner (Windows) ou Fing (Android/iOS) podem escanear a rede e listar todos os dispositivos conectados, incluindo a Raspberry Pi.
• Usar um Monitor Temporário: Se você tiver acesso a um monitor e teclado, conecte-os à Raspberry Pi e, no terminal, digite o comando hostname -I para exibir o endereço IP.

Instalar um Cliente SSH (se necessário):

Dependendo do sistema operacional do seu dispositivo de controle, você pode precisar instalar um cliente SSH:

Windows: Baixe e instale o PuTTY ou use o Windows Terminal ou PowerShell, que possuem um cliente SSH embutido.

MacOS e Linux: O Terminal já possui um cliente SSH integrado, sem necessidade de instalação adicional.

Android/iOS: Instale aplicativos como Termius ou JuiceSSH para se conectar via SSH a partir de dispositivos móveis.

Conectar-se via SSH a partir do Cliente SSH:

Abra o cliente SSH no seu dispositivo de controle e insira o comando de conexão:

ssh [email protected]

Substitua 192.168.10.100 pelo endereço IP real da Raspberry Pi. O pi é o nome de usuário padrão do Raspberry Pi OS, mas você pode substituí-lo por outro usuário, se aplicável.

Na primeira conexão, o cliente SSH solicitará a aceitação da chave de segurança do servidor (Raspberry Pi). Essa chave é uma medida de segurança para garantir que você está se conectando ao dispositivo correto.

Quando solicitado, insira a senha do usuário pi (ou outro usuário configurado). Se você habilitou o SSH usando o Raspberry Pi Imager, use a senha definida durante a configuração.

Depois de inserir a senha corretamente, você terá acesso ao terminal da Raspberry Pi. Agora, você pode executar comandos, instalar software, atualizar o sistema e realizar outras tarefas administrativas remotamente.

Use os comandos abaixo para testar a conexão SSH e também para atualizar o sistema Raspberry Pi OS:

sudo apt-get update
sudo apt-get upgrade

Soluções de problemas comuns na conexão SSH

Embora o SSH seja uma maneira conveniente e segura de acessar sua Raspberry Pi remotamente, é possível encontrar alguns problemas durante a configuração ou ao tentar se conectar. Abaixo estão algumas das dificuldades mais comuns ao usar SSH na Raspberry Pi, junto com suas soluções:

SSH Raspberry Pi: Connection Refused

Causa: Esse erro geralmente ocorre quando o serviço SSH não está habilitado ou não está em execução na Raspberry Pi.

Soluções:

• Verificar se o SSH está habilitado: Certifique-se de que o SSH esteja habilitado na Raspberry Pi. Você pode inserir o cartão microSD em outro computador e adicionar um arquivo vazio chamado ssh na partição /boot.
• Reiniciar o serviço SSH: Se você tiver acesso físico à Raspberry Pi, conecte um teclado e um monitor e execute o comando sudo systemctl restart ssh para reiniciar o serviço SSH.
• Verificar o endereço IP: Certifique-se de que está usando o endereço IP correto da Raspberry Pi.

SSH Raspberry Pi: “No Route to Host”

Causa: Esse erro indica que o cliente SSH não consegue alcançar a Raspberry Pi na rede. Pode ser causado por problemas de conectividade de rede.

Soluções:

• Verificar a Conexão de Rede: Verifique se a Raspberry Pi está conectada corretamente à rede (via Wi-Fi ou Ethernet) e se o roteador ou switch está funcionando corretamente.
• Testar a Conectividade com um Ping: No seu dispositivo de controle, execute ping <endereço_ip_da_raspberry_pi> para verificar se o dispositivo responde.
• Verificar o Endereço IP: A Raspberry Pi pode ter mudado de endereço IP. Consulte a interface do roteador ou use um scanner de rede para confirmar o endereço IP correto.

SSH Raspberry Pi: Permission Denied

Causa: Este erro ocorre quando as credenciais (nome de usuário ou senha) estão incorretas ou quando o usuário não tem permissão para acessar o sistema.

Soluções:

• Verificar Nome de Usuário e Senha: Certifique-se de que o nome de usuário (pi, por exemplo) e a senha estejam corretos. Lembre-se de que a senha é sensível a maiúsculas e minúsculas.
• Alterar a Senha de Usuário: Se você esqueceu a senha, será necessário acessar a Raspberry Pi diretamente (com monitor e teclado) para redefini-la usando o comando passwd.
• Reconfigurar Permissões: Se estiver usando autenticação por chave SSH, certifique-se de que as permissões dos arquivos ~/.ssh/authorized_keys estejam corretas (deve ser lido e escrito apenas pelo usuário).

SSH Raspberry Pi: Host Key Verification Failed

Causa: Esse erro ocorre quando a chave de segurança da Raspberry Pi muda, geralmente após uma nova instalação do sistema operacional ou uma alteração na configuração de rede.

Soluções:

• Remover a Chave SSH Antiga: No seu dispositivo de controle, edite o arquivo ~/.ssh/known_hosts e remova a linha correspondente ao endereço IP da Raspberry Pi. Alternativamente, use o comando:
  

ssh-keygen -R <endereço_ip_da_raspberry_pi>

• Aceitar a Nova Chave: Tente conectar novamente via SSH e aceite a nova chave.

SSH Raspberry Pi: Too Many Authentication Failures

Causa: Esse erro ocorre quando há tentativas excessivas de autenticação falhas, frequentemente devido ao uso de múltiplas chaves de SSH.

Soluções:

• Especificar a Chave SSH Correta: Use o comando ssh -i /caminho/para/sua_chave_privada pi@<endereço_ip_da_raspberry_pi> para especificar qual chave usar.
• Redefinir as Tentativas de Login: No servidor SSH (Raspberry Pi), você pode ajustar o número de tentativas permitidas no arquivo de configuração /etc/ssh/sshd_config com a opção MaxAuthTries.

Raspberry Pi não Conecta via SSH após Atualização

Causa: Às vezes, após uma atualização do sistema operacional, o SSH pode ser desativado ou configurado incorretamente.

Soluções:

• Verificar se o SSH está Habilitado: Certifique-se de que o serviço SSH ainda está habilitado. Se necessário, habilite-o novamente.
• Revisar as Configurações de Firewall: Certifique-se de que as configurações de firewall (ufw ou outro) permitem conexões na porta SSH (22 por padrão).

SSH Lento ou Demorado para Conectar

Causa: A conexão SSH pode estar lenta devido a problemas de DNS reverso ou configuração inadequada de rede.

Soluções:

• Desabilitar a Busca de DNS Reverso: No servidor SSH (Raspberry Pi), abra o arquivo de configuração com sudo nano /etc/ssh/sshd_config e adicione UseDNS no. Em seguida, reinicie o SSH com sudo systemctl restart ssh.
• Verificar a Qualidade da Rede: Certifique-se de que sua rede local não está congestionada e que a conexão da Raspberry Pi é estável.