Sistema web para gerenciamento de configurações do Traefik via interface gráfica e API REST.
Tutorial completo no blog da Techify: Traefik Manager: economize IPs públicos e gerencie SSL Termination e Passthrough com interface gráfica
- Interface web intuitiva para gerenciamento de domínios
- API REST completa com autenticação Bearer Token
- Gerenciamento de configurações YAML do Traefik
- Sistema de logs de auditoria
- Autenticação por sessão para interface web
- PHP 7.4 ou superior
- Servidor web (Apache/Nginx)
- Node.js 18+ e npm para compilar o frontend React
- Acesso de escrita ao diretório de configurações do Traefik
- Biblioteca YAML do PHP (php-yaml)
- Clone o repositório:
git clone <repository-url>
cd traefik-manager- Configure as permissões:
chmod 755 /var/www/html/traefik-manager
mkdir -p logs
chmod 755 logs- Copie e configure o arquivo de configuração:
cp config.example.php config.php
nano config.php-
Edite o
config.phpe configure:ADMIN_USER: Usuário de loginADMIN_PASS: Senha do administradorAPI_BEARER_TOKEN: Token para acesso à API (gere um seguro)TRAEFIK_CONFIGS_PATH: Caminho para os arquivos de configuração do Traefik
-
Compile o frontend React para produção:
./build-frontend.shOu manualmente:
cd frontend
npm install
npm run build
cd ..Nota: O frontend React é compilado para arquivos estáticos (HTML, CSS, JS) que são servidos diretamente pelo PHP. Você NÃO precisa rodar
npm run devou manter o Node.js em execução em produção. Após executarnpm run build, todos os arquivos necessários estarão na pastafrontend/dist/e serão carregados automaticamente peloindex.php.
- Certifique-se de que o diretório de configurações do Traefik tem as permissões corretas:
chmod 755 /var/www/traefik_configsAcesse via navegador: http://seu-servidor/traefik-manager
O frontend é uma SPA criada com React, Vite e shadcn-ui que é servida como arquivos estáticos pelo PHP. Basta acessar o endereço acima após realizar o build.
Importante: A aplicação está configurada para rodar no subdiretório /traefik-manager. Se você instalou em um caminho diferente, será necessário:
- Ajustar o
BASE_PATHem frontend/src/config.ts - Ajustar o
BASE_PATHem frontend/vite.config.ts - Recompilar o frontend com
./build-frontend.sh
Se você estiver desenvolvendo o frontend, pode executar o servidor de desenvolvimento do Vite:
cd frontend
npm install
npm run devO Vite será executado em http://localhost:5173 com hot-reload. Configure um proxy/reverse proxy para encaminhar as chamadas /api para o backend PHP.
Importante: Em produção, use apenas o build compilado (npm run build). Não é necessário rodar o servidor de desenvolvimento.
A API está disponível em: http://seu-servidor/traefik-manager/api/
Documentação completa da API disponível na interface em API Docs ou diretamente via API-DOCUMENTATION.md.
Exemplo de uso:
curl -X GET "http://seu-servidor/traefik-manager/api/domains.php" \
-H "Authorization: Bearer seu-token-aqui"- O arquivo
config.phpcontém credenciais sensíveis e NÃO deve ser commitado ao Git - Use sempre HTTPS em produção
- Altere as credenciais padrão imediatamente após a instalação
- Gere um Bearer Token forte e único
traefik-manager/
├── api/ # Endpoints da API REST
├── includes/ # Arquivos auxiliares (auth, logger, etc)
├── logs/ # Logs de auditoria
├── frontend/ # Aplicação React (Vite + shadcn-ui)
├── templates/ # Templates YAML
├── config.php # Configuração (não versionado)
├── config.example.php # Exemplo de configuração
├── index.php # Interface principal
└── login.php # Página de login
Propriedade da Techify - Uso interno
Para suporte e questões, entre em contato com a equipe de desenvolvimento da Techify.
Mantido por Techify — leia mais em techify.one/blog.