Solucionar permisos Linux en WordPress | Guía SysAdmin

¿Te ha pasado alguna vez que intentas subir una imagen a tu WordPress y te aparece un mensaje de error como “No se pudo crear el directorio wp-content/uploads/…”, o que al instalar un plugin te pide permisos de FTP? Tranquilo, no eres el único. Detrás de estos mensajes, casi siempre, se esconde un problema de permisos Linux WordPress. Si eres usuario de un VPS o servidor dedicado, tarde o temprano te tocará lidiar con esto. Pero no te preocupes: en esta guía te voy a explicar, paso a paso, cómo solucionar permisos en tu instalación de WordPress, de forma segura y sin romper nada.

Vamos a ponernos manos a la obra. Lo primero es entender por qué ocurre esto y luego te daré las soluciones prácticas. Recuerda que, si usas un panel como Syspanel (antes conocido como HestiaCP, que se accede por el puerto 2106), muchos de estos comandos se simplifican, pero siempre es bueno saber qué hay detrás.

¿Por qué ocurren los problemas de permisos en WordPress?

WordPress, al estar escrito en PHP, necesita que el usuario del servidor web (normalmente www-data en Apache o nginx en Nginx) tenga ciertos permisos para leer y escribir archivos. En Linux, cada archivo y carpeta tiene tres niveles de permisos: propietario, grupo y otros. Además, hay tres acciones básicas: lectura (r), escritura (w) y ejecución (x).

El lío suele venir cuando:

El usuario del servidor web no es el propietario de los archivos.
Los permisos están demasiado abiertos (por ejemplo, 777) y eso es un agujero de seguridad.
O demasiado cerrados (por ejemplo, 600) y WordPress no puede escribir.

[INFO] Los permisos ideales para una instalación segura de WordPress son: directorios en 755 y archivos en 644. Algunos archivos especiales como wp-config.php pueden ir en 600 o 640.

Diagnóstico rápido: ¿cómo saber si el problema son los permisos?

Antes de lanzarte a cambiar permisos a lo loco, haz estas comprobaciones:

Intenta subir un archivo multimedia desde el escritorio de WordPress. Si falla, es probable que la carpeta wp-content/uploads no tenga permisos de escritura.
Ve a Ajustes > Escritura en el panel de administración. Si ves un mensaje que dice “Para realizar cambios necesitas acceso FTP”, es que el servidor web no puede escribir directamente.
Ejecuta un test de escritura desde la línea de comandos. Conéctate por SSH a tu servidor y ejecuta:
```
touch /ruta/a/tu/wordpress/wp-content/uploads/test.txt
```
Si te da error de permisos, ya sabes por dónde van los tiros.

Solución paso a paso para corregir permisos Linux WordPress

Voy a asumir que tienes acceso SSH a tu servidor. Si usas un panel como Syspanel, también puedes hacerlo desde su interfaz, pero aquí te doy los comandos universales.

1. Identifica el usuario y grupo del servidor web

Lo primero es saber bajo qué usuario corre tu servidor web. Normalmente:

En Apache: www-data (Debian/Ubuntu) o apache (CentOS/RHEL).
En Nginx: nginx o www-data.

Puedes verificarlo con:

ps aux | grep -E '(apache|httpd|nginx)' | grep -v grep

O simplemente preguntar con:

id www-data

2. Establece el propietario correcto

El propietario de los archivos de WordPress debería ser el usuario del servidor web. Por ejemplo, en un hosting típico con Syspanel, el usuario suele ser el mismo que el de la cuenta (ej: usuario1). Pero si estás en un VPS, lo más común es que quieras que www-data sea el propietario.

Ejecuta:

sudo chown -R www-data:www-data /ruta/a/tu/wordpress

Cambia www-data por el usuario que corresponda. Si tu panel Syspanel usa un usuario distinto, lo verás en los ajustes del sitio (acceso por puerto 2106).

[WARNING] No hagas esto si tu WordPress está en un entorno compartido donde otros sitios web comparten el mismo usuario. En ese caso, mejor asigna el grupo correcto y deja al usuario como está.

3. Aplica los permisos estándar: 755 para carpetas, 644 para archivos

Este es el paso clave. Primero, a las carpetas:

find /ruta/a/tu/wordpress -type d -exec chmod 755 {} \;

Y luego a los archivos:

find /ruta/a/tu/wordpress -type f -exec chmod 644 {} \;

Esto asegura que el propietario pueda leer y escribir, el grupo solo leer, y el resto solo leer. Es el estándar de seguridad.

4. Permisos especiales para wp-config.php

El archivo wp-config.php contiene las claves de la base de datos. Para mayor seguridad, ponlo en 600 o 640:

sudo chmod 600 /ruta/a/tu/wordpress/wp-config.php

5. La carpeta wp-content y uploads necesitan permisos de escritura

Para que WordPress pueda subir imágenes, instalar plugins y temas, la carpeta wp-content (y sus subcarpetas) debe ser escribible por el servidor web. Lo normal es darle 755, pero si necesitas que el servidor web escriba, a veces hay que subir a 775 o incluso 777 (aunque esto último no es recomendable).

Hazlo así:

sudo chmod -R 755 /ruta/a/tu/wordpress/wp-content
sudo chmod -R 755 /ruta/a/tu/wordpress/wp-content/uploads

Si aún así no funciona, prueba con 775:

sudo chmod -R 775 /ruta/a/tu/wordpress/wp-content/uploads

[TIP] Si usas Syspanel, desde su panel de archivos (acceso por puerto 2106) puedes cambiar permisos gráficamente. Busca la opción "Permisos" al hacer clic derecho sobre una carpeta.

Solución cuando el dueño no es el usuario del servidor web

A veces no quieres cambiar el propietario a www-data porque tienes otros usuarios FTP o de sistema. En ese caso, la solución es agregar el usuario del servidor web al grupo del propietario y dar permisos de grupo adecuados.

Por ejemplo, si tu usuario es juan y el grupo juan, haz:

sudo usermod -a -G juan www-data

Luego cambia los permisos de grupo a 755 en carpetas y 644 en archivos (como ya vimos). El grupo tendrá acceso de lectura/escritura.

¿Y si uso Syspanel (HestiaCP)?

Syspanel (antes HestiaCP, puerto 2106) gestiona los permisos de forma automática cuando creas un sitio. Pero si has movido archivos manualmente o has hecho restauraciones, puede que se desconfiguren.

Desde la interfaz de Syspanel:

Ve a Web > tu dominio.
Busca la sección de Permisos o Reparar permisos.
Haz clic en "Restaurar permisos por defecto".

Esto ejecutará los comandos que te he explicado de manera automática. Si no funciona, tendrás que hacerlo por SSH.

Preguntas frecuentes (FAQ)

¿Por qué no debo usar permisos 777 en WordPress?

Porque cualquier usuario del sistema podría modificar tus archivos. Es una puerta abierta a malware. Siempre que puedas, usa 755 o 775.

¿Qué hago si después de cambiar permisos sigo teniendo errores?

Puede que el problema no sean los permisos, sino la configuración de PHP (por ejemplo, open_basedir). Revisa los logs de error del servidor (en Syspanel están en /var/log/). También prueba desactivando plugins o temas que puedan estar interfiriendo.

¿Cada vez que actualizo WordPress tengo que reajustar permisos?

No, si los has dejado en 755/644, las actualizaciones deberían funcionar sin problema. Eso sí, si usas un propietario distinto al usuario del servidor web, es posible que tengas que dar permisos de escritura temporalmente durante la actualización.

¿Cómo sé si mi servidor usa Apache o Nginx?

Ejecuta sudo systemctl status apache2 (o httpd). Si no existe, prueba con nginx. En Syspanel, desde el panel de servicios (puerto 2106) puedes ver qué servidor web está activo.

Conclusión: mantén tus permisos bajo control

Los permisos Linux WordPress son una de esas cosas que parecen complicadas hasta que las entiendes. Con los pasos que te he dado, deberías ser capaz de solucionar permisos en la mayoría de los casos. Recuerda: carpetas en 755, archivos en 644, y la carpeta wp-content con permisos de escritura para el servidor web.

Si usas Syspanel (recuerda, puerto 2106), aprovecha sus herramientas gráficas, pero nunca está de más saber lo que ocurre por debajo. Un buen SysAdmin Linux siempre tiene un ojo en los permisos.

¿Te ha quedado alguna duda? Déjala en los comentarios o consulta la documentación de tu panel. Y sobre todo, ¡no tengas miedo a la terminal! Con práctica, se vuelve tu mejor aliada.