Homepage — Panel de inicio personalizado¶

Cuatro paneles de inicio, uno por perfil (familia, empresa, finca, admin). Muestra solo los servicios que te corresponden según tu grupo en Authentik.

Como usuario¶

Qué podrás hacer¶

Acceder a todos tus servicios desde un solo sitio sin recordar URLs
Ver el estado de cada servicio con indicadores de color
Widgets informativos: clima, calendario, últimas fotos
Acceso rápido a las apps más usadas

Cómo se accederá¶

Plataforma	Cómo
Navegador	`https://inicio.sc` (familia)
Navegador	`https://trabajo.sc` (empresa)
Navegador	`https://campo.sc` (finca)
Navegador	`https://atum.sc` (admin)
Ubuntu	Navegador
Android	Navegador
FireTV	No aplica

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Authentik	Detecta el grupo del usuario y redirige al panel correcto
Caddy	Serviría 4 subdominios distintos — uno por perfil
Todos los servicios del catálogo	Enlazados desde los widgets de cada panel

Servicios que lo hacen posible¶

Docker — 4 contenedores homepage (family, work, farm, admin)

Para el administrador (diseño previsto)

Datos del servicio¶


LXC (contenedor ligero de Proxmox)	134 (4 instancias Docker en un solo LXC)
IP	10.10.20.134
Tier	B
Impacto	🟢 Bajo — no crítico, los usuarios pueden usar las URLs directas

Almacenamiento persistente¶


ZFS (sistema de archivos con integridad de datos) dataset	`rpool/datos/homepage`
Montaje en LXC	`/opt/homepage/`
Subdirectorios	`family/` `work/` `farm/` `admin/`
Backup	PBS (sistema de copias de seguridad de Proxmox) diario + config YAML (formato de configuración legible) versionada en Forgejo

Healthcheck¶

curl -s https://inicio.sc
curl -s https://trabajo.sc
curl -s https://campo.sc
curl -s https://atum.sc

Logs y diagnóstico¶

docker logs --tail 100 homepage-family
docker logs --tail 100 homepage-work
docker logs --tail 100 homepage-farm
docker logs --tail 100 homepage-admin

Backup manual¶

zfs snapshot rpool/datos/homepage@manual-$(date +%Y%m%d)

Problemas comunes¶

"No veo un servicio en mi panel": verificar que el usuario está en el grupo correcto de Authentik
"Panel en blanco": verificar que el contenedor está corriendo

Para el arquitecto (diseño previsto)

Relaciones con otros servicios¶

flowchart LR
    Caddy[Caddy LXC 102] -->|ruteo por subdominio| Homepage[Homepage LXC 134]
    Authentik[Authentik LXC 105] -->|forward_auth por grupo| Caddy
    Homepage -->|:3000 family| Family[Panel Familia]
    Homepage -->|:3001 work| Work[Panel Empresa]
    Homepage -->|:3002 farm| Farm[Panel Finca]
    Homepage -->|:3003 admin| Admin[Panel Admin]
    Family --> Services[Servicios de familia]
    Work --> Services2[Servicios de empresa]
    Farm --> Services3[Servicios de finca]
    Admin --> Services4[Servicios de administración]

Configuración de red¶

Bridge	Puerto	Acceso desde
vmbr2	3000	Caddy → inicio.sc
vmbr2	3001	Caddy → trabajo.sc
vmbr2	3002	Caddy → campo.sc
vmbr2	3003	Caddy → atum.sc

En Pi-hole¶

inicio.sc   →  10.10.20.134
trabajo.sc  →  10.10.20.134
campo.sc    →  10.10.20.134
atum.sc     →  10.10.20.134

En Caddy¶

inicio.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.20.134:3000
}
trabajo.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.20.134:3001
}
campo.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.20.134:3002
}
atum.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.20.134:3003
}

En Authentik¶


Provider	Proxy — forward_auth en cada subdominio
Grupos asignados	familia → inicio / empresa → trabajo / finca → campo / admin → atum

Orquestación¶

Componente	Path
Rol Ansible	`roles/homepage/`
Playbook	`deploy-homepage.yml`
Módulo OpenTofu	`modules/homepage/`
Semaphore	Proyecto `homepage`, Template `deploy`
Forgejo Actions	`.forgejo/workflows/homepage.yml`
Repo Forgejo	`infra-core/`
Ficha versionada	`docs/fichas/programas/homepage.md`

Captura de pantalla¶

Homepage — Panel de inicio personalizado

📸 Pendiente de captura desde la instancia en producción. Sustituye esta imagen por una captura real de https://inicio.sc.

Secciones relacionadas¶

🌐 Enlaces de interés¶

Sitio oficial · Documentación · GitHub