Baduy Dev Tecnología baduy.org: manual del portal Baduy System

baduy.org: manual del portal Baduy System

Logo del portal Baduy System

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

ComponenteDetalle
PáginaHTML/CSS/JS estático en un solo archivo (index.html)
Ubicación/var/www/portal en el servidor Ubuntu
ProcesoPM2 portal (servidor estático) en el puerto 3013
PublicaciónCloudflare Tunnel: baduy.org → http://localhost:3013 (configuración remota del túnel)
RespaldoRepositorio GitHub privado AppMenuServidor
AnalíticasCloudflare 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íaServicios 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-motion para 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:

PiezaQué hace
pm2-baduy-dev.serviceServicio 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.serviceServicio 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:

DatoEjemplo
NombreDesechables GAKI
Subdominiogaki.baduy.org
Icono y categoría🏷️ · Negocio y ventas
Descripción corta / largalínea de la tarjeta / texto del modal
Acceso (badge)público, login, admin, personal, docs, CDN, privado, solo técnico
Puerto y tecnologías3010 · 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.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Related Post