🌐 crom.me
Subdomínios Gratuitos & Túneis HTTP para a Comunidade Crom
O crom.me é uma plataforma open-source que oferece subdomínios gratuitos e túneis HTTP reversos para desenvolvedores, criadores de conteúdo e organizações que fazem parte do ecossistema Crom.
O projeto nasce de uma necessidade real: dar visibilidade a projetos independentes sem o custo de um domínio próprio ou a complexidade de configurar exposição pública para ambientes locais.
| Funcionalidade | Descrição |
|---|---|
| Subdomínios Fixos | Registre *.crom.me com provisionamento automatizado de certificados e roteamento via Cloudflare |
| Edge Tunneling | *-free.crom.me — Exponha portas locais à internet (estilo Ngrok) de forma instantânea via crom-cli |
| Console de Engenharia | Dashboard de controle de cotas, status de comunicação em tempo real e telemetria de requisições do túnel |
| Command Center | Gerenciamento administrativo (Admin Bypass, suspensão de usuários, análise e triagem de malha) |
| API Programática | Interaja com toda a plataforma (provisionamentos, endpoints, status e túnel) de forma programática |
- Democratizar o acesso a subdomínios para a comunidade de desenvolvedores brasileiros.
- Oferecer uma alternativa gratuita ao ngrok via
free.crom.me, com foco em performance e simplicidade. - Manter a segurança e a reputação do domínio principal através de curadoria e conformidade com a LGPD.
- Fomentar a comunidade Crom premiando contribuições com slots adicionais de subdomínios.
| Requisito | Versão Mínima | Finalidade |
|---|---|---|
| Go | 1.22+ | Backend da API, CLI do Túnel e lógica de negócio |
| PostgreSQL | 15+ | Persistência de dados (usuários, domínios, quotas) |
| Cloudflare Account | — | Gerenciamento de DNS via API v4 |
| Git | 2.40+ | Controle de versão |
# Cloudflare
CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ZONE_ID=your_zone_id
# Database
DATABASE_URL=postgres://user:pass@localhost:5432/cromme?sslmode=disable
# Auth
GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_client_secret
# App
APP_SECRET=your_jwt_secret
APP_ENV=developmentcrom-me/
├── cmd/ # Binários (API Server e CLI do Túnel)
│ ├── api/ # Entry point do servidor HTTP
│ └── tunnel/ # Entry point do cliente de túnel
├── internal/ # Lógica de negócio (não exportada)
│ ├── auth/ # OAuth GitHub + JWT
│ ├── cloudflare/ # Wrapper da API Cloudflare v4
│ ├── database/ # Migrations e queries SQL
│ ├── domain/ # Regras de negócio para subdomínios
│ └── tunnel/ # Lógica do túnel reverso
├── web/ # Painel de gerenciamento (Frontend)
│ ├── static/ # CSS, JS, imagens
│ └── templates/ # Templates HTML
├── docs/ # Documentação técnica (você está aqui)
├── go.mod
├── go.sum
└── Makefile
Encontrou um subdomínio sendo usado para phishing ou spam? Abra uma Issue com a tag abuse-report.
- Faça um fork do repositório.
- Crie uma branch para sua feature:
git checkout -b feature/minha-feature. - Faça commit das suas alterações:
git commit -m 'feat: adiciona minha feature'. - Envie um Pull Request para a branch
main.
Dica: Contribuidores ativos ganham slots extras de subdomínios. Veja mais em COMPLIANCE_AND_PARTNERSHIP.md.
Escreva um artigo, faça um vídeo ou poste nas redes sociais sobre como você está usando o crom.me. Isso ajuda o projeto a crescer organicamente.
| Documento | Descrição |
|---|---|
| ARCHITECTURE.md | Arquitetura técnica, stack e fluxos de dados |
| DATABASE.md | Esquema SQL e decisões de modelagem |
| TUNNEL_SPECS.md | Especificações do túnel free.crom.me |
| COMPLIANCE_AND_PARTNERSHIP.md | LGPD, regras de uso e sistema de parcerias |
Este projeto adota a Crom Sustainable Use License (inspirada na licença Fair-Code do n8n). Você é livre para usar, modificar e hospedar o código para uso pessoal ou interno, mas é estritamente proibido revendê-lo ou oferecê-lo como um SaaS comercial sem autorização prévia.
📧 Para discussões sobre licenciamento comercial, entre em contato via: mrj.crom@gmail.com
Veja o texto completo no arquivo LICENSE.
Feito com 🖤 pela Comunidade Crom