Here is my homelab

Considero genuinamente que tener un homelab, es la manera perfecta para poder aprender sobre tecnologia de infraestructura de manera practica, y esto por defecto provee muchas ventajas. Si nunca ha escuchado el termino, pues es el concepto de correr servers desde tu casa. Y bueno, un server es una computadora que correr 24/7 el cual se tiene conectado a un red, y la mayoria de las veces, este no tiene ningun tipo de interfaz grafica comun del sistema operativo en cuestion.

Me gustaria comentarles en una eventualidad cuales son las ventajas de tener un homelab, y todas sus ventajas, pero mantegamos eso al margen. En este espacio les quiero comentar como se encuentra disenado mi homelab.

Hardware

Este es el hardware que tengo en este momento.

Arquitectura general

Al final, todo depende de mi Router, el cual estoy usando un Xiaomi AX9000. Estoy contenplando en cambiarlo por otro router que tengo que hace poco me compre para experimentar, un Netgear Nighthawk AX6.

flowchart TB
    subgraph Internet
        CF[Cloudflare Tunnels]
    end

    subgraph LAN
        direction TB
        router[Xiaomi AX9000]
        rpi[Raspberry Pi]
        nfs[NFS Share]
        nav[Navidrome]
        syn[Syncthing]
        frs[FreshRSS]
        frg[Forgejo]
        vel[Velero Backups]
        tail[Tailscale]
        tra[Traefik Ingress]
        flux[FluxCD]
        apps[Apps]
        csi[NFS CSI Driver]
    end

    CF --> tra
    router --> rpi
    router --> nav
    router --> flux
    router --> tail
    nfs --> csi
    apps --> vel

El cluster: K3s

Uso K3s en un solo nodo. No es HA, pero para un homelab personal es más que suficiente. Lleva ~600 días prendido y con workflows encima y nunca me ha dejado tirado.

flowchart LR
    subgraph GitOps["GitOps repo"]
        repo["github.com/fcosanabria/homelab"]
    end

    subgraph Cluster["K3s Cluster"]
        flux["FluxCD"]
        apps["Apps Kustomization"]
        drivers["Drivers Kustomization"]
        monitoring["Monitoring Kustomization"]
    end

    repo -->|ssh| flux
    flux --> apps
    flux --> drivers
    flux --> monitoring
    drivers -->|nfs-csi| NAS["ASUSTOR NAS"]

Cuando estuve usando el segundo nodo, este lo usaba con Talos, el cual me gustaba muchisimo usarlo. Pero tener dos nodos, me parecia un poco innecesario, entonces lo tenia apagado la mayoria de las veces, hasta que decidi quitarlo de la rotacion nada mas. El plan a corto plazo es migrar el nodo que tengo con K3S a Talos Linux.

Una de las cosas que me gusta con respecto al menejo de los secretos usando SOPS y AGE, es que FluxCD por diseno es compatible con el uso de los secretos de esta manera. Y la verdad es que es bastante facil usar los secretos asi; ya que no tengo que depender de ningun secret manager para poder transportar mis secretos. Por que los puedo tener en GitHub, y no me importa, por que estan encriptados, solamente el cluster tiene el secreto para desencriptar. De nuevo, es lo que me sirve, y me parece efectivo. En algun momento donde logre tener mas infraestructura en casa, puedo empezar a implementar algun secret manager.

Storage

K3s trae local-path-provisioner por defecto, pero mis apps necesitan persistencia compartida y respaldable. Para eso uso NFS CSI Driver v4.9.0 que monta un share del NAS ASUSTOR:

storageClassName: nfs-csi
parameters:
  server: 192.168.31.7
  share: /volume1/Public
  mountOptions:
    - hard
    - nfsvers=4

Nota: El NAS está en 192.168.31.7 y el cluster en .116. Ambos están en la misma LAN detrás del router Xiaomi.

Exposición a internet

No abro puertos, por eso una de las cosas que mas me gustaba de Talos Linux, era que ni siquiera el puerto SSH estaba abierto, pero bueno ese es otro tema. Aqui todo entra por Cloudflare Tunnels. Cada app que quiero exponer tiene su propio cloudflared deployment dentro de su namespace, apuntando a un hostname como fit.fcosanabria.com, habits.fcosanabria.com, etc.

Por ahora no uso Tailscale en el cluster. Cloudflare cubre todo lo que necesito.

Aplicaciones en el cluster

Tengo que admitir que una de las mejores decisiones que hice, fue dejar de depender de servicios en la nube para manejar mi calendario y mis contactos. Lo hice relativamente hace poco, y me arrepiendo de no haberlo hecho antes. Ya no depende de Google Calendar o iCloud para el manejo de esas cosas. Ahora, puedo usar CalDAV en cualquier lado, con cualquier aplicacion que quiera, sabiendo que esa informacion solo se encuentra en mi control.

El NAS: ASUSTOR AS5402T

El NAS no es solo storage. También corre servicios que no necesitan estar en Kubernetes:

El NAS vive fuera del cluster. Tailscale me permite llegar a la LAN y al NAS sin abrir puertos. En el cluster, Cloudflare Tunnels hacen el mismo trabajo para las apps públicas. Me gusta pensar que el NAS lo tengo para backup y para cosas que no me interesan tener en el internet.

Backups con Velero

Uso Velero para hacer snapshots de los PVCs del cluster. Los backups se almacenan en el NAS. Esto me permite recuperar el estado de cualquier app si se rompe el cluster o si necesito migrar. Lo que he estado tratando de hacer, incluso para mi propio aprendizaje es hacer que las apps use postgre si es posible y mantener una copia de las bases de datos en el NAS y despues en la nube. Esto con el fin de poder sacar metricas interesantes para mi instancia de Grafana.

Red y DNS

• Router principal: Xiaomi AX9000 (192.168.31.1)
• Router ISP: OEM dado por el vendor (192.168.1.1) - en modo bridge

¿Qué sigue?

• Especificar el rol de la Raspberry Pi
• Documentar la estrategia de Velere con más detalle
• Considerar si en algún momento agregar un segundo nodo al cluster
• Evaluar si Tailscale dentro de K8s tiene algún caso de uso futuro

Última actualización: 2026-06-25