日本服务器挂载NFS后无法写入,怎样检查目录权限与身份映射?
在日本服务器上,NFS 挂载点能够正常列出文件,但应用执行 touch、上传文件或生成临时文件时返回 Permission denied,通常不代表挂载失败。挂载成功只说明客户端完成了 NFS 会话建立,真正的写入还要经过导出规则、客户端进程身份、服务端 UID/GID、目录权限、ACL 以及文件系统只读状态等多层检查。
排查时不要先把目录改成 777,也不要用客户端 root 成功写入作为判断依据。应先确认实际执行写入的用户和用户组,再到 NFS 服务端核对数值 UID/GID、父级目录的遍历权限、root_squash 和 NFSv4 身份映射。日本服务器所在地区不会改变 Linux 的权限机制,但云平台安全组、网络 ACL 或跨地域链路问题,可能影响挂载和访问表现,需要与目录权限问题分开判断。
针对日本地区的业务部署,A5数据提供搭载Xeon Gold、AMD EPYC及NVMe存储的物理服务器,并提供SSD、大容量HDD、多IP和CIA、GIA、CN2、SoftBank等线路方案,可作为NFS客户端、服务端、业务后台、数据库及文件存储的硬件基础,适配不同的数据规模、访问区域与网络需求。
先确认故障属于哪一层
记录实际错误和挂载状态
先在日本服务器客户端执行以下命令。/mnt/appdata 和 /srv/app 只是示例路径,应替换为实际挂载点。
findmnt -T /mnt/appdata -o TARGET,SOURCE,FSTYPE,OPTIONS
mountpoint /mnt/appdata
nfsstat -m
重点观察以下信息:
FSTYPE是否为nfs或nfs4;SOURCE是否为预期的 NFS 服务端和导出路径;OPTIONS中是否包含ro;- 是否使用了
sec=sys、sec=krb5等认证方式; - NFS 客户端是否出现超时、重传或服务端拒绝。
如果 mountpoint 返回“不是挂载点”,问题还没有进入目录权限阶段,应先检查挂载配置、NFS 服务端可达性和导出规则。如果挂载点存在,能够读取文件,但写入提示 Permission denied,网络和基础挂载通常已经正常,接下来应重点检查身份与权限。
如果错误是 Read-only file system,则不要继续修改目录权限。它可能来自客户端以只读方式挂载、服务端导出为 ro,也可能是服务端底层文件系统因错误被内核切换为只读。

用一个无业务意义的测试文件复现
不要直接在生产数据文件上执行写入测试。可以在专门的测试目录中使用一个固定名称,避免误删业务文件:
sudo -u appuser -- sh -c '
test_dir=/mnt/appdata/.permission-check
test_file="$test_dir/.write-test-$(id -u)"
mkdir -p "$test_dir" 2>/dev/null || true
printf "nfs-permission-test\n" > "$test_file"
stat "$test_file"
'
这条命令的前提是 appuser 是实际运行应用的账号,并且测试目录已经由管理员创建。若测试目录不存在,普通服务用户通常没有权限执行 mkdir,此时应由管理员在确认路径后单独创建,而不是让应用账号获得更高权限。
结果可以这样理解:
Permission denied:优先检查目录权限、ACL、UID/GID 映射或root_squash;Read-only file system:优先检查挂载选项、导出选项和服务端文件系统状态;Operation not permitted:除普通权限外,还要检查 ACL、不可变属性、文件系统策略或身份被压缩为匿名用户;- 能创建文件但应用仍失败:可能是应用需要在同一目录执行临时文件创建、重命名或删除,不能只测试单次
touch。
确认测试文件确实是刚才创建的文件后,再执行清理:
sudo -u appuser -- sh -c '
test_file=/mnt/appdata/.permission-check/.write-test-$(id -u)
rm -f -- "$test_file"
'
清理命令中的路径必须与测试路径完全一致。不要对挂载根目录使用通配符删除。
由外到内检查挂载、导出和客户端身份
先排除只读和导出范围问题
在客户端查看挂载参数:
findmnt -no TARGET,SOURCE,FSTYPE,OPTIONS -T /mnt/appdata
如果输出中出现 ro,客户端是只读挂载。若服务端导出也设置了 ro,单独在客户端执行 mount -o remount,rw 不会真正解决问题,甚至可能造成误判。
在 NFS 服务端查看当前生效的导出配置:
sudo exportfs -v
sudo grep -RInE '^[[:space:]]*[^#].*\(' /etc/exports /etc/exports.d 2>/dev/null
需要核对:
- 日本服务器客户端 IP 是否匹配导出规则;
- 导出选项是
rw还是ro; - 是否存在
all_squash; - 是否启用了
root_squash; - 是否配置了
anonuid和anongid; - NFSv4 导出路径是否与客户端实际挂载路径一致。
如果客户端在挂载时就收到 access denied by server,主要是导出客户端匹配、网络来源地址或 NFS 版本问题。如果挂载后可以读取,只在写入阶段被拒绝,则更可能是 Unix 权限、ACL 或身份映射。
showmount -e 可以辅助查看部分 NFS 导出,但它依赖 mountd,对某些 NFSv4 环境不能完整反映实际导出情况,因此不能只依据它判断权限:
showmount -e nfs.example.internal
确认真正发起写入的账号
在交互式终端中执行 id,只能说明当前登录用户,不能代表 systemd 服务、容器或定时任务的身份。
对于 systemd 管理的应用,可以查看服务配置:
systemctl show app.service \
-p User \
-p Group \
-p SupplementaryGroups
再查看实际进程:
ps -eo user,group,egroup,pid,cmd | grep '[a]pp'
将 app.service 和进程匹配到的应用名称替换为实际服务名。需要特别关注以下情况:
- 服务使用了
User=appuser,但管理员一直以root测试; - 服务设置了
Group=,但没有加入应用所需的附加组; - 服务使用
DynamicUser=yes,其 UID 可能不是固定值; - 容器内部显示的用户名相同,但实际 UID 与服务端不一致;
- 应用通过定时任务、守护进程或另一个 worker 用户写入。
在客户端记录账号的数值身份:
id appuser
getent passwd appuser
getent group appwriters
NFS 权限判断不能只看用户名。两个服务器上都叫 appuser 的账号,如果一个 UID 是 1001、另一个 UID 是 2001,它们并不一定被视为同一个用户。对于基于 AUTH_SYS 的常见 NFS 配置,服务端通常根据客户端传来的数值 UID/GID 进行权限判断。

检查客户端到服务端的路径权限
目录写入与普通文件写入的判断不同:
- 新建文件:目标目录需要
w和x; - 在目录中查找或访问文件:目录通常需要
x,列出目录内容还需要r; - 修改已有文件内容:文件需要写权限,同时路径上的每一级目录都需要遍历权限;
- 重命名或删除文件:主要检查父目录的写和执行权限,不只看文件自身权限。
客户端可以先检查路径的每一级目录:
namei -l /mnt/appdata/project/uploads
如果系统没有 namei,可以逐级执行:
ls -ld /mnt /mnt/appdata /mnt/appdata/project /mnt/appdata/project/uploads
namei -l 输出中,任何一级目录缺少服务账号的执行权限,都可能导致访问失败。即使最终目录显示为 drwxrwx---,上层目录没有 x,应用仍然无法进入。
到 NFS 服务端核对数值 UID、目录权限与 ACL
以下检查应在实际存放数据的 NFS 服务端执行,而不是只在日本服务器客户端执行。
使用数值方式查看所有者
sudo stat -c '%A %a %U %G %u %g %n' /srv/nfs/appdata
sudo ls -ldn /srv/nfs/appdata
sudo namei -l /srv/nfs/appdata/project/uploads
其中:
%u是所有者 UID;%g是所属组 GID;ls -n以数字显示 UID/GID,避免被同名账号误导;namei -l用于检查路径中每一级目录的权限。
例如,客户端应用账号是 UID 2001、主组 GID 2001,服务端目录却属于 UID 1001,且所属组也不包含 2001,那么即使两端用户名都显示为 appuser,写入仍可能被拒绝。
检查服务端是否存在同样的账号和组:
getent passwd appuser
getent group appwriters
id appuser
如果目录使用的是数字 UID/GID,先以数字为准,不要立即通过修改用户名或递归 chown 来“统一”。
检查 POSIX ACL 和权限掩码
普通 ls -l 看不到完整 ACL。服务端执行:
getfacl -p /srv/nfs/appdata
getfacl -p /srv/nfs/appdata/project/uploads
重点看:
- 是否有针对应用用户或应用组的 ACL;
mask::是否限制了命名用户和命名组的实际权限;default:ACL 是否影响新建文件和目录;other::是否被误认为可以替代应用组权限。
例如,下面这类 ACL 表面上给了应用组 rwx,但 mask::r-x 会把实际有效权限限制为不可写:
group:appwriters:rwx
mask::r-x
实际有效权限相当于 r-x,应用写入仍会失败。ACL 输出中的 #effective: 注释通常能直接提示这一点。

如果使用的是 NFSv4 原生 ACL,仅执行 getfacl 可能不完整。服务端或客户端可在已安装相应工具时检查:
nfs4_getfacl /srv/nfs/appdata
NFSv4 ACL 与 POSIX ACL 的继承和拒绝规则并不完全相同,不要在没有备份和确认规则的情况下同时使用多套 ACL 工具。
区分文件权限与目录权限
常见故障是管理员只给目标文件加了写权限,但应用实际流程是:
- 在目录中创建临时文件;
- 写入临时文件;
rename()覆盖正式文件;- 删除旧文件。
这个流程要求目录具备写和执行权限。可以使用以下方式验证同目录的创建和重命名能力,但只能在专用测试目录执行:
sudo -u appuser -- sh -c '
set -eu
d=/mnt/appdata/.permission-check
a="$d/.nfs-a-$(id -u)"
b="$d/.nfs-b-$(id -u)"
printf "temporary-data\n" > "$a"
mv "$a" "$b"
rm -f -- "$b"
'
如果单独写已有文件成功,但这组测试失败,故障点更可能是父目录权限、ACL、目录的 sticky bit 或应用使用了不同的工作目录。
带有 t 的目录权限,例如 drwxrwxrwt,表示启用了 sticky bit。此时删除或重命名文件还要满足文件所有者、目录所有者等条件,不能仅凭目录可写就认为任何用户都能删除其中的文件。
重点检查 NFS 身份映射
NFSv3 或 sec=sys 下优先看数字 UID/GID
在常见的 sec=sys 配置中,客户端把进程的 UID、主组和附加组信息发送给服务端。服务端本地权限系统再根据这些数值判断是否允许操作。
因此,以下做法都可能导致写入失败:
- 两端同名账号的 UID 不一致;
- 应用使用附加组,但 systemd 没有加入该组;
- 容器内 UID 与服务端目录所有者不一致;
- 目录所属组正确,但客户端进程没有携带该附加组;
- 导出使用
all_squash,导致所有客户端身份都被压缩为匿名账号。
客户端查看实际挂载安全模式:
nfsstat -m
服务端查看导出选项:
sudo exportfs -v
不要使用 mount -o uid=... 作为普通 NFS 权限修复手段。此类选项常用于某些本地文件系统或特殊文件系统,不能替代 NFS 服务端的 UID/GID、目录权限和导出策略。
NFSv4 还要核对 idmapd 域
NFSv4 的所有者和组属性还涉及名称与数值 ID 的映射。客户端和服务端的 NFSv4 身份映射域不一致时,文件可能显示为 nobody,或者出现数字 ID 无法解析的情况。
分别在客户端和服务端检查:
grep -nE '^[[:space:]]*(Domain|Nobody-User|Nobody-Group)[[:space:]]*=' /etc/idmapd.conf
nfsidmap -d
重点核对:
- 两端
Domain是否一致; Nobody-User和Nobody-Group是否指向存在的本地账号;- 服务端和客户端是否确实使用 NFSv4;
- 是否有旧的映射缓存;
- NFSv4 ACL 是否另外拒绝了写入。
如果输出显示为 nobody,不能直接把 nobody 当成应用用户。它可能表示身份映射失败,也可能是导出配置有意将身份压缩到了匿名用户。应同时检查内核和系统日志:
journalctl -k -b | grep -Ei 'nfs|idmap|rpc'
修改 idmapd.conf 前应保存原文件:
sudo cp -a /etc/idmapd.conf \
"/root/idmapd.conf.bak.$(date +%F-%H%M%S)"
不同发行版对 nfs-idmapd 的服务管理方式并不完全相同,不要直接猜测服务名。先确认可用单元:
systemctl list-unit-files | grep -E 'nfs-idmapd|rpc.idmapd'
再按实际存在的服务重新加载或重启。身份映射缓存更新后,通常还需要重新挂载或重新建立 NFS 会话,才能确认新映射已经生效。重新挂载可能影响正在访问该挂载点的应用,应安排在业务可接受的时间执行。
了解 root_squash 为什么会让 root 测试失败
服务端导出规则常见以下选项:
| 导出选项 | 对身份的影响 | 排查含义 |
|---|---|---|
root_squash | 将客户端 root 映射为匿名身份 | 客户端 root 无法代表服务端 root |
no_root_squash | 保留客户端 root 身份 | 权限较宽,需严格限制可信客户端 |
all_squash | 将所有客户端用户映射为匿名身份 | 所有写入都受匿名 UID/GID 权限控制 |
anonuid= | 指定匿名身份的 UID | 影响被压缩用户的服务端权限 |
anongid= | 指定匿名身份的 GID | 影响被压缩用户的组权限 |
rw | 允许写入,仍受 Unix 权限和 ACL 约束 | 不是无条件可写 |
ro | 导出只读 | 修改目录权限不能变成可写 |
如果服务端启用了 root_squash,在日本服务器上使用 sudo touch 失败是正常的安全表现。此时要测试的是实际应用账号,而不是继续尝试更高权限。
不建议为了让部署脚本通过而直接改成 no_root_squash。该选项会扩大客户端 root 对服务端文件的操作能力,尤其不适合客户端范围较大、主机权限边界不清晰的导出。若确实需要自动化写入,应优先使用固定的专用 UID/GID、独立导出路径和最小权限目录。
按故障结果选择修复方式
结果是 Permission denied
优先检查服务端目录所有者、所属组、ACL 及路径中每一级目录。较稳妥的做法是使用专用写入组,并让客户端服务账号加入该组。
先在两端确认组的数值 GID:
getent group appwriters
id appuser
如果决定采用组权限,必须保证服务端目录使用的 GID 与客户端进程实际携带的 GID 一致。服务端可以先备份当前 ACL:
sudo getfacl -p /srv/nfs/appdata \
| sudo tee "/root/appdata.acl.$(date +%F-%H%M%S)" >/dev/null
在确认目录确实应授予 appwriters 写入权后,可针对单个目录增加 ACL:
sudo setfacl -m g:appwriters:rwx,m::rwx /srv/nfs/appdata
这会修改目标目录的访问 ACL,不会自动修复其所有子目录。m::rwx 是 ACL 权限掩码,可能扩大已有命名用户或命名组的有效权限,执行前应先查看原 ACL。
如果应用需要在该目录下创建的新目录和文件继承组权限,可以配置默认 ACL,但应根据应用是否需要读取、写入和执行分别设置:
sudo setfacl -d -m \
u::rwx,g::r-x,g:appwriters:rwx,m::rwx,o::--- \
/srv/nfs/appdata
默认 ACL 只影响之后创建的对象,不会自动改变已有文件。应用自身的 umask、NFS ACL 和文件创建方式也可能继续限制最终权限,因此必须通过实际服务账号复测。
如果不使用 ACL,而是采用目录组权限,也可以考虑设置目录的 setgid 属性,使新建对象继承目录组:
sudo chgrp appwriters /srv/nfs/appdata
sudo chmod 2770 /srv/nfs/appdata
这会直接改变目录的所属组和模式,适用前提是目录确实应该只允许所有者和 appwriters 组访问。不要在不确认现有访问方的情况下对共享根目录执行。
ACL 修改的回滚应使用修改前保存的 ACL:
sudo setfacl --restore=/root/appdata.acl.YYYY-MM-DD-HHMMSS
将示例文件名替换为实际备份文件。恢复前要确认备份内容对应的是同一个目录,避免把其他目录的 ACL 应用到生产路径。
结果是 Read-only file system
分别在客户端和服务端检查:
findmnt -no TARGET,SOURCE,OPTIONS -T /mnt/appdata
服务端还要检查底层文件系统:
findmnt -T /srv/nfs/appdata
sudo journalctl -k -b | grep -Ei 'read-only|I/O error|filesystem|nfs'
如果是导出配置中的 ro,需要修改服务端导出文件。修改前备份:
sudo cp -a /etc/exports \
"/root/exports.bak.$(date +%F-%H%M%S)"
编辑时只调整对应客户端和对应导出,不要顺带改变其他主机的访问范围。完成检查后重新加载导出:
sudo exportfs -rav
sudo exportfs -v
exportfs -rav 会重新读取并应用导出配置,可能影响当前所有导出,适合在确认变更范围后执行。若需要回滚,应恢复备份文件,再重新执行 exportfs -rav,并确认 exportfs -v 已回到原状态。
如果服务端底层文件系统因为磁盘、I/O 或文件系统错误变为只读,不应仅通过重新挂载为读写来掩盖问题。先确认数据完整性和磁盘状态,再按该发行版的文件系统维护流程处理。
结果是 root 失败,但应用账号也失败
这通常说明问题并非单纯的 root_squash。继续对比应用账号在两端的数字身份,并检查 all_squash、ACL 和服务端目录权限。
如果只有客户端 root 失败,而应用账号成功,说明 root_squash 可能正在按预期工作,不需要修复。
如果应用账号的 UID/GID 确实不一致,优先选择专用目录进行身份调整。记录旧的数值所有者后,再修改目录本身,不要直接递归修改整棵共享目录:
sudo stat -c '%u:%g %n' /srv/nfs/appdata
sudo chown 2001:2001 /srv/nfs/appdata
2001:2001 只是示例,必须先确认该 UID/GID 在两端的规划和占用情况。chown 会改变目录所有者,回滚时应使用前面记录的旧 UID/GID,而不是凭用户名猜测。
结果是能创建,但不能重命名或删除
检查应用使用的临时目录是否与目标文件处在同一挂载点,并检查父目录的 w+x 权限、sticky bit 和 ACL。应用覆盖文件通常依赖 rename(),只给文件本身增加写权限并不足够。
如果删除操作返回 Operation not permitted,还要检查:
sudo lsattr /srv/nfs/appdata/project/uploads/target-file
若文件带有不可变属性,需要在确认业务影响、保存原属性并具备服务端管理员权限后处理。不要对整个目录递归执行属性清除。
结果是显示 nobody 或数字身份异常
优先回到 NFSv4 的 idmapd 域、映射缓存和 Nobody-User/Nobody-Group 配置。若服务端使用 all_squash 或显式匿名 UID/GID,则 nobody 也可能是配置结果,而不是映射故障。
此时不要直接把服务端目录改成 nobody:nobody。应先明确目标:
- 如果希望只有某个应用写入,应使用专用 UID/GID 或专用组;
- 如果确实要把多个客户端统一映射为匿名身份,应将导出限制在明确的可信客户端,并只给匿名 UID/GID 访问专用目录;
- 如果是 NFSv4 名称映射错误,应修正两端域和映射配置,而不是永久依赖匿名账号。
修复后的验证方式
修复后必须使用与生产进程相同的身份验证,不能只执行一次管理员 touch。建议按以下顺序复测。
先验证目录级操作
在专用测试目录中测试创建、写入、重命名和删除:
sudo -u appuser -- sh -c '
set -eu
d=/mnt/appdata/.permission-check
src="$d/.verify-src-$(id -u)"
dst="$d/.verify-dst-$(id -u)"
printf "nfs-verification\n" > "$src"
test -s "$src"
mv "$src" "$dst"
test -s "$dst"
rm -f -- "$dst"
'
命令成功表示该账号至少具备这组基本目录操作能力,但不代表所有业务路径都正确。还需要使用应用实际配置的目录、实际 systemd 服务和实际运行方式测试。
再验证服务端看到的身份
在服务端查看新建测试文件的数值所有者:
sudo stat -c 'mode=%A uid=%u gid=%g path=%n' \
/srv/nfs/appdata/.permission-check/.verify-dst-2001
如果客户端应用账号是 UID 2001,服务端看到的 UID 应与预期一致;若显示为匿名 UID、nobody 对应 UID 或其他数字,应回到 root_squash、all_squash 和 NFSv4 身份映射继续排查。
最后验证应用自身
重启应用或重新加载其工作进程后,观察应用日志:
journalctl -u app.service --since "10 minutes ago" \
| grep -Ei 'permission denied|read-only|operation not permitted|nfs'
如果应用使用多个 worker,确认每个 worker 的 UID、GID 和工作目录一致。部署系统、定时任务和容器也要分别验证,因为它们可能与交互式 shell 使用不同身份。
复测后保持一段时间观察
权限修复不是把目录改成可写就结束。至少应在一次完整的上传、生成临时文件、重命名、读取和清理流程后,确认应用日志不再出现 EACCES、EROFS 或 EPERM,并在服务端检查新文件的 UID/GID、所属组和继承 ACL。
后续观察可以保留以下信息:
- 客户端
findmnt中的 NFS 版本和挂载选项; - 服务端
exportfs -v的导出选项; - 应用服务实际使用的
User、Group和附加组; - 目录 ACL 备份和变更记录;
- NFS 客户端与服务端的内核日志;
- 应用创建文件的所有者、所属组和模式。
如果权限问题在服务重启、重新挂载或新增文件后再次出现,重点检查动态用户 UID、默认 ACL、NFSv4 映射缓存以及部署脚本是否重新创建了目录。保留原始配置和 ACL 备份,后续每次只针对一个因素调整,才能明确是哪一层解决了写入故障,也能在变更效果不符合预期时安全恢复。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3545.html