fastpihole

01 — Qué es

fastpihole es un panel que corre en tu red y controla Pi-hole a través de su API v6. La interfaz está hecha con React, Vite, Tailwind y shadcn/ui, y un servidor Express gestiona las sesiones y hace de proxy autenticado hacia Pi-hole.

Está pensado para usarlo desde el móvil: activar o pausar el filtrado, o bloquear un dispositivo, en un toque.

02 — Qué hace

• Filtrado global. Un botón enciende o pausa el filtrado de toda la red.
• Bloqueo por dispositivo. Bloquea y desbloquea el DNS de cada equipo y recuerda su grupo original de Pi-hole, incluidos grupos personalizados como el control parental.
• Estadísticas en vivo. Consultas, bloqueos, tasa de bloqueo y estado del equipo: tiempo encendido, CPU y RAM.
• Acceso con contraseña. Sesiones en el servidor y una contraseña inicial que se cambia desde Ajustes.
• Diez idiomas. Interfaz en inglés por defecto y nueve idiomas más, con selector en Ajustes.
• Vigilante. Un cron reinicia el servidor si deja de responder, y se accede también desde http://pi.hole/fast.

03 — Instalar y usar

git clone https://github.com/DanielMartinezSebastian/fastpihole.git
cd fastpihole
npm install && cp .env.example .env
npm run build && npm start   # http://localhost:20053

04 — Bueno saber

• Necesita Node.js 18 o superior y Pi-hole v6 con la API activada y una contraseña de aplicación (Ajustes → API).
• En la primera visita avisa de que falta el token de la API y lleva directamente a Ajustes para añadirlo.