Solución de la comunidad

Plex no puede eliminar contenido multimedia en ZimaOS: permisos de montaje SMB, identidad del contenedor y acceso de escritura más seguro

A November 2025 thread where Plex could read media from a mounted share but failed to delete files. The community correctly focused on permissions, while the original poster eventually remounted CIFS with file_mode/dir_mode 0777 and noperm. The source did not establish that broad world-write permissions were the best permanent fix.

Que Plex pueda reproducir un archivo, pero no eliminarlo, es un indicio claro de un problema de permisos. El acceso de lectura y el acceso de eliminación/escritura son operaciones diferentes. En el caso original, los archivos multimedia estaban en un recurso compartido montado, Plex podía leerlos y la eliminación devolvía «There was a problem deleting file».

Finalmente, el autor de la publicación volvió a montar el recurso compartido CIFS con permisos amplios 0777 y noperm, lo que hizo que el directorio fuera escribible. Esto demuestra que el problema estaba en la capa efectiva de permisos del montaje/sistema de archivos, pero es una configuración demasiado permisiva para recomendarla como solución permanente.

El «root» del contenedor no es toda la historia de los permisos

El usuario concedió acceso de root en el host porque el contenedor de Plex parecía ejecutarse como root. Aun así, un contenedor Docker accede a un sistema de archivos SMB/CIFS montado mediante un bind mount a través de la propiedad, el modo, las ACL y las opciones de montaje del montaje realizado en el host.

Conceder permisos de root en el host no cambia automáticamente la forma en que un montaje CIFS presenta la propiedad de los archivos al contenedor.

Eliminar un archivo requiere permisos de escritura en el directorio principal

En los sistemas de archivos similares a Unix, eliminar un archivo es principalmente una operación sobre el directorio. Por tanto, Plex puede leer correctamente un archivo multimedia y, aun así, no poder eliminarlo porque el directorio principal montado no permite escribir a la identidad efectiva de Plex.

Alinea la identidad real del contenedor con el montaje

La comunidad recomendó hacer coincidir el usuario/grupo del contenedor de Plex con la propiedad de la carpeta en el host. Es un buen principio duradero, pero no debes asumir que Plex siempre se ejecuta con un UID universal.

Inspecciona la configuración actual del contenedor y la propiedad efectiva que presenta el montaje CIFS antes de cambiar PLEX_UID/PUID/PGID.

El caso original usó 0777 y noperm como solución general

La publicación original montó CIFS con opciones equivalentes a:

file_mode=0777,dir_mode=0777,noperm

Esto puede hacer que prácticamente cualquier identidad local pueda escribir en el recurso compartido y desactiva las comprobaciones normales de permisos del cliente. Es una evidencia útil de que la política de montaje estaba bloqueando a Plex, pero no debería ser la primera solución permanente.

Prefiere una identidad o un grupo multimedia dedicado

Un diseño más seguro consiste en montar el recurso compartido para que los archivos y directorios aparezcan como propiedad del usuario/grupo que Plex debe utilizar, o de un grupo multimedia compartido. Concede permisos de escritura únicamente donde Plex necesite poder eliminar archivos.

Si Plex solo debe leer la mayoría de las bibliotecas, considera hacer escribibles únicamente carpetas administradas específicas.

Verifica también la asignación de volúmenes de Plex

Plex debe utilizar la ruta multimedia dentro del contenedor, mientras que ZimaOS asigna esa ruta al montaje del host. La documentación actual de IceWhale explica esta relación entre el host y el contenedor.

Consulta el modelo de rutas Docker actual de ZimaOS antes de modificar la propiedad.

Plex también debe permitir la eliminación de archivos multimedia

Incluso con los permisos correctos del sistema de archivos, la configuración de la biblioteca o del servidor de Plex debe permitir la eliminación cuando corresponda. Una prueba del sistema de archivos desde el contenedor puede distinguir entre problemas de configuración de Plex y problemas de permisos del sistema operativo.

Prueba con un archivo desechable

Crea o copia un archivo de prueba pequeño en la carpeta multimedia de destino, confirma que Plex puede verlo, elimínalo desde Plex y verifica que desaparezca del recurso compartido subyacente. No pruebes los cambios de permisos eliminando primero contenido multimedia único.

Preguntas frecuentes sobre la eliminación en Plex

¿Que Plex pueda leer un archivo demuestra que puede eliminarlo?

No. Para eliminarlo se necesitan permisos de escritura en el directorio que lo contiene.

¿Funcionaron chmod/el modo de montaje 0777 en el caso original?

El usuario informó que funcionó después de volver a montar CIFS con permisos muy permisivos, pero no es el diseño recomendado según el principio de mínimo privilegio.

¿El acceso de root en el host debería solucionar por sí solo un problema de eliminación de Plex mediante SMB?

No. La propiedad y el modo efectivos del montaje CIFS, junto con la identidad del contenedor, siguen determinando el comportamiento de escritura.