Índice:

• Introdução
• Instale o sistema operacional no Raspberry Pi 5
• Conecte-se ao Raspberry Pi via SSH
• Preparar envase
• Criar e executar o bot
• Mantenha o bot rodando em segundo plano usando tmux
• Iniciar automaticamente o bot na inicialização (opcional)

Introdução

Em meu artigo anterior, demonstrei como criar e executar um Telegram Bot usando Python. Você pode encontrá-lo aqui

Neste guia, orientarei você na hospedagem do seu bot do Telegram em seu próprio servidor Raspberry Pi.

Instale o sistema operacional no Raspberry Pi 5

Siga este guia para criar uma imagem com Raspberry Pi Imager.

Eu recomendo escolher o Raspberry Pi OS Lite OS porque é a melhor opção em termos de simplicidade leve.

Nas configurações do imager, marque a caixa ao lado de Ativar SSH e selecione usar autenticação por senha. Isso permitirá que você se conecte ao Raspberry Pi via SSH.

Depois de criar a imagem em uma unidade flash USB, insira o cartão flash em seu Raspberry Pi e ligue-o.

Conecte-se ao Raspberry Pi via SSH

1. Abra o console (cmd ou PowerShell no Windows)
2. Faça ping em seu Raspberry Pi com o seguinte comando:

ping raspberrypi.local

Você receberá estatísticas de ping junto com o endereço IP do seu Raspberry Pi.

1. Use este endereço IP para se conectar via SSH:

SSH pi@ (for example: SSH [email protected])

1. Digite a senha (o padrão é framboesa). Eu recomendo fortemente mudar isso mais tarde.
2. Se a senha estiver correta, você será conectado ao Raspberry Pi via SSH.

Preparar Envio

1. Atualize seu Raspberry Pi

sudo apt update
sudo apt upgrade

1. Instalar Python Raspberry Pi OS geralmente vem com Python pré-instalado. Verifique se está instalado:

python3 --version

Se o Python não estiver instalado, você pode instalá-lo usando:

sudo apt install python3 python3-pip

1. Configurar um ambiente virtual (opcional, mas recomendado) É uma boa prática criar um ambiente virtual para manter as dependências do seu projeto isoladas:

sudo apt install python3-venv
python3 -m venv telegram-bot-env
source telegram-bot-env/bin/activate

1. Instale a biblioteca Python Telegram Bot

pip install python-telegram-bot --upgrade

Crie e execute o bot

1. Crie um novo arquivo Python usando o editor de texto nano

nano bot.py

1. Escreva o código do seu bot neste novo arquivo _(você pode usar o código do meu artigo anterior). Pressione CTRL O e pressione Enter para salvar as alterações. Para sair pressione CTRL X.
2. Execute o bot

python3 bot.py

Seu bot agora está em execução e você pode testá-lo no Telegram.

No entanto, este método encerrará o bot quando você fechar o terminal.

Para mantê-lo funcionando em segundo plano, podemos usar tmux

Mantenha o bot rodando em segundo plano usando tmux

Crie um script de shell executável para iniciar seu bot

1. Instale o tmux

sudo apt update
sudo apt install tmux

1. Crie um novo script de shell para iniciar seu bot. Você pode nomeá-lo como start_bot.sh

nano start_bot.sh

1. Adicione as seguintes linhas ao script, substituindo bot.py pelo nome do arquivo do bot Python e telegram-bots-env pelo nome do seu ambiente:

#!/bin/bash
source telegram-bots-env/bin/activate
python3 bot.py

1. Salvar e sair (CTRL O, Enter, CTRL X).
2. Torne o script executável:

chmod  x start_bot.sh

Execute o bot via tmux:

1. Inicie uma nova sessão tmux:

tmux new -s my_bot_session

1. Dentro da sessão tmux, execute o script do bot:

./start_bot.sh

1. Desconecte-se da sessão tmux pressionando CTRL B e depois D
2. Reanexe à sessão tmux (se necessário) Para reconectar-se à sessão tmux do seu bot posteriormente, use:

tmux attach -t my_bot_session

Iniciar automaticamente o bot na inicialização (opcional)

Se quiser que seu bot inicie automaticamente na inicialização, você pode usar um serviço systemd. Veja como:

1. Crie um novo arquivo de serviço:

sudo nano /etc/systemd/system/my_bot.service

1. Adicione a seguinte configuração, modificando os caminhos conforme necessário:

[Unit]
Description=My Bot Service

[Service]
ExecStart=/usr/bin/tmux new-session -d -s my_bot_session '/path/to/start_bot.sh'
WorkingDirectory=/path/to/my_bot
User=pi

[Install]
WantedBy=multi-user.target

1. Salve e saia do arquivo.
2. Recarregue o daemon do systemd:

sudo systemctl daemon-reload

1. Ative o serviço para iniciar na inicialização:

sudo systemctl enable my_bot.service

1. Inicie o serviço:

sudo systemctl start my_bot.service