菜单
Diagnose NFS/CIFS(SMB) mount failures on this host. Match common error patterns and run read-only client/network checks; suggest fixes without auto-running mount or editing fstab. Also matches Chinese requests such as NFS 挂载、CIFS 挂载、挂载失败、access denied by server while mounting.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/AI-Shell-Team/aish --skill nfs-cifs-mount-diagnose命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | nfs-cifs-mount-diagnose |
| version | 1.0.0 |
| description | Diagnose NFS/CIFS(SMB) mount failures on this host. Match common error patterns and run read-only client/network checks; suggest fixes without auto-running mount or editing fstab. Also matches Chinese requests such as NFS 挂载、CIFS 挂载、挂载失败、access denied by server while mounting. |
| author | aish |
| context | subagent |
| agent | troubleshoot |
| allowed-tools | ["bash","read_file","grep","glob"] |
| triggers | ["nfs-cifs-mount-diagnose","NFS mount","CIFS mount","SMB mount","mount.nfs","mount failed","access denied by server while mounting","mount error","NFS 挂载","CIFS 挂载","SMB 挂载","挂载失败"] |
| platforms | ["linux"] |
| distributions | ["deepin","debian","ubuntu","uos"] |
Troubleshoot NFS or CIFS/SMB mount failures, boot-time automount failures, and permission denials on this host.
Out of scope: automatically running mount/umount, editing fstab, or calling cloud NAS APIs. Suggest only; write actions need explicit user confirmation.
password= / credentials= options.Collect info → error pattern match → client environment → connectivity → recommendations
| Item | Example |
|---|---|
| Protocol | NFS v3/v4 or CIFS/SMB |
| Server | files.example.com or IP |
| Remote path | NFS :/export/data; CIFS //server/share |
| Full error | whole mount.nfs: ... / mount error(13): ... line |
| Context | manual / fstab at boot / inside container |
| Error / symptom | Common cause | Direction |
|---|---|---|
access denied by server while mounting (esp. with a subdirectory path) | Export/ACL/IP, wrong path, or missing subdir | Do not assume “subdir missing” from the message alone; check exports (showmount -e), then the path |
mount.nfs: No such device | nfs/sunrpc not loaded, or bad sunrpc option spelling |
Check lsmod, /etc/modprobe.d/*sunrpc*; use tcp_slot_table_entries not tcp_slot_entries |
Operation not permitted on NFSv4 while v3 works | NFSv4 client id / hostname conflict, etc. | Try v3 to confirm; check hostname / nfs4 unique id; check server exports |
Connection timed out / No route to host | Network, firewall, NFS/RPC ports | ping / 2049 / 111 before tuning mount options |
Protocol not supported | Missing nfs-common or version mismatch | Install client package; align vers= |
| Works manually, fails at boot | remote-fs / fstab options / network not ready | _netdev, x-systemd.automount, remote-fs.target |
mount: can't find ... in /etc/fstab | Wrong mount command shape | Missing source or target in the command |
| Error / symptom | Common cause | Direction |
|---|---|---|
mount error(13): Permission denied | Credentials / share ACL | Check user, domain, credentials file mode 0600 |
mount error(112): Host is down / cannot connect | Host, firewall, SMB port 445 | nc -zv <server> 445 |
mount error(2): No such file or directory | Wrong share/path | Verify //server/share |
mount error(95): Operation not supported | Dialect/version mismatch | Try vers=3.0 / 2.1 / 1.0 (legacy) |
Missing mount.cifs | cifs-utils not installed | Debian/Ubuntu: cifs-utils |
findmnt -t nfs,nfs4,cifs 2>/dev/null
grep -E 'nfs|cifs|smb' /etc/fstab 2>/dev/null
command -v mount.nfs; dpkg -l nfs-common 2>/dev/null | tail -1
lsmod | grep -E 'nfs|sunrpc'
ls /etc/modprobe.d/*nfs* /etc/modprobe.d/*sunrpc* 2>/dev/null
command -v mount.cifs; dpkg -l cifs-utils 2>/dev/null | tail -1
lsmod | grep cifs
getent ahosts <server> | head -5
ping -c 3 -W 2 <server>
nc -zv -w 3 <server> 2049
nc -zv -w 3 <server> 111
rpcinfo -p <server> 2>/dev/null | head -20
showmount -e <server> 2>/dev/null | head -20
nc -zv -w 3 <server> 445
Port/RPC issues → fix network/firewall before mount options.
Resolve fails → consider dns-diagnose.
sudo mount -t nfs -o vers=4,proto=tcp <server>:/export /mnt/point
sudo mount -t nfs -o vers=3,proto=tcp <server>:/export /mnt/point
sudo mount -t cifs //server/share /mnt/point -o username=<user>,uid=$(id -u),gid=$(id -g),vers=3.0
Debian/Ubuntu client packages: nfs-common, cifs-utils.
## Conclusion
1–2 sentences: protocol + most likely cause.
## Evidence
- User error text and matched pattern
- Client packages/modules, fstab, port checks
## Recommendations
- Prioritized fix steps (user confirms before running)
- Never echo passwords into the chat or logs; remind about credential file permissions
Reply in the user's language.
| Case | Skill |
|---|---|
| DNS failure before mount | dns-diagnose |
| Loss/latency to file server | network-path-diagnose |
| System lag after a successful mount | diagnose_system_lag |
User: mount.nfs: access denied by server while mounting 10.0.0.5:/data/backup
showmount -e / RPC checks; try export root only if appropriate/backup fails → fix subdir