Este conteúdo foi traduzido automaticamente. Consulte a Limitação de Responsabilidade da tradução automática.

Why can’t I overwrite files on a QNAP NAS when accessing it via Client for NFS on a Windows Server?

Por que não consigo substituir ficheiros num NAS QNAP ao aceder através do Cliente para NFS num Windows Server?

Data da última modificação: 2026-01-07

Applicable Products

All QNAP NAS series
Windows Server (any supported version)

Scenario

A user accesses a QNAP NAS shared folder via Network File Services (NFS) from a Windows Server running a supported version. When copying a file with the same name, Windows displays the Replace or Skip Files prompt, indicating that an existing file is present on the NAS.

However, after selecting Replace the file in the destination, the operation fails with an access denied or permission error, preventing the file from being overwritten or updated.

Root Cause

This behavior is a known limitation of the Client for NFS feature in Windows Server and is independent of the NAS configuration. The same behavior is observed across all supported Windows Server versions that include Client for NFS.

Client for NFS supports only NFSv2 and NFSv3 and does not support NFSv4 ACLs. As a result, it cannot negotiate or modify POSIX ACLs over NFS.
By default, Client for NFS accesses NFS shares using an anonymous UID and GID. If the NAS does not grant write permissions to this anonymous identity, write operations fail.
Access is denied unless the anonymous UID and GID are explicitly mapped to a UID and GID that the NAS recognizes and allows to write to the shared folder, regardless of the shared folder’s configured write permissions.

Note

These settings must be configured on the Windows Server.

Solution

To resolve this issue, map the anonymous NFS user on the Windows Server to a UID and GID that the NAS allows to write to the shared folder.

You can apply the configuration using one of the following methods.

Method 1: Configure Using PowerShell (Recommended)

Open PowerShell as an Administrator.
Launch PowerShell with administrative privileges.

Run the following commands to map the anonymous UID and GID to 0, which corresponds to the QNAP root user.

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" -Name AnonymousUid -Value 0 -PropertyType DWord

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" -Name AnonymousGid -Value 0 -PropertyType DWord

Run the following command to restart Client for NFS or reboot the system to apply the changes:
```
nfsadmin client restart
```
Tip
Alternatively, you can restart the Windows Server.

Method 2: Configure Using the Windows Registry

Press Win + R.
Type regedit.
Press Enter.

Navigate to the following registry path:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default

Go to Edit > New, and then click DWORD (32-bit) Value.
Create the following two DWORD (32-bit) values inside the default folder:
- AnonymousUid = 0
- AnonymousGid = 0
Apply the changes by restarting the NFS client:
```
nfsadmin client restart
```
Tip
Alternatively, you can restart the Windows Server.

Important

Mapping the UID and GID to 0 allows Client for NFS to access the NAS as the root user. Ensure that the NAS shared folder grants write permissions to this identity.
Apply these settings on each Windows Server that accesses the NFS share.
This applies to all Windows versions that support the Client for NFS feature.
For environments that require fine-grained permission control or NFSv4 ACL support, Windows Server acting as an NFS client is not supported.

Produtos Aplicáveis

All QNAP NAS series
Windows Server (any supported version)

Cenário

Um utilizador acede a uma pasta partilhada do NAS QNAP através dos Serviços de Ficheiros de Rede (NFS) a partir de um Windows Server com uma versão suportada. Ao copiar um ficheiro com o mesmo nome, o Windows apresenta o Substituir ou Ignorar Ficheiros indicação de que existe um ficheiro existente no NAS.

No entanto, após selecionar Substituir o ficheiro no destino, a operação falha com um erro de acesso negado ou de permissão, impedindo que o ficheiro seja substituído ou atualizado.

Causa Raiz

Este comportamento é uma limitação conhecida da funcionalidade Cliente para NFS no Windows Server e é independente da configuração do NAS. O mesmo comportamento é observado em todas as versões suportadas do Windows Server que incluem Cliente para NFS.

O Cliente para NFS suporta apenas NFSv2 e NFSv3 e não suporta ACLs NFSv4. Como resultado, não pode negociar ou modificar ACLs POSIX sobre NFS.
Por defeito, o Cliente para NFS acede a partilhas NFS utilizando um UID e GID anónimos. Se o NAS não conceder permissões de escrita a esta identidade anónima, as operações de escrita falham.
O acesso é negado a menos que o UID e GID anónimos sejam explicitamente mapeados para um UID e GID que o NAS reconheça e permita escrever na pasta partilhada, independentemente das permissões de escrita configuradas na pasta partilhada.

Nota

Estas definições devem ser configuradas no Windows Server.

Solução

Para resolver este problema, mapeie o utilizador NFS anónimo no Windows Server para um UID e GID que o NAS permita escrever na pasta partilhada.

Pode aplicar a configuração utilizando um dos seguintes métodos.

Método 1: Configurar Usando PowerShell (Recomendado)

Abrir PowerShell como um administrador.
Iniciar PowerShell com privilégios administrativos.

Execute os seguintes comandos para mapear o UID e GID anónimos para 0, que corresponde ao utilizador root do QNAP.

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" -Name AnonymousUid -Value 0 -PropertyType DWord

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" -Name AnonymousGid -Value 0 -PropertyType DWord

Execute o seguinte comando para reiniciar o Cliente para NFS ou reiniciar o sistema para aplicar as alterações:
```
nfsadmin client restart
```
Sugestão
Alternativamente, pode reiniciar o Windows Server.

Método 2: Configurar Usando o Registo do Windows

Pressione Win + R.
Escreva regedit.
Pressione Enter.

Navegue até ao seguinte caminho de registo:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default

Vá a Editar > N ovo, e depois clique em Valor DWORD (32 bits).
Crie os seguintes dois valores DWORD (32 bits) dentro da pasta padrão:
- AnonymousUid = 0
- AnonymousGid = 0
Aplique as alterações reiniciando o cliente NFS:
```
nfsadmin client restart
```
Sugestão
Alternativamente, pode reiniciar o Windows Server.

Importante

Mapear o UID e o GID para 0 permite que o Cliente para NFS aceda ao NAS como utilizador root. Certifique-se de que a pasta partilhada do NAS concede permissões de escrita a esta identidade.
Aplique estas definições em cada Windows Server que aceda à partilha NFS.
Isto aplica-se a todas as versões do Windows que suportam a funcionalidade Cliente para NFS.
Para ambientes que requerem controlo de permissões detalhado ou suporte de ACL NFSv4, o Windows Server a atuar como cliente NFS não é suportado.

Leitura Adicional

Visão Geral do NFS no Windows Server

Este artigo foi útil?

Sim. Não.

Para obter mais ajuda, pergunte a outros utilizadores e aos especialistas da QNAP na comunidade. Ir para a Comunidade QNAP

Conte-nos como podemos melhorar este artigo:

Informações importantes estão faltando no artigo
As soluções do artigo não funcionam
O artigo é muito complicado
O artigo contém informações incorretas
O artigo está desatualizado

Se quiser enviar outros comentários, escreva-os abaixo.