SSH能登录,SFTP却打不开目录

SSH终端能进去,文件客户端却显示“无法获取目录列表”,通常不需要先改防火墙。先核对客户端用的服务器、端口、账号和密钥是否与成功的SSH连接一致,再确认失败发生在认证后,还是进入某个目录时。

下面针对Linux服务器上的OpenSSH。服务端命令在管理员终端执行;SFTP测试在自己的电脑执行。保留已经成功的SSH会话,排查期间不要关闭它。

先确认有没有进入SFTP会话

本机已安装OpenSSH客户端时,可以用下面的命令复现。把示例账号、IP和端口换成实际值;使用指定私钥的连接,继续沿用原来的-i参数。SFTP指定端口用大写-P:

sftp -v -P 22 deploy@203.0.113.10

如果出现sftp>提示符,认证和子系统至少已经建立,可以在这个提示符下执行:

pwd
ls -la

先看当前目录能否列出,不要一上来就跳到客户端保存的旧路径。当前目录正常、某个目录失败,继续查路径和权限;显示subsystem request failed或认证后立刻断开,则优先看服务端的SFTP配置与日志。调试输出可能含账号、路径和服务器信息,对外提交前先脱敏。

SSH里的sudo权限不会带进文件客户端

经常出现的情况是:终端里执行sudo ls能看到文件,于是误以为同一账号的SFTP也应该能看。普通SFTP会话使用登录账号的权限,不会继承另一条SSH命令里的提权。

先用服务器上的真实目录检查每一级路径。下面的deploy是SFTP账号,/srv/sftp/deploy/upload是示例目录:

id deploy
sudo namei -l /srv/sftp/deploy/upload
sudo -u deploy -- ls -la /srv/sftp/deploy/upload

namei -l把父目录、所有者、组和权限逐级列出来。穿过每一级父目录都需要搜索权限,也就是目录的x权限;列出目录内文件还需要相应读取权限。只检查最后一个目录,容易漏掉中间某一级的限制。最后一条命令用该账号验证常规文件权限,不能完全代替实际SFTP会话中的chroot或安全策略检查。

发现问题后,只调整业务确实需要访问的那一级目录或授权组,具体操作可参照文件权限与归属教程。不要把整棵网站目录递归改成上传账号,也不要用chmod -R 777处理。若常规权限看起来正常,继续核对ACL及已有SELinux、AppArmor拒绝记录,不要先关闭保护。

受限账号看到的“根目录”可能不同

配置了ChrootDirectory时,文件客户端看到的/可以对应服务器上的某个子目录。例如实际限制根目录是/srv/sftp/deploy,服务器文件夹/srv/sftp/deploy/upload在SFTP里应按/upload访问。把服务器上的完整路径原样填进客户端,反而可能得到“目录不存在”。

chroot根目录及其各级父目录必须由root拥有,且不能允许组或其他用户写入。需要上传时,在这个边界内部单独准备可写子目录;不能为了让上传成功,直接把chroot根目录交给上传账号。指向边界外的软链接也不会因此变成可访问路径。

这一步应以账号实际匹配的配置为准,尤其是Match User、Match Group和ForceCommand。同一台服务器上,不同账号可能进入完全不同的目录视图。

子系统失败时,核对实际配置和同一时刻的日志

以下适用于使用默认配置路径的OpenSSH。addr填服务器看到的客户端来源IP,host填实际解析的客户端主机名,laddr和lport填服务端接收连接的地址和端口,账号也要替换。使用自定义配置启动的实例,应沿用它的-f路径和相关启动参数:

sudo /usr/sbin/sshd -T -C user=deploy,addr=198.51.100.25,host=client.example,laddr=203.0.113.10,lport=22 | grep -E '^(subsystem|chrootdirectory|forcecommand) '
sudo journalctl -u ssh.service --since '10 minutes ago' --no-pager -n 80

Ubuntu、Debian常用ssh.service;实际服务名不同就替换。日志中的子系统路径不存在、chroot所有权不合要求,与普通目录“Permission denied”是不同问题。外部sftp-server要核对实际安装路径;使用internal-sftp则不依赖这个外部程序。修正原配置时保留已有访问限制,不要重复追加另一条Subsystem sftp。

配置变更按SSH配置检查与安全重载操作:先备份、检查语法,再重载实际服务,保留旧会话。最后新开SFTP连接,确认能列出目标目录;确实需要上传的账号,再在约定测试目录传一个无敏感信息、无同名冲突的小文件,下载核对后删除测试文件。目录能打开不等于上传权限也已经正确。