Cómo autohospedar Homer en un VPS (Guía completa)

Homer es una aplicación web estática ligera que te permite crear un panel personalizado para tus aplicaciones autohospedadas. Esta guía cubrirá los pasos para autohospedar Homer en un servidor privado virtual (VPS). Te guiaremos a través de la instalación de Docker, la obtención de la imagen de Homer y su configuración para que la uses.

Elegir un proveedor de VPS

Antes de sumergirnos en la instalación, necesitas elegir un proveedor de VPS. A continuación se presenta una comparación de algunas opciones populares que podrías considerar:

Para esta guía, recomendamos Hetzner Cloud por su asequibilidad y características. Consulta la comparación completa de VPS para más opciones.

Requisitos previos

1. Un VPS con al menos 1 GB de RAM y sistema operativo Ubuntu o Debian.
2. Conocimientos básicos de SSH y Docker.
3. Un nombre de dominio apuntando a tu VPS (opcional pero recomendado para acceder a tu panel de Homer).

Paso 1: Actualiza tu VPS

Haz SSH en tu VPS:

ssh user@tu_ip_vps

Asegúrate de que tu sistema esté actualizado:

sudo apt update && sudo apt upgrade -y

Paso 2: Instalar Docker

Necesitas instalar Docker para ejecutar la aplicación Homer. Aquí te mostramos cómo:

Instalar Docker

Ejecuta los siguientes comandos:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Verificar la instalación de Docker

Verifica si Docker está instalado correctamente:

sudo systemctl start docker
sudo systemctl enable docker
sudo docker --version

Si se instaló correctamente, se mostrará la versión de Docker.

Paso 3: Desplegar Homer

Ahora es el momento de desplegar Homer. Crea un directorio para Homer:

mkdir -p ~/homer
cd ~/homer

Obtener la imagen de Docker de Homer

Puedes obtener la imagen más reciente de Homer usando el siguiente comando:

sudo docker pull b4bz/homer:latest

Crear un archivo de configuración

Crea un archivo de configuración por defecto:

curl -o config.yml https://ghproxy.com/https://raw.githubusercontent.com/b4bz/homer/master/config.yml

Edita el archivo config.yml para personalizar tu panel:

nano config.yml

Haz los cambios según sea necesario, enfocándote en los enlaces y títulos de tus aplicaciones autohospedadas.

Ejecutar el contenedor Docker de Homer

Ahora, es el momento de ejecutar el contenedor de Homer:

sudo docker run -d \
  --name homer \
  -p 8080:8080 \
  -v ~/homer/config.yml:/www/assets/config.yml \
  b4bz/homer:latest

Homer será accesible en http://tu_ip_vps:8080. Si lo has mapeado a un dominio, usa eso en su lugar.

Paso 4: Configuración del proxy inverso (opcional)

Para hacer que Homer sea accesible a través de una URL más elegante, configura un proxy inverso. Recomendamos usar Nginx o Traefik para esto.

Instalar Nginx

sudo apt install nginx -y

Configurar Nginx

Crea un nuevo archivo de configuración para Homer:

sudo nano /etc/nginx/sites-available/homer

Agrega la siguiente configuración, reemplazando tu_dominio.com:

server {
    listen 80;
    server_name tu_dominio.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Habilita la configuración:

sudo ln -s /etc/nginx/sites-available/homer /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Ahora, accede a Homer a través de tu nombre de dominio sin especificar el puerto.

Preguntas frecuentes

¿Puedo personalizar el panel de Homer?

Sí, el panel de Homer es altamente personalizable. Puedes editar el archivo config.yml para cambiar el nombre y la URL de cada enlace de aplicación. Agrega logotipos o íconos para representar cada servicio de manera más visual. Para configuraciones complejas, consulta la documentación de Homer en GitHub.

¿Qué hago si enfrento problemas al instalar Docker?

Si enfrentas problemas durante la instalación de Docker, asegúrate de que tu servidor sea compatible y que tengas la última versión de las actualizaciones del sistema Ubuntu o Debian. Verifica la guía de solución de problemas oficial de Docker para errores comunes. Además, la configuración de firewall personalizada puede afectar la conectividad: asegúrate de que se permita el acceso saliente a los repositorios de Docker.

¿Qué tan seguro es autohospedar aplicaciones como Homer?

Autohospedar aplicaciones requiere medidas de seguridad. Asegúrate de que tu VPS funcione con un firewall: UFW es una excelente opción para Ubuntu. Actualiza regularmente tus aplicaciones y el sistema operativo subyacente para prevenir vulnerabilidades. Si expones tu panel a Internet, considera implementar HTTPS usando Let’s Encrypt para cifrar las transferencias de datos.

Siguiendo esta guía, puedes autohospedar efectivamente Homer en un VPS, dándote acceso rápido a tus aplicaciones favoritas en un único panel conveniente. ¡Feliz autohospedaje!