给外部合作方、客户或者不同部门提供文件上传下载能力时,最省事的方式是用 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 输出干扰、上传失败是子目录权限,对症下药即可。
企业QQ咨询




