Linux服务器如何搭建SFTP文件传输服务?用户隔离与目录权限配置

给外部合作方、客户或者不同部门提供文件上传下载能力时,最省事的方式是用 SFTP。它不需要额外装服务(OpenSSH 自带子系统),走 SSH 的加密通道,还能通过 chroot 把每个用户锁在自己的目录里,互不干扰。听起来简单,但 chroot 配置恰恰是踩坑最多的地方:配完用户连不上、登录后看不到目录、能登录但写不了文件——这些问题几乎都出在目录属主和权限上。

这篇把 SFTP 服务的搭建讲透:先说明 OpenSSH 的 SFTP 子系统怎么工作,再一步步创建用户、规划目录、写 sshd_config 的 Match 与 ChrootDirectory,重点讲清"为什么 chroot 目录必须属主 root、权限不能给写"这个关键点,然后处理 SELinux 和防火墙,最后给出测试方法和安全加固清单。命令区分 RHEL/CentOS/Rocky 与 Debian/Ubuntu。

一个核心原则先放在前面:chroot 目录及其所有上级目录,属主必须是 root,且不能被其他用户写入。OpenSSH 出于安全考虑会强制检查这一点,不满足就拒绝登录。理解这条,后面所有权限配置就都能想明白。下面开始。

一、SFTP 子系统是怎么工作的

OpenSSH 的 sshd 进程同时处理 SSH 登录和 SFTP。SFTP 不是一个独立守护进程,而是 SSH 会话启动的一个子系统。它的行为完全由 sshd_config 控制,包括认证方式、是否允许 shell、是否 chroot。

关键配置项有两个:

  • Subsystem sftp internal-sftp:表示使用 OpenSSH 内置的 SFTP 实现。相比调用外部的 sftp-server 二进制,内置实现更容易配合 ChrootDirectory 工作,也是官方推荐做法。
  • Match 块:用来对特定用户或用户组应用单独的配置,比如"只有 sftp 组的用户才 chroot、才禁用 shell",不影响系统里其他正常的 SSH 用户。
配置项 作用 推荐值
Subsystem sftp 指定 SFTP 实现 internal-sftp
ChrootDirectory 把用户锁在指定目录 目录属主 root、权限 755
ForceCommand internal-sftp 强制只走 SFTP,不给 shell 在 Match 块内设置
AllowTcpForwarding 禁止端口转发 no(在 Match 块内)
X11Forwarding 禁止 X11 转发 no(在 Match 块内)
PasswordAuthentication 是否允许密码登录 有公钥时设 no

二、规划目录结构

先想清楚目录怎么放,避免后期迁移。一个常见且清晰的结构是:用一个总入口目录承载所有 SFTP 用户,每个用户一个子目录。

/srv/sftp/                  ← 总入口(root 所有,755)
├── alice/                  ← 用户 alice 的根(root 所有,755)
│   ├── upload/             ← 用户可写的目录(alice 所有,755)
│   └── download/           ← 用户可读的目录(root 所有,755)
├── bob/
│   ├── upload/
│   └── download/

要点:

  • 用户登录后看到的根,是他 chroot 到的那个目录(这里是 /srv/sftp/alice),他看不到 /srv/sftp/bob。
  • chroot 根目录本身必须是 root 所有且组/其他用户不可写,否则 sshd 拒绝登录。
  • 用户需要写入的子目录(如 upload/)要单独建,并把属主改成该用户,这样他才能在里面创建文件。
  • 多个用户共享一个上传目录时,可以用同一个属组加 setgid 位,让新文件自动继承组。

三、创建用户与目录

这里以创建 alice 为例,假设你希望她只能用 SFTP、不能 SSH 登录系统。

# 1. 建一个专门的组,方便用 Match Group 统一管理
groupadd sftpusers

# 2. 建用户:不给 shell、加入 sftpusers 组、指定家目录
#    -s /sbin/nologin 表示不给交互式 shell,纯 SFTP 用户
useradd -g sftpusers -d /srv/sftp/alice -s /sbin/nologin alice
# 若用 internal-sftp,shell 写 /sbin/nologin 也可以,sshd 会由 ForceCommand 接管

# 3. 设置密码(若改用公钥则这一步可省)
passwd alice

# 4. 建目录结构
mkdir -p /srv/sftp/alice/upload
mkdir -p /srv/sftp/alice/download

# 5. 关键权限设置:
#    chroot 根目录属主必须是 root,且其他用户不可写(755 或 750)
chown root:root /srv/sftp/alice
chmod 755 /srv/sftp/alice

#    上级目录同样要 root 所有、不可被他写(否则 chroot 检查也过不了)
chown root:root /srv/sftp /srv
chmod 755 /srv/sftp

# 6. 用户可写的子目录归用户所有
chown alice:sftpusers /srv/sftp/alice/upload
chmod 755 /srv/sftp/alice/upload

如果多个用户要共享一个上传区:

# 共享目录用统一的组,并设置 setgid 让新文件继承组
mkdir -p /srv/sftp/shared/upload
chown root:sharedgroup /srv/sftp/shared/upload
chmod 2775 /srv/sftp/shared/upload     # 2 是 setgid 位
# 把相关用户加入 sharedgroup
usermod -aG sharedgroup alice
usermod -aG sharedgroup bob

SELinux 默认策略下,SFTP chroot 目录还需要正确的上下文标签,否则即使权限对也访问不了:

# RHEL/CentOS/Rocky 且 SELinux 为 enforcing 时才需要
semanage fcontext -a -t sshd_sftp_home_dir_t "/srv/sftp/alice(/.*)?"
# 或直接对目录打标签
chcon -R -t sshd_sftp_home_dir_t /srv/sftp/alice

# 若 chroot 目录不在 /home 下,可能还需启用相关布尔值
setsebool -P ssh_chroot_rw_homedirs on

Debian/Ubuntu 默认未启用 SELinux(多为 AppArmor),通常不需要这一步。

四、配置 sshd_config 的 Match 块

编辑 /etc/ssh/sshd_config,先确认子系统配置,再追加针对 SFTP 组的 Match 块。

# /etc/ssh/sshd_config

# 使用内置 SFTP 实现(推荐,配合 chroot 更稳)
Subsystem sftp internal-sftp

# ... 前面的通用配置保持不动 ...

# 针对 sftpusers 组的专属配置,放在文件末尾
Match Group sftpusers
    ChrootDirectory /srv/sftp/%u
    ForceCommand internal-sftp
    AllowTcpForwarding no
    X11Forwarding no
    PasswordAuthentication yes
    PermitTunnel no

说明:

  • ChrootDirectory /srv/sftp/%u 里的 %u 会被替换成用户名,也就是 alice 登录后 chroot 到 /srv/sftp/alice。
  • ForceCommand internal-sftp 强制这个组的所有连接只走 SFTP,不给 shell,即使有人用 ssh 命令连上也无法执行系统命令。
  • Match 块必须放在文件末尾,块内不能再用全局才允许的某些指令,所以通用配置都写在前面。
  • 如果整个服务器就是要做纯 SFTP 服务器,可以把 ChrootDirectory 和 ForceCommand 放到全局,但生产中更推荐用 Match Group 精细控制。

改完先检查语法再重载:

sshd -t                      # 语法检查,有错会直接报行号
systemctl reload sshd        # RHEL 用 sshd;Debian/Ubuntu 是 ssh
# Debian/Ubuntu:
# systemctl reload ssh

风险提示:修改 SSH 配置有把自己锁在服务器外的风险。务必遵守两条纪律:一是改之前备份 cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak;二是保持一个已登录的 SSH 会话不要关,在另一个会话里用 sshd -t 验证并重载,用新会话测试登录是否正常,确认无误后再关闭旧会话。如果 sshd -t 报错,直接还原备份文件重新加载即可回滚。

五、防火墙与端口

SFTP 走 SSH 的端口(默认 22),只需放行这一个端口,比 FTP 的双连接简单得多。

# RHEL/CentOS/Rocky
firewall-cmd --permanent --add-service=ssh
firewall-cmd --reload
# 若用了非标准端口,比如 2222:
firewall-cmd --permanent --add-port=2222/tcp
firewall-cmd --reload

# Debian/Ubuntu
ufw allow ssh
# 或指定端口
ufw allow 2222/tcp

若同时改了 SSH 端口,务必先放行新端口、确认新端口可用,再撤掉旧端口规则,顺序反了会直接断连。

六、验证与排障

从另一台机器用 SFTP 客户端实测:

# 用密码登录
sftp alice@server.example.com
# 用密钥登录
sftp -i ~/.ssh/id_ed25519 alice@server.example.com

# 进入后测试:
# pwd              应显示 "/"(chroot 后的根)
# ls               应能看到 upload 和 download
# cd upload
# put testfile     应能上传成功
# bye

按症状定位问题:

症状 大概率原因 处理
登录被拒,日志报 bad ownership or modes for chroot directory chroot 目录属主不是 root 或权限给了写 chown root:root + chmod 755
能登录但提示 received message too long 用户的 shell 或启动脚本输出了内容干扰协议 该用户 shell 设为 /sbin/nologin
登录后目录为空 chroot 到的是家目录,内容在别处 确认目录结构和 ChrootDirectory 路径
能进目录但上传失败 目标子目录不归用户所有或无写权限 chown user 并给写权限
SELinux 开启时拒绝访问 上下文标签不对 chcon/semanage 打标签
连接超时 防火墙/安全组未放行端口 放行 SSH 端口

查看 sshd 日志定位认证问题:

# RHEL
tail -n 50 /var/log/secure
journalctl -u sshd -n 50 --no-pager
# Debian/Ubuntu
tail -n 50 /var/log/auth.log
journalctl -u ssh -n 50 --no-pager

七、安全加固清单

SFTP 用户面向外部,安全边界要守好:

  • 公钥优先:有条件的用户一律用公钥认证,Match 块里把 PasswordAuthentication no,杜绝暴力破解。
  • 禁止 shell 与转发:ForceCommand internal-sftp 加 AllowTcpForwarding no、X11Forwarding no,防止用户借 SFTP 账号做隧道或转发。
  • 最小目录权限:chroot 根只给读和执行,需要写的目录单独放开,别把整个家目录给写权限。
  • 不共享系统账号:SFTP 用户一律不给 shell、不加入特权组,绝不复用 root 或运维账号。
  • 限制来源 IP:能确定合作方出口 IP 的,用 Match Address 或安全组做来源限制。
  • 审计日志:SFTP 的操作可通过 sshd 日志追踪,生产环境建议保留足够时间的日志便于审计。
  • 定期清理:为临时合作方设置账号有效期,或用脚本定期清理长期不用的账号。

八、性能与容量参考

SFTP 的性能瓶颈通常不在协议本身,而在磁盘和网络。以下是经验值:

  • 千兆内网下单连接 SFTP 传输大文件,吞吐通常能到几百 MB/s,接近磁盘读速上限。
  • 高延迟公网链路下,单连接吞吐受窗口和延迟限制,此时多开几个并行连接或改用 rsync 增量能明显提升。
  • 单台 2 核 4GB 服务器承载几十个 SFTP 并发连接没有问题,瓶颈一般先出现在磁盘 IO 而非 CPU。
  • 小文件数量极多时,建连和元数据操作是主要开销,考虑打包成归档再传。
  • 上传目录要关注磁盘余量和 inode 使用,长期不清理的上传目录容易撑满磁盘。

常见问题

Q:配置后用户登录失败,日志写 bad ownership or modes for chroot directory。
这是 chroot 的经典错误。chroot 目录(以及从根到它的每一级上级目录)属主必须是 root,且不能被其他用户写入。执行 chown root:root 和 chmod 755 修好即可。别为了图省事把目录给用户所有,那正是 OpenSSH 要防的情况。

Q:用户登录后看到的是自己的家目录,看不到我放的共享文件。
chroot 改变了他眼里的"根"。如果 ChrootDirectory 指向 /srv/sftp/alice,那他在会话里 cd / 看到的就是这个目录。共享文件要放在这个 chroot 根之下,而不是系统里的其他路径。

Q:能登录能列目录,但上传文件报权限错误。
chroot 根目录不给写是设计如此,因为写入会破坏安全模型。要让用户上传,必须在 chroot 根下建一个单独的子目录(如 upload/),把该子目录属主改成用户。只改 chroot 根是不行的。

Q:想给用户同时开 FTP 和 SFTP,会不会冲突?
不冲突,FTP 是独立服务(vsftpd 等),SFTP 走 SSH,两者互不影响。但为了减少攻击面,建议尽量统一到 SFTP,FTP 只对确实不支持 SFTP 的老设备保留。

Q:改 SSH 端口后连不上了,怎么办?
这是最容易把自己锁在门外的操作。正确做法是:先在 sshd_config 里同时保留旧端口和新端口(两个 Port 行),放行新端口,验证新端口能连上,再删掉旧端口行并 reload。如果已经锁住,只能通过云控制台的 VNC/串口登录恢复配置。

总结

SFTP 服务由 OpenSSH 的 sshd 提供,用 internal-sftp 子系统配合 Match Group 的 ChrootDirectory 实现用户隔离,不需要额外软件。

chroot 的核心规则只有一条:chroot 根目录及各级上级目录必须属主 root 且不可被其他用户写入,用户可写的目录要在其下单独创建并改属主。

配置写在 sshd_config 末尾的 Match 块内,配合 ForceCommand internal-sftp 禁 shell、AllowTcpForwarding no 禁转发,做到既隔离又安全。

改 SSH 配置前先备份、保留一个已登录会话、用 sshd -t 验证后再 reload,这是防止把自己锁在门外的铁律;防火墙只需放行 SSH 一个端口。

排障先看 sshd 日志(/var/log/secure 或 /var/log/auth.log),bad ownership 是权限问题、message too long 是 shell 输出干扰、上传失败是子目录权限,对症下药即可。