Acesso
- Abra o URL do PdfDing:
https://<SERVER-IP> - É usado um certificado SSL autoassinado, pelo que é normal surgir um aviso do browser na primeira visita.
- Registe-se para criar a sua primeira conta.
Controlar o registo
O registro de usuários está habilitado por padrão.
Para desativar os registos de novos utilizadores, edite:
nano /root/pdfding/.env
Definir:
DISABLE_USER_SIGNUP=TRUE
Aplicar as alterações:
cd /root/pdfding
docker compose up -d
Conta de administrador
Os utilizadores administradores podem ver e eliminar utilizadores.
Criar um utilizador administrador é opcional. Para conceder privilégios de administrador a um utilizador existente, execute o seguinte comando no servidor:
docker exec -it pdfding python pdfding/manage.py make_admin -e YOUR_EMAIL
Os utilizadores administradores também podem conceder privilégios de administrador a outros utilizadores através da UI.
Em alternativa, crie diretamente uma nova conta de administrador:
docker exec -it pdfding python pdfding/manage.py createsuperuser
Ficheiros e diretórios importantes
- Caminho de instalação:
/root/pdfding - Arquivo de composição:
/root/pdfding/docker-compose.yml - Ficheiro de ambiente:
/root/pdfding/.env - Volume de banco de dados:
/var/lib/docker/volumes/pdfding_sqlite_data - Volume de media:
/var/lib/docker/volumes/pdfding_media - Configuração Nginx:
/etc/nginx/sites-available/pdfding - Certificado SSL:
/etc/nginx/ssl/pdfding.crt - Chave privada SSL:
/etc/nginx/ssl/pdfding.key
Gestão de serviços
Ver containers em execução:
docker compose -f /root/pdfding/docker-compose.yml ps
Reinicie o PdfDing:
docker compose -f /root/pdfding/docker-compose.yml restart
Veja os registos do PdfDing:
cd /root/pdfding && docker compose logs -f
Pare o PdfDing:
docker compose -f /root/pdfding/docker-compose.yml stop
Inicie o PdfDing:
docker compose -f /root/pdfding/docker-compose.yml start
Recrie o PdfDing:
docker compose -f /root/pdfding/docker-compose.yml up -d
Verificar status do Nginx:
systemctl status nginx
Reiniciar Nginx:
systemctl restart nginx
Recarregar 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/pdfding 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/pdfding e atualize as ssl_certificate e ssl_certificate_key diretivas para usar o seu certificado Let's Encrypt.
Before:
ssl_certificate /etc/nginx/ssl/pdfding.crt;
ssl_certificate_key /etc/nginx/ssl/pdfding.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 /root/pdfding/.env e atualize HOST_NAME de <SERVER_IP> pelo seu domínio (por exemplo, HOST_NAME=yourdomain.com).
8. Recriar os serviços:
cd /root/pdfding && docker compose up -d
9. Aceda ao PdfDing em https://yourdomain.com.
