Solução da comunidade

O Plex não consegue eliminar ficheiros multimédia no ZimaOS: permissões de montagem SMB, identidade do contentor e acesso de escrita mais 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.

O Plex conseguir reproduzir um ficheiro, mas não o conseguir eliminar, é um forte indício de um problema de permissões. O acesso de leitura e o acesso de eliminação/escrita são operações diferentes. No caso de origem, os ficheiros multimédia estavam numa partilha de ficheiros montada; o Plex conseguia lê-los, mas a eliminação devolvia «There was a problem deleting file.»

O autor da publicação acabou por remontar a partilha CIFS com modos amplos 0777 e noperm, o que tornou o diretório editável. Isto demonstra que o problema estava na camada efetiva de permissões do sistema de ficheiros/montagem, mas é demasiado permissivo para ser apresentado como configuração permanente preferencial.

O “root” do contentor não explica todas as permissões

O utilizador concedeu acesso root no anfitrião porque o contentor do Plex parecia ser executado como root. No entanto, um contentor Docker continua a aceder a um sistema de ficheiros SMB/CIFS montado através da propriedade, dos modos, das ACL e das opções de montagem desse ponto de montagem no anfitrião.

Conceder permissões root no anfitrião noutro contexto não altera automaticamente a forma como uma montagem CIFS apresenta a propriedade dos ficheiros ao contentor.

Eliminar um ficheiro requer permissão de escrita no diretório pai

Nos sistemas de ficheiros semelhantes ao Unix, eliminar um ficheiro é principalmente uma operação sobre o diretório. Por isso, o Plex pode ler um ficheiro multimédia com sucesso e, ainda assim, não o conseguir remover, porque o diretório pai montado não permite escrita à identidade efetiva do Plex.

Alinhe a identidade efetiva do contentor com a montagem

A comunidade recomendou fazer corresponder o utilizador/grupo do contentor do Plex à propriedade da pasta no anfitrião. É um bom princípio duradouro, mas não deve assumir que o Plex é sempre executado com um UID universal.

Inspecione a configuração atual do contentor e a propriedade efetiva apresentada pela montagem CIFS antes de alterar PLEX_UID/PUID/PGID.

A solução de origem utilizou 0777 e noperm como correção ampla

A publicação de origem montou a CIFS com opções equivalentes a:

file_mode=0777,dir_mode=0777,noperm

Isto pode tornar a partilha editável por praticamente todas as identidades locais e desativa as verificações normais de permissões do lado do cliente. É uma evidência útil de que a política de montagem estava a bloquear o Plex, mas não deve ser a primeira correção permanente.

Prefira uma identidade ou um grupo multimédia dedicado

Uma abordagem mais segura consiste em montar a partilha de modo a que os ficheiros e diretórios apareçam como pertencentes ao utilizador/grupo que o Plex deve utilizar, ou a um grupo multimédia partilhado. Conceda permissões de escrita apenas onde o Plex necessita de capacidade de eliminação.

Se o Plex só precisar de ler a maioria das bibliotecas, considere tornar graváveis apenas pastas geridas específicas.

Verifique também o mapeamento de volumes do Plex

O Plex deve utilizar o caminho multimédia dentro do contentor, enquanto o ZimaOS mapeia esse caminho para a montagem no anfitrião. A documentação atual da IceWhale explica esta relação entre anfitrião e contentor.

Consulte o modelo atual de caminhos Docker do ZimaOS antes de editar a propriedade.

O Plex também tem de permitir a eliminação de multimédia

Mesmo com permissões corretas no sistema de ficheiros, as definições da própria biblioteca/servidor Plex têm de permitir a eliminação, quando aplicável. Um teste ao sistema de ficheiros a partir do contentor pode separar problemas de «definições do Plex» de problemas de «permissões do sistema operativo».

Teste com um único ficheiro descartável

Crie ou copie um pequeno ficheiro para a pasta multimédia de destino, confirme que o Plex o consegue ver, elimine-o através do Plex e verifique se desaparece da partilha subjacente. Não teste alterações de permissões eliminando primeiro ficheiros multimédia únicos.

Perguntas frequentes sobre a eliminação no Plex

O facto de o Plex ler um ficheiro prova que o consegue eliminar?

Não. A eliminação requer permissão de escrita no diretório que contém o ficheiro.

A alteração para chmod/modo de montagem 0777 funcionou na origem?

O utilizador relatou sucesso depois de remontar a CIFS com permissões muito amplas, mas essa não é a abordagem preferencial segundo o princípio do menor privilégio.

O acesso root no anfitrião, por si só, resolve um problema de eliminação SMB no Plex?

Não. A propriedade/modo efetivos da montagem CIFS e a identidade do contentor continuam a determinar o comportamento de escrita.