前提條件
- OpenSSH Server 版本 ≥ 4.8p1 (支援
ChrootDirectory 指令)。
- 查詢版本:
ssh -V
設定步驟
- 建立專用群組:
groupadd sftpusers
- 建立使用者:
useradd -s /bin/false -G sftpusers sftpuser1
-s /bin/false 禁止 Shell 登入。
- 修改 sshd_config:
# 找到 Subsystem sftp 行,改為:
Subsystem sftp internal-sftp
# 檔案末尾新增:
Match Group sftpusers
ChrootDirectory %h
ForceCommand internal-sftp
AllowTcpForwarding no
X11Forwarding no
- 設定家目錄權限 (關鍵):
chown root:root /home/sftpuser1
chmod 755 /home/sftpuser1
# 家目錄必須屬於 root 且不可被群組/其他寫入,否則 SSH 會拒絕連線。
- 建立可寫入子目錄:
mkdir /home/sftpuser1/upload
chown sftpuser1:sftpusers /home/sftpuser1/upload
chmod 750 /home/sftpuser1/upload
- 重啟 SSH 服務:
systemctl restart sshd
測試驗證
ssh sftpuser1@localhost # 應被拒絕 (無 Shell)
sftp sftpuser1@localhost # 成功登入,無法 cd 到 /home/sftpuser1 以外
常見錯誤排除
- Write failed: Broken pipe / Connection reset by peer:家目錄權限不符 (非 root 擁有或權限過寬)。確認
chown root:root /home/user && chmod 755 /home/user。
- SELinux 環境需設定
setsebool -P ssh_chroot_rw_homedirs on 或調整標籤。