Instalación de FreshRSS en

Configuración

Después de instalar todos los componentes, es necesario configurarlos correctamente para que FreshRSS pueda funcionar.

1. Configuración de Caddy

Caddy utiliza el archivo Caddyfile para su configuración. Lo configuraremos para servir FreshRSS y obtener automáticamente certificados SSL.

# Открытие файла Caddyfile для редактирования
sudo nano /etc/caddy/Caddyfile

Elimine todo el contenido existente e inserte lo siguiente, reemplazando yourdomain.com con su nombre de dominio real:

yourdomain.com {
    # Directorio raíz de FreshRSS
    root  /var/www/freshrss/p/

    # Habilitar compresión gzip
    encode gzip

    # Encabezado Strict-Transport-Security para HTTPS
    header {
        Strict-Transport-Security max-age=31536000;
        X-Content-Type-Options nosniff
        X-Frame-Options DENY
        X-XSS-Protection "1; mode=block"
    }

    # Procesamiento de archivos PHP a través de PHP-FPM
    php_fastcgi unix//run/php/php8.3-fpm.sock {
        # Opciones adicionales, si es necesario
    }

    # Protección del directorio data contra acceso directo
    @data {
        path /data/
    }
    respond @data 403

    # Protección del directorio app contra acceso directo
    @app {
        path /app/
    }
    respond @app 403

    # Protección del directorio config contra acceso directo
    @config {
        path /config/
    }
    respond @config 403

    # Reescritura de URL para FreshRSS (controlador frontend)
    try_files {path} {path}/ /index.php?{query}

    # Registro
    log {
        output file /var/log/caddy/freshrss_access.log
        format json
    }

    # Obtención automática de certificados SSL/TLS
    tls {
        # Se puede especificar un correo electrónico para notificaciones de Let's Encrypt
        # email [email protected]
    }
}

# Проверка конфигурации Caddy
sudo caddy validate --config /etc/caddy/Caddyfile

# Перезапуск Caddy
sudo systemctl reload caddy

# Открытие таблицы Cron для редактирования
sudo crontab -u www-data -e

# Actualización de feeds de FreshRSS cada 15 minutos
/15     php /var/www/freshrss/app/actualize_script.php > /dev/null 2>&1

Este comando ejecutará el script de actualización de FreshRSS cada 15 minutos bajo el usuario www-data (bajo el cual se ejecuta PHP-FPM). La redirección de la salida a /dev/null evita que los registros se llenen de mensajes innecesarios.

4. Verificación del funcionamiento

Para asegurarse de que todo funciona correctamente:

• Abra https://yourdomain.com en su navegador y asegúrese de ver la interfaz de FreshRSS.
• Intente añadir algunos feeds RSS y asegúrese de que se actualizan correctamente.
• Verifique los registros de Caddy en busca de errores:

sudo journalctl -u caddy --since "5 minutes ago"

• Verifique los registros de PHP-FPM:

sudo journalctl -u php8.3-fpm --since "5 minutes ago"

• Asegúrese de que la tarea cron se esté ejecutando, verificando la hora de la última actualización de feeds en el panel de administración de FreshRSS.

En este punto, su FreshRSS está completamente configurado y funcionando.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno del servidor son aspectos críticamente importantes para cualquier sistema. FreshRSS almacena todos sus feeds, configuraciones y datos de usuario en la base de datos y el sistema de archivos, por lo que es crucial garantizar su seguridad.

1. Qué respaldar

Para FreshRSS, es necesario respaldar tres componentes principales:

1. Base de datos MariaDB: Contiene todas sus suscripciones, artículos, estados leídos/no leídos, usuarios y sus configuraciones. Este es el componente más importante.
2. Directorio de datos de FreshRSS: /var/www/freshrss/data/. Este directorio contiene los archivos de configuración de FreshRSS, la caché, las configuraciones de usuario y otros datos de servicio que no se almacenan en la BD.
3. Archivos de configuración del servidor web: /etc/caddy/Caddyfile. Guardar la configuración de Caddy permitirá restaurar rápidamente el servidor web en caso de necesidad.

2. Script simple de copia de seguridad automática

Crearemos un script bash simple que realizará la copia de seguridad. Usaremos mysqldump para la base de datos y tar para los archivos.

# Creación del directorio para copias de seguridad
sudo mkdir -p /opt/backups/freshrss
sudo chown freshrssuser:freshrssuser /opt/backups/freshrss

# Creación del script de copia de seguridad
nano /opt/backups/freshrss/backup_freshrss.sh

Pegue el siguiente contenido, reemplazando ВАШ_ПАРОЛЬ_БД con la contraseña del usuario de la base de datos de FreshRSS:

#!/bin/bash

# Variables
BACKUP_DIR="/opt/backups/freshrss"
DATE=$(date +%Y%m%d%H%M%S)
DB_NAME="freshrss_db"
DB_USER="freshrss_user"
DB_PASS="ВАШ_ПАРОЛЬ_БД" # Use una contraseña segura
FRESHRSS_PATH="/var/www/freshrss"
CADDY_CONFIG="/etc/caddy/Caddyfile"

# Creación del volcado de la base de datos
echo "Volcando la base de datos MariaDB..."
mysqldump --user=$DB_USER --password=$DB_PASS $DB_NAME > "$BACKUP_DIR/$DB_NAME-$DATE.sql"

# Archivando el directorio de datos de FreshRSS
echo "Archivando el directorio de datos de FreshRSS..."
tar -czf "$BACKUP_DIR/freshrss_data-$DATE.tar.gz" -C "$FRESHRSS_PATH" data/ config/

# Copiando la configuración de Caddy
echo "Copiando Caddyfile..."
cp "$CADDY_CONFIG" "$BACKUP_DIR/Caddyfile-$DATE.conf"

# Eliminando copias de seguridad antiguas (más de 7 días)
echo "Limpiando copias de seguridad antiguas..."
find "$BACKUP_DIR" -type f -name ".sql" -mtime +7 -delete
find "$BACKUP_DIR" -type f -name ".tar.gz" -mtime +7 -delete
find "$BACKUP_DIR" -type f -name ".conf" -mtime +7 -delete

echo "Copia de seguridad finalizada en $DATE"

chmod +x /opt/backups/freshrss/backup_freshrss.sh

crontab -e

0 3    /opt/backups/freshrss/backup_freshrss.sh >> /var/log/freshrss_backup.log 2>&1

Esto ejecutará el script diariamente y registrará su salida en /var/log/freshrss_backup.log.

3. Dónde almacenar las copias de seguridad

Almacenar las copias de seguridad en el mismo servidor que el sistema en producción es arriesgado. En caso de fallo del servidor (por ejemplo, un fallo de disco), perderá tanto el sistema como las copias de seguridad. Se recomienda utilizar un almacenamiento remoto:

• Servicio externo compatible con S3: AWS S3, DigitalOcean Spaces, Backblaze B2. Para esto, puede integrar s3cmd o rclone en el script de copia de seguridad.
• VPS separado: Si tiene otro VPS, puede configurar rsync o scp para copiar las copias de seguridad allí a través de SSH.
• Ordenador local: Para proyectos muy pequeños, puede descargar periódicamente las copias de seguridad a su ordenador manualmente o mediante un script.

Por ejemplo, para copiar a otro servidor por SSH (después de configurar las claves SSH sin contraseña):

# Añadir al script backup_freshrss.sh después de la archivación
echo "Copiando copias de seguridad al servidor remoto..."
rsync -avz "$BACKUP_DIR/" freshrssuser@REMOTE_IP:/path/to/remote/backups/

4. Actualizaciones: rolling vs. ventana de mantenimiento

Mantener el sistema actualizado es crítico para la seguridad y la estabilidad.

• Actualizaciones del SO (Ubuntu): Ejecute regularmente sudo apt update && sudo apt upgrade -y. Para sistemas de producción, es recomendable hacerlo dentro de una ventana de mantenimiento planificada para evitar fallos inesperados. Para un servidor personal, se puede hacer con más frecuencia.
• Actualizaciones de PHP, MariaDB, Caddy: También se actualizan a través de apt upgrade. A veces, las actualizaciones de estos componentes pueden requerir intervención manual (por ejemplo, la fusión de archivos de configuración).
• Actualizaciones de FreshRSS:
  • A través de Git: Si clonó inicialmente el repositorio de Git, la actualización se reduce a un git pull en el directorio de FreshRSS y luego, posiblemente, a la ejecución de migraciones de la base de datos a través de la interfaz web.
  • A través de la descarga de un archivo: Si instaló FreshRSS desde un archivo ZIP, para actualizarlo, debe descargar la nueva versión, descomprimirla, copiar data/ y config/ de la instalación antigua a la nueva, y luego actualizar los enlaces simbólicos o cambiar el directorio raíz en Caddyfile.

Estrategia recomendada:

1. Realice las actualizaciones en un horario planificado.
2. Antes de actualizaciones importantes (especialmente versiones mayores de PHP o FreshRSS), realice una copia de seguridad completa.
3. Lea los changelogs de los programas a actualizar para estar al tanto de posibles cambios o acciones manuales requeridas.
4. Para FreshRSS, después de actualizar los archivos, acceda siempre a la interfaz web para asegurarse de que no se requiera una migración de la base de datos.

Solución de problemas + Preguntas frecuentes

Esta sección contiene respuestas a preguntas frecuentes y soluciones a problemas típicos que pueden surgir durante la instalación y operación de FreshRSS.

¿Qué configuración mínima de VPS es adecuada?

Para FreshRSS en modo individual o para un pequeño grupo de hasta 5 usuarios con varios cientos de feeds, una configuración mínima de VPS sería 1 vCPU, 1 GB de RAM y 20-30 GB de disco SSD. Esta configuración será suficiente para un funcionamiento estable, pero si aumenta el número de feeds o usuarios, se recomienda aumentar la RAM a 2 GB para un mejor rendimiento de la base de datos y PHP-FPM.

¿Qué elegir: VPS o dedicado para esta tarea?

Para la instalación de FreshRSS, un VPS es casi siempre suficiente. Los servidores dedicados son significativamente más caros y ofrecen recursos excesivos para un agregador RSS, a menos que planee atender a miles de usuarios o integrar FreshRSS en una infraestructura muy grande con otros servicios que consuman muchos recursos. Un VPS ofrece un excelente equilibrio entre rendimiento, flexibilidad y coste para FreshRSS.

¿Por qué veo el error "502 Bad Gateway" en el navegador?

El error "502 Bad Gateway" suele indicar un problema con PHP-FPM. El servidor web (Caddy) no puede comunicarse con PHP-FPM o PHP-FPM no está procesando las solicitudes.

Qué verificar:

• Asegúrese de que PHP-FPM esté en ejecución: sudo systemctl status php8.3-fpm. Si no está activo, intente iniciarlo: sudo systemctl start php8.3-fpm.
• Verifique los registros de PHP-FPM: sudo journalctl -u php8.3-fpm. Busque errores que puedan indicar problemas con la configuración de PHP o falta de memoria.
• Asegúrese de que Caddy esté configurado para el socket PHP-FPM correcto (unix//run/php/php8.3-fpm.sock).

¿Cómo actualizar FreshRSS a una nueva versión?

Si siguió esta guía, FreshRSS se instaló desde un archivo. Para actualizar:

1. Realice una copia de seguridad: Asegúrese de realizar una copia de seguridad completa de la base de datos y del directorio /var/www/freshrss/data.
2. Descargue la nueva versión: Descargue el último archivo ZIP de FreshRSS desde la página de lanzamientos de GitHub.
3. Descomprima: Descomprima el nuevo archivo en un nuevo directorio temporal (por ejemplo, /var/www/freshrss_new).
4. Transfiera los datos: Copie el contenido de los directorios antiguos /var/www/freshrss/data y /var/www/freshrss/config a los directorios correspondientes de la nueva instalación.
5. Actualice los enlaces: Renombre el directorio antiguo /var/www/freshrss (por ejemplo, a freshrss_old) y renombre el nuevo directorio freshrss_new a freshrss.
6. Establezca los permisos: sudo chown -R www-data:www-data /var/www/freshrss && sudo chmod -R 755 /var/www/freshrss.
7. Reinicie Caddy: sudo systemctl reload caddy.
8. Finalice en el navegador: Abra FreshRSS en el navegador. Si se requiere una migración de la base de datos, FreshRSS le ofrecerá realizarla.

Mis feeds no se actualizan automáticamente, ¿qué hago?

Esto es, muy probablemente, un problema con la tarea de Cron.

Qué verificar:

• Asegúrese de que la tarea de Cron para www-data exista y sea correcta: sudo crontab -u www-data -l.
• Verifique que la ruta al intérprete de PHP y al script actualize_script.php sea correcta.
• Asegúrese de que el usuario www-data tenga permisos para ejecutar el script y escribir en los directorios de FreshRSS.
• Verifique los registros del sistema de Cron: sudo grep CRON /var/log/syslog.
• Intente ejecutar el script manualmente como el usuario www-data: sudo -u www-data php /var/www/freshrss/app/actualize_script.php y observe la salida.

¿Cómo añadir un nuevo feed en FreshRSS?

En la interfaz web de FreshRSS, vaya a la sección "Suscripciones" (Subscriptions), luego haga clic en el botón "Añadir feed" (Add feed) o en el icono "+". Inserte la URL del feed RSS en el campo y haga clic en "Añadir". FreshRSS intentará detectar y añadir el feed. También puede especificar una categoría para el nuevo feed.

¿Cómo configurar FreshRSS para acceder a través de una aplicación móvil?

FreshRSS es compatible con la API de Fever, lo que permite usarlo con una multitud de clientes RSS móviles (por ejemplo, Reeder, NetNewsWire, Lire).

1. En FreshRSS, vaya a "Configuración" (Settings) -> "Autenticación" (Authentication).
2. Habilite "API" y seleccione "Fever API" como método.
3. Cree un "Token API" (API Token) para cada cliente o use uno existente.
4. En su aplicación móvil, seleccione "Fever" o "Self-hosted RSS" como fuente e introduzca la dirección de su FreshRSS (https://yourdomain.com/p/api/fever) y el token API.

Conclusiones y próximos pasos

¡Felicidades! Ha instalado y configurado FreshRSS con éxito en su VPS, creando un agregador RSS potente, privado y totalmente controlado. Ahora tiene una herramienta para gestionar eficazmente los flujos de información, que no depende de servicios de terceros y protege su privacidad. Ha dominado no solo la instalación de la aplicación, sino también los principios básicos de configuración del servidor web, la base de datos, PHP, así como la seguridad y las copias de seguridad.

¿Hacia dónde avanzar?

1. Explore la funcionalidad de FreshRSS: Experimente con categorías, filtros, reglas de archivo, integración con otros servicios (por ejemplo, Instapaper o Wallabag para lectura posterior), disponibles en FreshRSS.
2. Optimización y monitoreo: Supervise el consumo de recursos de su VPS con utilidades como htop o grafana. Si es necesario, puede ajustar finamente PHP-FPM o Caddy para un mejor rendimiento o una menor utilización de memoria.
3. Servicios adicionales: Es posible que desee implementar otras aplicaciones self-hosted útiles en su VPS, como el gestor de contraseñas Vaultwarden, el sistema de gestión de proyectos Kanboard o el almacenamiento en la nube personal Nextcloud.