日本服务器挂载NFS后无法写入,怎样检查目录权限与身份映射?

发布人:A5数据发布时间:2026-10-13 17:10阅读量:146

在日本服务器上,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: 注释通常能直接提示这一点。

到 NFS 服务端核对数值 UID、目录权限与 ACL配图

如果使用的是 NFSv4 原生 ACL,仅执行 getfacl 可能不完整。服务端或客户端可在已安装相应工具时检查:

nfs4_getfacl /srv/nfs/appdata

NFSv4 ACL 与 POSIX ACL 的继承和拒绝规则并不完全相同,不要在没有备份和确认规则的情况下同时使用多套 ACL 工具。

区分文件权限与目录权限

常见故障是管理员只给目标文件加了写权限,但应用实际流程是:

  1. 在目录中创建临时文件;
  2. 写入临时文件;
  3. rename() 覆盖正式文件;
  4. 删除旧文件。

这个流程要求目录具备写和执行权限。可以使用以下方式验证同目录的创建和重命名能力,但只能在专用测试目录执行:

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