{"id":6862,"date":"2025-09-12T13:23:12","date_gmt":"2025-09-12T13:23:12","guid":{"rendered":"https:\/\/blog.databyte.cl\/?p=6862"},"modified":"2025-09-23T12:56:36","modified_gmt":"2025-09-23T12:56:36","slug":"instalar-redis-en-cpanel","status":"publish","type":"post","link":"https:\/\/blog.databyte.cl\/index.php\/2025\/09\/12\/instalar-redis-en-cpanel\/","title":{"rendered":"\u00bfC\u00f3mo \u00ednstalo Redis usando contenedores (ea-podman) en cPanel?"},"content":{"rendered":"\n

Redis es un potente almac\u00e9n de estructuras de datos en memoria, utilizado como base de datos, cach\u00e9 y agente de mensajes. Gracias a la herramienta ea-podman<\/strong> de cPanel, puedes instalar y gestionar Redis de forma aislada y segura dentro de contenedores. \ud83d\udce6<\/p>\n\n\n\n

Esta gu\u00eda te mostrar\u00e1 c\u00f3mo instalar Redis, incluyendo la soluci\u00f3n a un problema com\u00fan en servidores con CloudLinux y CageFS<\/strong>.<\/p>\n\n\n\n

\n\n\n\n

1. Instalaci\u00f3n Est\u00e1ndar de Podman y Redis<\/strong><\/h2>\n\n\n\n

Estos son los pasos para un servidor cPanel est\u00e1ndar. Necesitar\u00e1s acceso root<\/strong> para los primeros comandos.<\/p>\n\n\n\n

Paso 1: Instalar Podman en el servidor (como root)<\/h3>\n\n\n\n

Primero, instala los repositorios y el paquete de ea-podman a trav\u00e9s de la terminal de tu servidor.<\/p>\n\n\n\n

dnf install -y ea-podman-repo
dnf install -y ea-podman<\/pre>\n\n\n\n
Paso 2: Habilitar \u00ablinger\u00bb para el usuario de cPanel:<\/h3>\n\n\n\n
Esto permite que los servicios del usuario se ejecuten incluso cuando no ha iniciado sesi\u00f3n. Reemplaza <username> con el nombre de usuario de cPanel.<\/p>\n\n\n\n
loginctl enable-linger <username><\/pre>\n\n\n\n
Paso 3: Instalar Redis (como usuario de cPanel)<\/h3>\n\n\n\n
Ahora, inicia sesi\u00f3n como el usuario de cPanel que necesita Redis y ejecuta el siguiente script:<\/p>\n\n\n\n
\/usr\/local\/cpanel\/scripts\/ea-podman install ea-redis62<\/pre>\n\n\n\n
En un sistema est\u00e1ndar, esto completar\u00e1 la instalaci\u00f3n. Sin embargo, si tu servidor utiliza CloudLinux con CageFS<\/strong>, es muy probable que encuentres un error.<\/p>\n\n\n\n
\n\n\n\n
2. Soluci\u00f3n para Servidores CloudLinux con CageFS<\/strong><\/h2>\n\n\n\n
Si al ejecutar el comando de instalaci\u00f3n como usuario de cPanel ves el siguiente error, significa que CageFS est\u00e1 impidiendo que el usuario acceda a los binarios necesarios.<\/p>\n\n\n\n
El Error<\/h3>\n\n\n\n
[databyte@hercules ~]$ \/usr\/local\/cpanel\/scripts\/ea-podman install ea-redis62
Adding a ea-redis62 instance for \u201cdatabyte\u201d \u2026
\u2026 done!
Can't exec \"podman\": No such file or directory at \/opt\/cpanel\/ea-podman\/lib\/ea_podman\/util.pm line 90.
Failed to create container
[databyte@hercules ~]$<\/pre>\n\n\n\n
La Soluci\u00f3n (como root)<\/h3>\n\n\n\n
Para solucionarlo, debes configurar CageFS para que permita al usuario ejecutar los comandos de podman y systemctl de forma segura. Sigue estos pasos como usuario root<\/strong>.<\/p>\n\n\n\n
1. Crear un wrapper para systemctl: <\/h3>\n\n\n\n
Este script es necesario porque el entorno de CageFS no siempre propaga las variables de entorno requeridas.<\/p>\n\n\n\n
Crea el archivo \/usr\/local\/bin\/systemctl con el siguiente contenido:<\/p>\n\n\n\n
#!\/usr\/bin\/env bash
export DBUS_SESSION_BUS_ADDRESS=unix:path=\/run\/user\/$(id -u)\/bus
exec \/usr\/bin\/systemctl \"$@\"<\/pre>\n\n\n\n
Y dale permisos de ejecuci\u00f3n:<\/p>\n\n\n\n
chmod a+x \/usr\/local\/bin\/systemctl<\/pre>\n\n\n\n
2. Configurar los comandos proxy de CageFS:<\/h3>\n\n\n\n
Crea el archivo \/etc\/cagefs\/ea-podman.proxy.commands e incluye estas l\u00edneas para decirle a CageFS qu\u00e9 binarios puede ejecutar el usuario fuera de su jaula:<\/p>\n\n\n\n
PODMAN=\/usr\/bin\/podman
SYSTEMCTL=\/usr\/local\/bin\/systemctl<\/pre>\n\n\n\n
3. A\u00f1adir herramientas de cPanel a CageFS:<\/h3>\n\n\n\n
cagefsctl --addrpm ea-cpanel-tools<\/pre>\n\n\n\n
4. Crear la configuraci\u00f3n de CageFS para Podman: <\/h3>\n\n\n\n
Crea el archivo \/etc\/cagefs\/conf.d\/ea-podman.cnf y a\u00f1ade las rutas a los binarios que permitiste en el paso 2.<\/p>\n\n\n\n
[ea-podman]
paths=\/usr\/bin\/podman, \/usr\/local\/bin\/systemctl<\/pre>\n\n\n\n
5. Actualizar CageFS: <\/h3>\n\n\n\n
Aplica todos los cambios ejecutando:<\/p>\n\n\n\n
cagefsctl --force-update<\/pre>\n\n\n\n
\n\n\n\n
3. (Opcional) Refuerzo de Seguridad para CloudLinux<\/h2>\n\n\n\n
Para un entorno m\u00e1s seguro, puedes usar un wrapper<\/em> personalizado que valide los comandos que el usuario puede ejecutar con systemctl.<\/p>\n\n\n\n
1. Modifica el archivo de comandos proxy: <\/h3>\n\n\n\n
Cambia el contenido de \/etc\/cagefs\/ea-podman.proxy.commands por el siguiente:<\/p>\n\n\n\n
PODMAN=\/usr\/bin\/podman
SYSTEMCTL:cagefs.proxy.systemctl=\/usr\/local\/bin\/systemctl<\/pre>\n\n\n\n
2. Crea el script de wrapper<\/em> seguro: <\/h3>\n\n\n\n
Crea el archivo \/usr\/share\/cagefs\/safeprograms\/cagefs.proxy.systemctl con este contenido:<\/p>\n\n\n\n
#!\/bin\/bash\n\n# Main script logic\nif [[ $EUID -eq 0 ]]; then\n    echo 'Cannot be run as root'\n    exit 1\nfi\n\n# Function to check if the service corresponds to a running container\nis_container() {\n    local container_name=${1#container-}\n    container_name=${container_name%.service}\n    podman ps -a --format \"{{.Names}}\" | grep -q \"^${container_name}$\"\n}\n\n# Function to check for the --user flag and trimming it\nvalidate_params() {\n    echo \"$@\"\n    local user_flag_found=0\n    local remaining_args=()\n    for arg in \"$@\"; do\n        if [[ \"$arg\" == \"--user\" ]]; then\n            user_flag_found=1\n        else\n            remaining_args+=(\"$arg\")\n        fi\n    done\n    if [[ $user_flag_found -ne 1 ]]; then\n        echo \"Error: Script must be called with the --user flag.\"\n        exit 1\n    fi\n\n    local action=${remaining_args[0]}\n\n    # Check if the action is valid\n    if [[ \"$action\" != \"start\" && \"$action\" != \"stop\" && \"$action\" != \"restart\" && \"$action\" != \"enable\" && \"$action\" != \"disable\" && \"$action\" == \"daemon-reload\" && \"$action\" == \"reset-failed\" ]]; then\n        echo \"Error: Action must be 'start', 'stop', 'restart', 'enable', 'disable', 'daemon-reload' and 'reset-failed'.\"\n        exit 1\n    fi\n\n    if [[ \"$action\" != \"daemon-reload\" &&  \"$action\" != \"reset-failed\" ]]; then\n        local service_name=${remaining_args[1]}\n        # Check if the service corresponds to a running container\n        if ! is_container \"$service_name\"; then\n            echo \"Error: No container corresponds to the provided service name.\"\n            exit 1\n        fi\n    fi\n\n}\n\nvalidate_params \"$@\"\n\nUSR=`\/usr\/bin\/whoami`\nTOKEN=`\/bin\/cat \/var\/.cagefs\/.cagefs.token`\n# It's user's tmp directory and write to it is secure procedure\n# because this script is running only under usual user\nPIDFILE=\"\/tmp\/.cagefs.proxy.$$\"\nUSER_INTERRUPT=13\nCWD=`pwd`\n\nctrl_c_handler() {\n    if [[ -f \"$PIDFILE\" ]]; then\n        pid=`\/bin\/cat $PIDFILE`\n        \/bin\/rm -f $PIDFILE > \/dev\/null 2>&1\n        \/bin\/kill -s SIGINT \"$pid\" > \/dev\/null 2>&1\n    fi\n    exit $USER_INTERRUPT\n}\n\nif [[ -e \/var\/.cagefs\/origin ]]; then\n    ORIGIN=`\/bin\/cat \/var\/.cagefs\/origin`\n    REMOTE=\"\/usr\/bin\/ssh -F \/etc\/ssh\/cagefs-rexec_config $USR@$ORIGIN\"\n    $REMOTE CAGEFS_TOKEN=\"$TOKEN\" \/usr\/sbin\/proxyexec -c cagefs.sock \"$USR\" \"$CWD\" ALIAS $$ \"$@\"\n    RETVAL=$?\nelse\n    trap 'ctrl_c_handler' 2\n    CAGEFS_TOKEN=\"$TOKEN\" \/usr\/sbin\/proxyexec -c cagefs.sock \"$USR\" \"$CWD\" ALIAS $$ \"$@\"\n    RETVAL=$?\n    \/bin\/rm -f $PIDFILE > \/dev\/null 2>&1\nfi\n\nexit $RETVAL<\/pre>\n\n\n\n
3. Actualiza CageFS nuevamente:<\/h3>\n\n\n\n
cagefsctl --force-update<\/pre>\n\n\n\n
\n\n\n\n
4. Verificaci\u00f3n y Conexi\u00f3n<\/h2>\n\n\n\n
Una vez aplicados los cambios, puedes volver a intentar la instalaci\u00f3n como el usuario de cPanel.<\/p>\n\n\n\n
Instalaci\u00f3n Exitosa<\/h3>\n\n\n\n
Ahora, el comando deber\u00eda funcionar y mostrar una salida similar a esta:<\/p>\n\n\n\n
[databyte@hercules ~]$ \/usr\/local\/cpanel\/scripts\/ea-podman install ea-redis62
Adding a ea-redis62 instance for \u201cdatabyte\u201d \u2026
\u2026 done!
41a2fa35f9faf939eeabb17699a5068518d53767b6701145e6fd8154afb4fd30
...
Done, installed: ea-redis62.databyte.03<\/pre>\n\n\n\n
Verificar Contenedores Activos<\/h3>\n\n\n\n
Puedes listar los contenedores activos para tu usuario con:<\/p>\n\n\n\n
\/usr\/local\/cpanel\/scripts\/ea-podman containers<\/pre>\n\n\n\n
La salida te confirmar\u00e1 que el contenedor de Redis est\u00e1 en ejecuci\u00f3n:<\/p>\n\n\n\n
{
  \"ea-redis62.databyte.03\" : {
      \"container_name\" : \"ea-redis62.databyte.03\",
      \"image\" : \"redis:6.2.19\",
      \"pkg\" : \"ea-redis62\",
      \"pkg_version\" : \"6.2.19-1\",
      \"user\" : \"databyte\"
  }
}

<\/pre>\n\n\n\n
Conectarse a Redis<\/h3>\n\n\n\n
Tu aplicaci\u00f3n ahora puede conectarse a Redis usando el socket Unix<\/strong> que se ha creado. Lo encontrar\u00e1s en el directorio home del usuario.<\/p>\n\n\n\n