SSHFS Connection reset by peer:用 SFTP 定位认证和挂载问题

SSHFS 报 read: Connection reset by peer,只能说明它没完成与远端的通信,不能直接判断是密钥坏了。2018 年原故障换用正确的密钥后恢复;下面把网络、SSH 身份验证和 SFTP 子系统分开查。假设你有权访问远端目录,并且已经通过可靠渠道核对主机公钥。

用同一账号、端口和密钥测试 SFTP

sftp -v -P 122 -i "$HOME/.ssh/site-backup" \
  -o IdentitiesOnly=yes backup@example.com

将账号、端口和密钥路径换成自己的值。进入 sftp> 后先执行 ls /srv/share;不要因为能登录普通 SSH shell 就跳过这一步,SFTP 子系统和目录访问仍可能失败。相反,专用 SFTP 账号不能进入交互 shell 也可能是预期设置。

  • Permission denied (publickey):核对远端账号、客户端实际提供的公钥,以及服务端是否接受它。
  • 主机密钥改变:先通过可信渠道核实原因,不要关闭主机密钥校验。
  • 认证成功之后 SFTP 失败:查看服务端日志,检查 SFTP 子系统或受限目录配置。能进入 SFTP 但不能列目录,则检查远端路径和权限。

确认 SFTP 可用后再挂载

先确认本机安装了 SSHFS 和相应的 FUSE 支持,挂载点为空且未被使用。示例用普通账号、只读挂载;不需要让其他本机账号都能访问时,不加 allow_other。

mountpoint="$HOME/mnt/site-share"
mkdir -p "$mountpoint"
sshfs backup@example.com:/srv/share "$mountpoint" -p 122 \
  -o "IdentityFile=$HOME/.ssh/site-backup" \
  -o IdentitiesOnly=yes -o ro -o reconnect
ls -la "$mountpoint"

核对能读到一个已知的远端文件;仅看到本地目录存在不能证明已挂载。排查时可用 SSHFS 的前台调试选项,分享日志前去掉内部路径和主机名。reconnect 用于已建立的连接断开后重连,不会修复初次认证失败。Linux 上需卸载时,可按 FUSE 版本执行 fusermount3 -u "$mountpoint" 或 fusermount -u "$mountpoint",避免直接卸载还在被使用的挂载。

参考 SSHFS 项目说明。原文引用:旧版阿里云知识库链接。