SFTP с chroot: доступ к файлам без входа в консоль
Строки ChrootDirectory и ForceCommand internal-sftp запирают человека в одной папке: файлы через SFTP он загружает, а ни команды на сервере, ни других папок ему не видно.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться) и не закрывайте это окно до конца: если с настройками что-то пойдёт не так, через него всё можно вернуть.
- Создайте группу и пользователя без входа в консоль:
sudo groupadd sftponly, затемsudo useradd -m -s /usr/sbin/nologin -G sftponly anna. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Задайте ему пароль:
sudo passwd anna. - Создайте папки (команды ниже) — верхнюю отдайте root, а внутреннюю, куда можно писать, — anna.
- Создайте файл с блоком Match:
sudo nano /etc/ssh/sshd_config.d/10-sftp.conf, впишите блок ниже и сохраните: Ctrl+O, Enter, Ctrl+X. - Проверьте файл командой
sudo sshd -t. Если она ничего не ответила, ошибок нет. Примените настройки:sudo systemctl reload ssh. Открытые подключения при этом не рвутся. - Проверьте вход с другого компьютера:
sftp anna@203.0.113.10.
Папки:
sudo mkdir -p /srv/sftp/anna/upload
sudo chown root:root /srv/sftp /srv/sftp/anna
sudo chmod 755 /srv/sftp /srv/sftp/anna
sudo chown anna:anna /srv/sftp/anna/uploadБлок для файла 10-sftp.conf:
Match Group sftponly
ChrootDirectory /srv/sftp/%u
ForceCommand internal-sftp -d /upload
AllowTcpForwarding no
X11Forwarding noЧто значат строки
| Строка | Что делает |
|---|---|
Match Group sftponly | следующие строки действуют только для группы sftponly |
ChrootDirectory /srv/sftp/%u | после входа эта папка становится для человека корнем /; %u заменяется на имя |
ForceCommand internal-sftp -d /upload | вместо консоли — только SFTP, начинать в папке /upload |
AllowTcpForwarding no, X11Forwarding no | запрет переадресации |
internal-sftp работает внутри самого sshd, поэтому внутри папки ничего класть не нужно и оболочка /usr/sbin/nologin ему не мешает. Файл в sshd_config.d удобен тем, что блок Match кончается вместе с ним (папка sshd_config.d).
Почему папки такие
- Каждая папка на пути к chroot — /srv, /srv/sftp и /srv/sftp/anna — должна принадлежать root, и писать в неё может только root. Иначе sshd откажет во входе.
- Поэтому в саму /srv/sftp/anna человек писать не может. Для файлов нужна папка внутри — upload, её владелец anna.
- После входа anna видит только
/upload— это /srv/sftp/anna/upload на сервере.
Вход по паролю и по ключу
Если вход по паролю закрыт (вход только по ключу), есть два пути. Первый — положить ключ anna в /home/anna/.ssh/authorized_keys (как это сделать): sshd читает его до того, как запереть человека в папке. Второй — разрешить пароль только этой группе, добавив в блок Match строку PasswordAuthentication yes.
Как проверить
С другого компьютера войдите и загрузите файл:
sftp anna@203.0.113.10
sftp> pwd
sftp> put report.pdf
sftp> lspwd покажет папку /upload, а файл появится на сервере в /srv/sftp/anna/upload. Попытка войти в консоль — ssh anna@203.0.113.10 — закончится строкой This service allows sftp connections only.
В программах вроде FileZilla выберите протокол SFTP, порт SSH и те же имя и пароль.
Ошибки и как их исправить
Если подключение сразу рвётся, посмотрите журнал: sudo grep -i chroot /var/log/auth.log | tail -n 5.
| Что видите | Причина | Что делать |
|---|---|---|
в журнале bad ownership or modes for chroot directory "/srv/sftp/anna" | у папки не тот владелец или права | sudo chown root:root /srv/sftp/anna и sudo chmod 755 /srv/sftp/anna |
| то же со словом component и путём выше | не тот владелец у /srv или /srv/sftp | те же две команды для этой папки |
файл не загружается, Permission denied | пишете в корень, а он принадлежит root | cd upload и загружайте туда |
| вход не идёт, а в журнале нет слова chroot | блок Match не подхватился для anna | id anna и проверка командой под таблицей |
Permission denied при входе | пароль закрыт или неверен | см. раздел о входе выше |
Подхватился ли блок для anna, покажет команда — она печатает настройки так, как sshd применит их к этому пользователю:
sudo sshd -T -C user=anna | grep -E 'chrootdirectory|forcecommand'Должны появиться строки chrootdirectory /srv/sftp/%u и forcecommand internal-sftp -d /upload — %u sshd заменит на имя уже при входе. Если вместо них chrootdirectory none, проверьте группу (id anna) и файл 10-sftp.conf.
Источники
- man sshd_config — на английском: ChrootDirectory, ForceCommand, internal-sftp и Match.
- man sftp-server — на английском: ключ -d: папка, в которой человек оказывается после входа.
- Исходный код OpenSSH 9.6: session.c — проверка прав на папку chroot, internal-sftp внутри sshd и запись This service allows sftp connections only.
- Файл sshd_config из пакета openssh в Ubuntu 24.04 — строка Include в начале, KbdInteractiveAuthentication no, UsePAM yes и закомментированные значения по умолчанию.
Сверено 23 октября 2026 года.
Что почитать дальше
- Как добавить пользователяuseradd, adduser и пароль.
- Папка sshd_config.dгде держать свои настройки.
- AllowUsers и AllowGroupsкому вход открыт вообще.
- Настройки SSHкак устроен sshd_config.