创建只能访问指定目录的SFTP账号:禁止终端和端口转发

适用范围

本文按Ubuntu 24.04自带OpenSSH说明,为交付文件创建一个独立账号sftp-client,只允许进入自己的上传目录。它不授予SSH终端、sudo或端口转发权限;这是限制访问范围的文件交付账号,不是禁止下载、覆盖或删除的只投递账号。不要拿现有管理员或网站运行账号直接改成受限账号,避免影响部署与登录。

开始前备份/etc/ssh/sshd_config及相关Include配置,保留当前管理员连接,并确认另一种恢复入口可用。示例使用密钥认证,请先取得使用者的公钥;私钥应留在使用者电脑上。现有AllowUsers、AllowGroups或Match规则也可能限制新账号,必须一并检查。

一、建立专用账号与目录

确认以下账号和组尚不存在,再执行。adduser会要求设置账号密码及资料,密码按正常强度设置,但下面的SSH规则仅接受公钥。不要把管理员加入sftp-only组。

sudo addgroup sftp-only
sudo adduser --no-create-home --home /upload \
  --shell /usr/sbin/nologin sftp-client
sudo adduser sftp-client sftp-only

sudo install -d -o root -g root -m 0755 \
  /srv/sftp /srv/sftp/sftp-client
sudo install -d -o sftp-client -g sftp-client -m 0750 \
  /srv/sftp/sftp-client/upload
namei -l /srv/sftp/sftp-client

隔离根目录以及/srv等上级目录必须由root拥有,且其他用户和组不可写。只有下面的upload归sftp-client写入。把整个隔离根目录chown给上传用户会导致检查失败;不能用777解决。

二、安装公钥并添加受限规则

sudo install -d -o root -g root -m 0755 /etc/ssh/authorized_keys
sudoedit /etc/ssh/authorized_keys/sftp-client
sudo chown root:root /etc/ssh/authorized_keys/sftp-client
sudo chmod 0644 /etc/ssh/authorized_keys/sftp-client

在文件中粘贴使用者完整的一行公钥。这里保存的是公钥,644允许认证过程读取,由root管理防止用户自行添加新钥匙。不要写入私钥、登录密码或其他人的公钥。

在主配置文件末尾添加以下Match块,且不得覆盖原内容。若已有匹配这个账号的Match规则,要合并并检查实际生效值,不能认为最后写入的一定覆盖前面。

Match Group sftp-only
    ChrootDirectory /srv/sftp/%u
    ForceCommand internal-sftp -d /upload
    AuthorizedKeysFile /etc/ssh/authorized_keys/%u
    AuthenticationMethods publickey
    PubkeyAuthentication yes
    PasswordAuthentication no
    KbdInteractiveAuthentication no
    DisableForwarding yes
    PermitTTY no

三、先检测,再重载SSH

sudo /usr/sbin/sshd -t
sudo /usr/sbin/sshd -T -C user=sftp-client,host=client,addr=192.0.2.10

把addr替换为真实客户端地址。检查chrootdirectory、forcecommand、authorizedkeysfile、authenticationmethods和disableforwarding等值;再用实际管理员用户名和地址执行一次,确认管理员没有被限制。检测无误后执行sudo systemctl reload ssh,不要关闭原管理员窗口。

四、用新连接验收

使用SFTP客户端输入服务器地址、SSH端口、sftp-client及对应私钥。登录后应位于/upload,可以上传、下载和删除自己的测试文件,但不能在隔离根目录写文件,也不能访问其他项目。另开终端以该账号运行普通SSH命令,应无法获得交互式Shell。

重新建立一次管理员连接,确认原管理方式仍可用。认证失败先看SSH日志、实际Match值、公钥和账号状态;认证成功但目录被拒绝,检查隔离目录各级属主。不要关闭StrictModes或撤掉隔离来绕过错误。

这类账号没有自动容量配额,上传大文件前仍需安排磁盘限制和空间监控。停用时撤销该账号公钥及其他认证入口,并结束已建立会话;仅删除公钥不会立即中断已经登录的连接。保留文件按交付约定处理。

ForceCommand只限定会话执行的程序,不能单独替代转发限制,所以DisableForwarding也必须在生效配置中确认。每个交付对象建立自己的账号和隔离目录,禁止多人共用一个密钥账号,否则无法单独撤销和追踪操作。