MicroBin

Acesso

Abra o seguinte URL no seu browser: https://<SERVER-IP>

Aceite o aviso do certificado autoassinado e acesse o MicroBin.

Painel de administração

A interface de administração está disponível em: https://<SERVER-IP>/admin/

Use as seguintes credenciais:

• Nome de usuário: admin
• Senha: armazenada em /usr/share/microbin/.env as MICROBIN_ADMIN_PASSWORD

Configuração

As configurações do MicroBin podem ser alteradas em: /usr/share/microbin/.env

Depois de modificar a configuração, reinicie a aplicação:

cd /usr/share/microbin
docker compose up -d

Ficheiros e diretórios importantes

• Caminho de instalação: /usr/share/microbin
• Arquivo Compose: /usr/share/microbin/compose.yaml
• Arquivo de ambiente: /usr/share/microbin/.env
• Volume de dados: /var/lib/docker/volumes/microbin_microbin_data
• Configuração do Nginx: /etc/nginx/sites-available/microbin

Gestão de serviços

Ver os contêineres em execução:

docker compose -f /usr/share/microbin/compose.yaml ps

Reinicie o MicroBin:

docker compose -f /usr/share/microbin/compose.yaml restart

Ver os logs do MicroBin:

cd /usr/share/microbin && docker compose logs -f

Pare o MicroBin:

docker compose -f /usr/share/microbin/compose.yaml stop

Inicie o MicroBin:

docker compose -f /usr/share/microbin/compose.yaml start

Recrie o MicroBin:

docker compose -f /usr/share/microbin/compose.yaml up -d

Verificar o status do Nginx:

systemctl status nginx

Reiniciar o Nginx:

systemctl restart nginx

Recarregar o Nginx:

systemctl reload nginx

Valide a configuração do Nginx:

nginx -t

Ativar o HTTPS com um domínio

1. Aponte o seu domínio para o IP do servidor.

2. Editar /etc/nginx/sites-available/microbin e substitua ambas server_name _; diretivas pelo seu domínio (por exemplo, server_name yourdomain.com;).

3. Instalar o Certbot:

apt install -y certbot python3-certbot-nginx

4. Obtenha um certificado Let's Encrypt:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Edite /etc/nginx/sites-available/microbin e atualize as ssl_certificate e ssl_certificate_key diretivas para usar o seu certificado Let's Encrypt.

Before:
    ssl_certificate /etc/nginx/ssl/microbin.crt;
    ssl_certificate_key /etc/nginx/ssl/microbin.key;
After:
    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Recarregue o Nginx para aplicar as alterações:

systemctl reload nginx

7. Edite /usr/share/microbin/.env e atualize MICROBIN_PUBLIC_PATH de https://<SERVER_IP>/ pelo seu domínio (por exemplo, export MICROBIN_PUBLIC_PATH=https://yourdomain.com/).

8. Recriar os serviços:

cd /usr/sahre/microbin && docker compose up -d

9. Acesse o MicroBin em https://yourdomain.com.

Notas

• Recriar o serviço pode afetar os itens existentes.
• Manter o .env em segurança, pois contém valores de configuração sensíveis.