Emanuel Almeida
6b3a6f2698
- All SKILL.md files now <500 lines (avg reduction 69%) - Detailed content extracted to references/ subdirectories - Frontmatter standardised: only name + description (Anthropic standard) - New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator - Design skills: anti-slop guidelines, premium-proposals reference - Removed non-standard frontmatter fields (triggers, version, author, category) Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao, core-tools, negocio, perfex-dev, wordpress, design-media Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
5.5 KiB
5.5 KiB
name, description, disable-model-invocation
| name | description | disable-model-invocation |
|---|---|---|
| cwp-email | Gestão de email no CWP — configuração de DKIM, SPF, mail queue e Postfix baseada na documentação oficial. | true |
/cwp-email - Email CWP (Documentação Oficial)
Gestão de email no CWP. Zero assumptions, zero hallucinations - apenas comandos documentados.
REGRA #38 - ZERO INVENCAO: NUNCA improvisar comandos. Verificar estado actual ANTES de alterar. Pesquisar wiki CWP se necessario. Usar APENAS scripts oficiais.
Servidor Alvo
| Servidor | IP | MCP | User |
|---|---|---|---|
| CWP Principal | 176.9.3.158 | ssh-unified | root |
Documentação Base
Documentação Hub (Consultar SEMPRE)
Manuais locais (Hub/06-Operacoes/Documentacao/Manuais/CWP/):
CWP-Manual-Completo.md- Admin Guide (seccao Email: Accounts, DKIM, SPF, Mail Queue, AntiSpam, Policyd) + Wiki (Email & Postfix) - 503KBCWP-Guia-do-Utilizador.md- Painel utilizador (seccao Email Accounts, Auto Responders, Filters, Routing) - 72KBCWP-Ferramentas-Desenvolvimento.md- API Email Admin Server - 82KB
Quick Reference: Hub/06-Operacoes/Documentacao/Quick-Reference/QR-CWP.md
NotebookLM (pesquisa AI sobre toda a documentacao CWP):
mcp__notebooklm__notebook_query notebook_id:"0ded7bd6-69b3-4c76-b327-452396bf7ea7" query:"email dkim spf postfix mail queue spam"
Scripts Oficiais de Email
| Script | Descrição | Uso |
|---|---|---|
/scripts/install_cbpolicyd |
Instala limite de emails por hora | sh /scripts/install_cbpolicyd |
/scripts/check_postqueue |
Verifica mail queue | sh /scripts/check_postqueue |
/scripts/mail_queue_stats |
Estatísticas da mail queue | sh /scripts/mail_queue_stats |
/scripts/mail_roundcube_update |
Actualiza RoundCube | sh /scripts/mail_roundcube_update |
/scripts/mail_vmail_import |
Importa contas de /var/vmail | sh /scripts/mail_vmail_import |
/scripts/mail_rebuild_sni_certs |
Rebuild certificados mail | sh /scripts/mail_rebuild_sni_certs |
DKIM & SPF
Procedimento Documentado
- Rebuild Mail Server via CWP.admin → Postfix Manager (com DKIM & SPF activado)
- Adicionar DKIM key para cada domínio via DKIM Manager
Testar DKIM
# Enviar email para teste
# Destino: check-auth@verifier.port25.com
# Deve receber resposta com "DKIM check: pass"
DKIM 2048 bits (Chave Longa)
Quando adicionar TXT record para DKIM 2048-bit, dividir chave ao meio e envolver ambas as partes em quotes.
Mail Queue Management
Verificar Mail Queue
sh /scripts/check_postqueue
Estatísticas da Queue
sh /scripts/mail_queue_stats
Comandos Postfix (Padrão Linux)
# Ver queue
postqueue -p
# Flush queue (tentar enviar)
postqueue -f
# Ver mensagem específica
postcat -q QUEUE_ID
# Limpar queue (CUIDADO)
postsuper -d ALL
Policyd (Limites de Email)
Instalar
sh /scripts/install_cbpolicyd
Função
Limita emails de entrada e saída por hora por utilizador.
Actualizar Limites (Todos os Utilizadores)
/scripts/cwp_api account update_policyd_all
Rebuild Certificados Mail
# Rebuild certificados Postfix/Dovecot
sh /scripts/mail_rebuild_sni_certs
Corrigir Permissões de Mail
/scripts/cwp_api account mail_fix_permissions
Verificações Anti-SPAM
rDNS (Reverse DNS)
Nota documentada: "rDNS só pode ser configurado pelo provider de hosting - contactar provider."
Blacklist Check
Verificar se IP do servidor está em blacklists:
DMARC
Documentação recomenda configurar records DMARC para melhor autenticação.
Workflows
1. Verificar Mail Queue
# Ver queue
sh /scripts/check_postqueue
# Ver estatísticas
sh /scripts/mail_queue_stats
2. Limpar Mail Queue (Emergência)
# Ver o que está na queue primeiro
postqueue -p | head -50
# Limpar tudo (CUIDADO - emails perdidos)
postsuper -d ALL
3. Rebuild Certificados Mail (Após SSL)
sh /scripts/mail_rebuild_sni_certs
4. Instalar Limites de Email
sh /scripts/install_cbpolicyd
Anti-Patterns (NUNCA FAZER)
| Anti-Pattern | Risco | Alternativa |
|---|---|---|
| Limpar queue sem verificar | Perda de emails | Ver queue primeiro |
| Ignorar blacklists | Emails não entregues | Verificar regularmente |
| DKIM sem testar | Falsa sensação segurança | Testar com verifier |
| Editar postfix directamente | Inconsistência CWP | Usar Postfix Manager |
Validação
Testar Envio
# Enviar email de teste via linha de comandos
echo "Test email" | mail -s "Test Subject" destinatario@example.com
Verificar Logs
# Log de mail
tail -100 /var/log/maillog
Checklist DKIM/SPF
- Mail Server rebuild com DKIM & SPF activo
- DKIM key adicionada para cada domínio
- Testar com check-auth@verifier.port25.com
- Verificar SPF record no DNS
- Verificar DMARC (opcional mas recomendado)
- Verificar blacklists
Versão: 1.0.0 | Autor: Descomplicar® Fonte: wiki.centos-webpanel.com