Instalación y Configuración de Redis

Instalación de software — paso a paso

Instalaremos Redis versión 7.x, que será actual y estable en 2026. Existen dos métodos principales de instalación: desde los repositorios oficiales de Ubuntu o compilando desde el código fuente. Para la mayoría de los usuarios, la instalación desde los repositorios es más sencilla y fiable, proporcionando actualizaciones de seguridad automáticas. Sin embargo, si necesita la versión más reciente o opciones de compilación específicas, la compilación desde el código fuente puede ser preferible. Cubriremos ambas opciones, comenzando con la recomendada.

Opción 1: Instalación de Redis desde los repositorios de Ubuntu (Recomendado)

Este método es sencillo y proporciona una versión estable y probada de Redis. Ubuntu 24.04 LTS, muy probablemente, vendrá con Redis 7.x o una versión más reciente.

Paso 1: Actualización de la lista de paquetes

Asegúrese de que la lista de paquetes esté actualizada para obtener la información más reciente sobre las versiones disponibles de Redis.

sudo apt update
# Actualiza el índice de paquetes de los repositorios

Paso 2: Instalación del servidor Redis

Instale el paquete redis-server. Este comando instalará Redis y todas las dependencias necesarias, y lo configurará como un servicio del sistema.

sudo apt install redis-server -y
# Instala Redis Server y lo inicia automáticamente

Paso 3: Verificación del estado del servicio Redis

Después de la instalación, Redis debería iniciarse automáticamente. Verifiquemos su estado:

sudo systemctl status redis-server
# Verifica si el servicio Redis está en ejecución

La salida debería mostrar "active (running)". Si no es así, intente iniciarlo manualmente:

sudo systemctl start redis-server
# Inicia el servicio Redis

Paso 4: Verificación de la versión de Redis

Asegúrese de que la versión esperada de Redis esté instalada (presumiblemente 7.x).

redis-server --version
# Muestra la versión de Redis instalada

Verá algo como Redis server v=7.x.y sha=...

Paso 5: Verificación de la conexión a Redis

Utilice el cliente redis-cli para verificar la conexión al servidor Redis.

redis-cli ping
# Envía el comando PING al servidor Redis

En respuesta, debería recibir PONG, lo que significa una conexión exitosa.

Opción 2: Compilación de Redis desde el código fuente (Para usuarios avanzados)

Este método permite instalar la versión más reciente de Redis (por ejemplo, Redis 8.x, si está disponible para 2026) o utilizar opciones de compilación específicas. Requiere la instalación de herramientas de compilación.

Paso 1: Instalación de las herramientas de compilación necesarias

Instale los paquetes necesarios para compilar software desde el código fuente.

sudo apt install build-essential tcl -y
# Instala compiladores (gcc, make) y tcl para pruebas

Paso 2: Descarga del código fuente de Redis

Vaya a un directorio temporal y descargue la última versión estable de Redis desde el sitio web oficial. Por ejemplo, usaremos la versión 7.2.4, pero puede reemplazarla por la más actual para 2026.

cd /tmp
wget https://download.redis.io/releases/redis-7.2.4.tar.gz
# Descarga el archivo con el código fuente de Redis
tar xzf redis-7.2.4.tar.gz
# Descomprime el archivo
cd redis-7.2.4
# Cambia al directorio del código fuente

Paso 3: Compilación e instalación de Redis

Compile Redis. Utilice make y luego make install para instalar los archivos ejecutables en los directorios del sistema.

make
# Compila Redis
sudo make install
# Instala Redis en /usr/local/bin

Paso 4: Configuración de Redis como servicio systemd

Para que Redis se inicie como un servicio del sistema y se gestione a través de systemctl, es necesario crear archivos de configuración. Ejecute un script especial que le ayudará con esto.

sudo ./utils/install_server.sh
# Ejecuta un script interactivo para configurar systemd y los archivos de configuración

Siga las instrucciones del script. Para la mayoría de las preguntas, puede presionar Enter, aceptando los valores predeterminados (por ejemplo, puerto 6379, archivo de configuración /etc/redis/6379.conf, archivo de registro /var/log/redis_6379.log, directorio de datos /var/lib/redis/6379). Una vez completado, el script iniciará Redis y configurará su inicio automático.

Paso 5: Verificación del estado del servicio Redis

Verifique que Redis esté en ejecución y funcionando:

sudo systemctl status redis_6379
# Verifica el estado del servicio Redis creado por el script (puede ser redis-server o redis_6379)

O, si el script creó un servicio con el nombre redis-server:

sudo systemctl status redis-server

Paso 6: Verificación de la versión y conexión

redis-cli ping
# Verifica la conexión a Redis
redis-cli info server | grep redis_version
# Muestra la versión de Redis

Ahora Redis está instalado. Pasemos a su configuración detallada para garantizar la seguridad y un rendimiento óptimo.

Copias de seguridad y mantenimiento

Las copias de seguridad fiables y el mantenimiento regular son aspectos clave de cualquier sistema en producción. Para Redis, esto es especialmente importante, ya que los datos se almacenan en la memoria RAM y su pérdida puede ser catastrófica.

1. Qué respaldar

Para Redis, es necesario hacer copias de seguridad regularmente de:

• Archivos de persistencia de Redis:
  • dump.rdb: Archivo de instantánea de la base de datos RDB. Contiene el estado completo de los datos de Redis en el momento de la instantánea.
  • appendonly.aof: Archivo AOF. Contiene una secuencia de comandos que pueden reproducirse para restaurar el estado.
  Estos archivos suelen encontrarse en el directorio de datos de Redis, especificado en dir en redis.conf (por ejemplo, /var/lib/redis/6379 o /var/lib/redis).
• Archivos de configuración de Redis:
  • /etc/redis/redis.conf (o /etc/redis/6379.conf): Archivo de configuración principal.
• Otros archivos importantes: Si utiliza Redis para fines específicos, asegúrese de hacer copias de seguridad de todos los scripts, configuraciones o datos relacionados.

2. Script sencillo de copia de seguridad automática

Crearemos un script sencillo que copiará los archivos de persistencia y configuración de Redis. Este script se puede ejecutar programado usando cron.

Cree un directorio para las copias de seguridad:

sudo mkdir -p /var/backups/redis
sudo chown redisadmin:redisadmin /var/backups/redis

Cree el script de copia de seguridad:

sudo nano /usr/local/bin/backup_redis.sh

Pegue el siguiente contenido. Asegúrese de que las rutas a los archivos RDB/AOF y de configuración coincidan con su instalación.

#!/bin/bash

# Configuración
REDIS_DATA_DIR="/var/lib/redis" # Directorio donde se encuentran dump.rdb y appendonly.aof
REDIS_CONF_FILE="/etc/redis/redis.conf" # Archivo de configuración de Redis
BACKUP_DIR="/var/backups/redis" # Directorio para almacenar las copias de seguridad
TIMESTAMP=$(date +"%Y%m%d%H%M%S")
BACKUP_NAME="redis_backup_${TIMESTAMP}.tar.gz"

# Verificar que Redis esté en ejecución y guardar RDB antes de la copia de seguridad
echo "Saving Redis RDB to disk..."
redis-cli -a ВАШ_СЛОЖНЫЙ_ПАРОЛЬ_ДЛЯ_REDIS BGSAVE
# Damos a Redis un poco de tiempo para guardar
sleep 10

echo "Starting Redis backup..."

# Creación del archivo
sudo tar -czf "${BACKUP_DIR}/${BACKUP_NAME}" \
    -C "${REDIS_DATA_DIR}" dump.rdb appendonly.aof \
    "${REDIS_CONF_FILE}" \
    --remove-files-from "${REDIS_DATA_DIR}" # Opcional: si desea eliminar los RDB/AOF antiguos después de la copia

# Verificación de éxito
if [ $? -eq 0 ]; then
    echo "Redis backup created successfully: ${BACKUP_DIR}/${BACKUP_NAME}"
    # Limpieza de copias de seguridad antiguas (por ejemplo, mantener solo las de los últimos 7 días)
    find "${BACKUP_DIR}" -type f -name 'redis_backup_*.tar.gz' -mtime +7 -delete
    echo "Old backups cleaned up."
else
    echo "Error creating Redis backup."
fi

# Si utiliza AOF, puede forzar su reescritura para reducir el tamaño
# echo "Rewriting AOF file..."
# redis-cli -a ВАШ_СЛОЖНЫЙ_ПАРОЛЬ_ДЛЯ_REDIS BGREWRITEAOF

echo "Backup script finished."

Haga el script ejecutable:

sudo chmod +x /usr/local/bin/backup_redis.sh

3. Configuración de Cron para la ejecución automática de copias de seguridad

Agregue el script a cron para que se ejecute automáticamente. Por ejemplo, todos los días a las 03:00 de la mañana.

sudo crontab -e

Agregue la siguiente línea al final del archivo:

0 3 * * * /usr/local/bin/backup_redis.sh >> /var/log/redis_backup.log 2>&1

Esta entrada significa: "A las 03:00 todos los días, todos los meses, todos los días de la semana, ejecutar /usr/local/bin/backup_redis.sh y redirigir toda la salida a /var/log/redis_backup.log".

4. Dónde almacenar las copias de seguridad (S3 externo / VPS separado)

Almacenar las copias de seguridad en el mismo servidor que los datos originales es arriesgado. Si el servidor falla (fallo de hardware, robo, incendio), perderá tanto los datos como las copias de seguridad. Siempre almacene las copias de seguridad críticas de forma remota:

• Almacenamiento en la nube (compatible con S3): Amazon S3, DigitalOcean Spaces, Backblaze B2 o servicios similares. Para ello, puede modificar el script de copia de seguridad añadiendo el comando aws s3 cp (si AWS CLI está instalado) o rclone copy para subir el archivo a la nube.

  
  # Ejemplo de adición al script backup_redis.sh
  # Después de crear el archivo con éxito:
  # aws s3 cp "${BACKUP_DIR}/${BACKUP_NAME}" s3://your-s3-bucket/redis-backups/
  

• VPS separado o servidor dedicado: Puede usar rsync o scp para copiar las copias de seguridad a otro de sus servidores.

  
  # Ejemplo de adición al script backup_redis.sh
  # Después de crear el archivo con éxito:
  # scp "${BACKUP_DIR}/${BACKUP_NAME}" user@remote_server:/path/to/remote/backups/
  

• Herramientas especializadas: Como Restic o BorgBackup, que proporcionan deduplicación, cifrado y copias de seguridad incrementales. Requieren una configuración más compleja, pero son muy eficientes.

5. Actualizaciones: rolling vs maintenance window

La actualización de Redis y del sistema operativo es una parte importante del mantenimiento. Enfoques para la actualización:

• Maintenance Window (Ventana de mantenimiento): Un enfoque tradicional en el que el servidor o la aplicación se desconecta temporalmente, se realizan las actualizaciones y luego todo vuelve a funcionar.
  • Ventajas: Más fácil de implementar, menor riesgo de problemas imprevistos durante la operación.
  • Desventajas: Tiempo de inactividad del servicio.
  Para Redis, esto puede incluir detener el servicio, actualizar, verificar y reiniciar.
• Rolling Updates (Actualizaciones graduales): Se aplica en configuraciones de clúster o de alta disponibilidad, donde los nodos individuales se actualizan uno por uno, sin interrumpir el funcionamiento de todo el servicio.
  • Ventajas: Sin tiempo de inactividad.
  • Desventajas: Significativamente más complejo de implementar, requiere múltiples instancias de Redis y mecanismos de replicación/tolerancia a fallos (Redis Sentinel, Redis Cluster).

Para una única instancia de Redis en un VPS, como en nuestro caso, se suele utilizar el enfoque de ventana de mantenimiento. Planifique las actualizaciones para momentos de mínima carga. ¡Siempre haga una copia de seguridad completa antes de actualizar!

Proceso de actualización de Redis (desde repositorios):

sudo systemctl stop redis-server # Detener Redis
sudo apt update && sudo apt upgrade -y # Actualizar el sistema y Redis
sudo systemctl start redis-server # Iniciar Redis
sudo systemctl status redis-server # Verificar estado

Al compilar desde el código fuente, el proceso de actualización incluirá la descarga de nuevas fuentes, la compilación y la reinstalación, y luego el reinicio del servicio.

Solución de problemas + Preguntas frecuentes

En esta sección, abordaremos los problemas comunes que pueden surgir al trabajar con Redis y proporcionaremos respuestas a las preguntas frecuentes.

1. Redis no se inicia o no responde

Error: Después de la instalación o el reinicio, systemctl status redis-server muestra "failed" o "inactive".

Qué verificar:

• Registros de Redis: El primer lugar para buscar pistas. Verifique el archivo de registros de Redis especificado en redis.conf (por defecto /var/log/redis/redis-server.log o /var/log/redis_6379.log).
• Registros del sistema: Verifique los registros de systemd: sudo journalctl -u redis-server.service.
• Archivo de configuración: Asegúrese de que no haya errores de sintaxis en /etc/redis/redis.conf. Cualquier error tipográfico puede impedir el inicio.
• Disponibilidad del puerto: Es posible que otro proceso ya esté ocupando el puerto 6379. Verifique: sudo ss -tulpn | grep 6379.
• Permisos de acceso: Asegúrese de que el usuario de Redis tenga permisos para leer el archivo de configuración, escribir en el directorio de registros y en el directorio de datos (dir en redis.conf).

Cómo solucionarlo: Corrija los errores en la configuración, libere el puerto o cambie el puerto de Redis, otorgue los permisos necesarios. Después de cada cambio, intente reiniciar Redis: sudo systemctl restart redis-server.

2. "Connection refused" al conectarse a Redis

Error: Al intentar conectarse con redis-cli o desde una aplicación, recibe "Could not connect to Redis at 127.0.0.1:6379: Connection refused".

Qué verificar:

• Estado de Redis: Asegúrese de que Redis esté en ejecución: sudo systemctl status redis-server.
• Configuración de bind: Verifique el parámetro bind en redis.conf. Si está configurado como 127.0.0.1, solo podrá conectarse desde el mismo servidor. Si intenta conectarse desde otro servidor, bind debe configurarse con la dirección IP privada del servidor Redis o 0.0.0.0 (lo que requiere una configuración cuidadosa del firewall).
• Firewall (UFW): Asegúrese de que el firewall no esté bloqueando la conexión al puerto 6379. Verifique el estado de UFW: sudo ufw status. Si Redis debe ser accesible desde otras IP, asegúrese de que la regla allow 6379 o allow from X.X.X.X to any port 6379 esté activa.

Cómo solucionarlo: Inicie Redis, ajuste bind en redis.conf y/o las reglas del firewall. No olvide reiniciar Redis después de cambiar la configuración: sudo systemctl restart redis-server.

3. "NOAUTH Authentication required"

Error: Recibe este error al intentar ejecutar comandos de Redis.

Qué verificar: Ha configurado una contraseña (requirepass) en redis.conf, pero no la ha proporcionado al conectarse.

Cómo solucionarlo: Proporcione la contraseña al conectarse a través de redis-cli -a SU_CONTRASEÑA o configure su aplicación para usar la contraseña.

4. Redis consume demasiada memoria

Error: Redis ocupa más memoria de lo esperado o se acerca al límite de maxmemory.

Qué verificar:

• maxmemory y maxmemory-policy: Asegúrese de que estos parámetros estén configurados correctamente en redis.conf.
• Uso de memoria: Utilice el comando redis-cli info memory para obtener información detallada sobre el consumo de memoria de Redis. Preste atención a used_memory_human y used_memory_peak_human.
• Estructuras de datos: Verifique qué estructuras de datos se almacenan en Redis y qué tan grandes son. El comando redis-cli --scan o MEMORY USAGE key (Redis 4.0+) puede ayudar.
• Fragmentación de memoria: mem_fragmentation_ratio en redis-cli info memory. Un coeficiente alto (más de 1.5) puede indicar fragmentación, lo que aumenta el consumo de memoria.

Cómo solucionarlo: Aumente maxmemory (si hay RAM disponible), cambie maxmemory-policy, optimice el almacenamiento de datos en Redis, utilice estructuras de datos más compactas. Reiniciar Redis puede reducir temporalmente la fragmentación.

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

Para tareas básicas, como el almacenamiento en caché de un sitio web pequeño o colas pequeñas, la configuración mínima es de 1 vCPU, 1 GB de RAM y 20 GB de SSD. Esto será suficiente para Redis, que almacena varios cientos de megabytes de datos. Sin embargo, para proyectos más serios, se recomiendan 2 vCPU, 4 GB de RAM y 80 GB de SSD.

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

La elección entre un VPS y un servidor dedicado depende de la escala de su tarea, los requisitos de rendimiento y el presupuesto. Para la mayoría de los proyectos medianos y pequeños (sitios web, SaaS pequeños, servidores de juegos para amigos, nodos personales), un VPS será una solución más que suficiente y económicamente ventajosa. Un servidor dedicado se vuelve necesario cuando el volumen de datos en Redis se cuenta en decenas de gigabytes, se requiere una previsibilidad absoluta del rendimiento sin "ruido de vecinos", o cuando tiene requisitos de hardware muy específicos.

7. ¿Cómo monitorear Redis?

Para monitorear Redis, puede usar el comando redis-cli info (por ejemplo, redis-cli info memory, redis-cli info clients, redis-cli info persistence). Para un monitoreo más avanzado, se recomienda usar herramientas como Prometheus con Grafana, utilizando el exportador de Redis, o soluciones especializadas de monitoreo de servidores que recopilan métricas de Redis (por ejemplo, Netdata).

8. ¿Redis Cluster vs Redis Sentinel?

Redis Sentinel proporciona alta disponibilidad, cambiando automáticamente a una réplica en caso de fallo del maestro. Está diseñado para la tolerancia a fallos. Redis Cluster, por otro lado, proporciona escalabilidad y alta disponibilidad, permitiendo distribuir datos entre varios nodos y fragmentarlos automáticamente. Si solo necesita tolerancia a fallos para una única instancia de Redis, Sentinel es su elección. Si necesita escalar datos y consultas a través de múltiples nodos, use Cluster.

Conclusiones y próximos pasos

¡Felicidades! Ha instalado y configurado Redis con éxito en su VPS o servidor dedicado, asegurando un nivel básico de seguridad y rendimiento. Ahora tiene una potente herramienta para el almacenamiento en caché, la gestión de sesiones, las colas de mensajes y muchas otras tareas, lista para integrarse con sus aplicaciones.

Los siguientes pasos para optimizar y escalar su instalación de Redis pueden incluir:

• Configuración del monitoreo: Integre Redis con un sistema de monitoreo (por ejemplo, Prometheus + Grafana, Netdata) para rastrear el uso de memoria, el número de solicitudes, las latencias y otras métricas clave. Esto ayudará a identificar problemas antes de que afecten a sus usuarios.
• Optimización del rendimiento de la aplicación: Asegúrese de que su aplicación utilice Redis de manera eficiente, minimizando el número de solicitudes, utilizando las estructuras de datos correctas y evitando operaciones de bloqueo prolongadas.
• Escalabilidad y alta disponibilidad: Si su proyecto crece, considere configurar Redis Sentinel para la tolerancia a fallos automática o Redis Cluster para la escalabilidad horizontal y la distribución de carga.

Continúe experimentando con las diversas funciones de Redis e integrándolo en sus proyectos para liberar todo el potencial de esta increíble herramienta.