
baduy.org es la puerta de entrada a todo lo que corre en el servidor de casa: una página estática que lista y describe los 25 servicios publicados con Cloudflare Tunnel. Esta entrada documenta cómo funciona por dentro, por qué revive solo tras un reinicio y cómo agregar servicios nuevos sin romper nada.
🧭 ¿Qué es el portal?
Es el directorio Baduy System: una sola página HTML —sin framework, sin base de datos, sin proceso de build— que funciona como índice de todos los proyectos y servicios montados en el servidor Ubuntu.
Cada servicio aparece como una tarjeta con su icono, subdominio, descripción corta y una etiqueta de acceso (público, login, admin, CDN…). El botón Detalle abre una ventana modal con la descripción completa, las tecnologías que usa, el puerto interno y notas adicionales.
Todo vive en un único archivo: /var/www/portal/index.html — estructura (tarjetas), estilos (CSS embebido) y comportamiento (JavaScript) juntos, sin dependencias externas.
🏗️ Arquitectura
| Componente | Detalle |
|---|---|
| Página | HTML/CSS/JS estático en un solo archivo (index.html) |
| Ubicación | /var/www/portal en el servidor Ubuntu |
| Proceso | PM2 portal (servidor estático) en el puerto 3013 |
| Publicación | Cloudflare Tunnel: baduy.org → http://localhost:3013 (configuración remota del túnel) |
| Respaldo | Repositorio GitHub privado AppMenuServidor |
| Analíticas | Cloudflare Web Analytics (sin código en la página) |
Como el proceso solo entrega archivos estáticos, los cambios al HTML aplican al instante: se edita el archivo, se recarga el navegador y listo. No hace falta reiniciar PM2 ni el túnel.
🗂️ Qué contiene el portal
Los 25 servicios se agrupan en cinco categorías, cada una con su color distintivo:
| Categoría | Servicios incluidos |
|---|---|
| Negocio y ventas Ámbar #f59e0b · 3 servicios | Desechables GAKI, Inventario Tienda, Lista Súper |
| Finanzas y administración Verde #10b981 · 3 servicios | OrganiGastos 2, OrganiGastos (v1), Mutualista |
| Productividad y herramientas Púrpura #8b5cf6 · 8 servicios | Chat IA, n8n, code-server, Excalidraw, Archivos compartidos, Mi Rutina, Manuales, Servidor IA |
| Contenido y medios Azul claro #38bdf8 · 4 servicios | Blog Baduy Dev, Biblioteca, Fotos, Efectos de sonido |
| Infraestructura Gris #94a3b8 · 7 servicios | CasaOS, Nextcloud, Pi-hole, Terminal web, SSH, Base de datos, Escritorio remoto |
De esos 25, 22 abren directamente en el navegador. Los 3 restantes requieren un cliente especial (SSH, MySQL por TCP y escritorio remoto RDP) y por eso se muestran con estilo atenuado, sin enlace directo.
🎛️ Funciones de la interfaz
- Búsqueda instantánea por nombre, dominio, tecnología o descripción; ignora acentos y la tecla
/enfoca el campo desde cualquier lugar. - Tema claro/oscuro con un clic, recordado en
localStorage. - Ventana de detalle por servicio: descripción larga, chips de tecnologías, ficha técnica (categoría, acceso, puerto interno) y nota 💡 cuando aplica.
- Estados visuales: tarjetas con etiquetas de acceso y las categorías colapsan solas cuando la búsqueda no encuentra nada en ellas.
- Responsive y con soporte de
prefers-reduced-motionpara respetar las preferencias del sistema.
♻️ Auto-arranque: por qué revive solo
Si el servidor se reinicia por un corte de luz o una actualización, la página de baduy.org se levanta sola, sin intervención manual. Lo garantizan tres piezas:
| Pieza | Qué hace |
|---|---|
pm2-baduy-dev.service | Servicio systemd enabled: arranca PM2 al encender el servidor y levanta todas las apps del usuario desde su dump. |
Dump de PM2 (pm2 save) | Lista de procesos que PM2 revive; ya incluye el proceso portal. |
cloudflared.service | Servicio systemd enabled: levanta el túnel de Cloudflare y publica todos los subdominios, incluido baduy.org. |
Regla práctica: cada vez que se agregue o cambie un proceso en PM2, correr pm2 save para que el dump quede actualizado y el servicio reviva en el siguiente arranque.
🐙 Respaldo en GitHub
El código del portal vive en el repositorio privado AppMenuServidor de la cuenta Baduycito, rama main. Contiene el index.html, el logo, el favicon y el .gitignore (el respaldo de la configuración del túnel queda fuera del repo a propósito). El flujo para actualizarlo es el mismo de los demás proyectos del servidor:
ssh baduy-tunnel "cd /var/www/portal && git status -sb" ssh baduy-tunnel "cd /var/www/portal && git add -A && git commit -m 'mensaje' && git push"
📊 Analíticas
El portal se mide con Cloudflare Web Analytics, que se activa desde el propio dashboard de Cloudflare (Analytics & Logs → Web Analytics) en modo automático: como el dominio ya pasa por Cloudflare, no hace falta pegar ningún código en la página. No usa cookies ni envía datos a terceros y, a diferencia de Google Analytics, no lo bloquean los bloqueadores de anuncios. El panel muestra visitas, países, rutas y fuentes de tráfico en casi tiempo real.
➕ Cómo agregar un servicio nuevo
Cuando se monta un proyecto nuevo, se agrega al portal en cuatro pasos: 1) dar de alta el subdominio en el túnel desde el dashboard de Cloudflare (Zero Trust → Networks → Tunnels → Public Hostname, apuntando a http://localhost:<puerto>); 2) editar index.html en tres puntos: la tarjeta en el grid de su categoría, la entrada en el objeto DATA y el contador del grupo; 3) verificar que el subdominio y la página responden; 4) commit y push al repo. Los datos que hacen falta son:
| Dato | Ejemplo |
|---|---|
| Nombre | Desechables GAKI |
| Subdominio | gaki.baduy.org |
| Icono y categoría | 🏷️ · Negocio y ventas |
| Descripción corta / larga | línea de la tarjeta / texto del modal |
| Acceso (badge) | público, login, admin, personal, docs, CDN, privado, solo técnico |
| Puerto y tecnologías | 3010 · Node.js, Express, MySQL |
| Nota (opcional) | se muestra como 💡 en el modal |
La entrada en el objeto DATA —que alimenta el modal y la búsqueda— tiene esta forma (ejemplo real de un servicio ya publicado):
gaki: {
icon:'🏷️', title:'Desechables GAKI', host:'gaki.baduy.org', cat:'Negocio y ventas', c:'#f59e0b',
badge:'público', port:'3010', access:'Público (sin login)', url:'https://gaki.baduy.org',
long:'Catálogo público de precios de desechables…',
tech:['Node.js','Express','MySQL','HTML/CSS/JS'],
note:'Los precios salen de la misma base que usa Inventario Tienda.'
},
🧰 Comandos útiles
# Estado del proceso del portal ssh baduy-tunnel "pm2 describe portal" # Guardar la lista de procesos de PM2 (tras agregar una app) ssh baduy-tunnel "pm2 save" # Comprobar que la página responde curl -s -o /dev/null -w "%{http_code}" https://baduy.org # Estado del repo en GitHub ssh baduy-tunnel "cd /var/www/portal && git status -sb && git log --oneline -3"
📌 Notas finales
El hostname baduy.org está dado de alta en la configuración remota del túnel de Cloudflare, así que solo se edita desde el dashboard; el archivo tunnel-config-backup.json de la carpeta es una copia de referencia y puede quedarse desactualizada. Y como el portal es la cara visible de todo el sistema, cada proyecto nuevo que se monte en el servidor debería aparecer ahí: la página es también el inventario vivo de lo que corre en casa.
