Поиск
Справочник

SFTP с chroot: доступ к файлам без входа в консоль

Строки ChrootDirectory и ForceCommand internal-sftp запирают человека в одной папке: файлы через SFTP он загружает, а ни команды на сервере, ни других папок ему не видно.

≈ 5 мин чтения
Содержание 8

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться) и не закрывайте это окно до конца: если с настройками что-то пойдёт не так, через него всё можно вернуть.
  2. Создайте группу и пользователя без входа в консоль: sudo groupadd sftponly, затем sudo useradd -m -s /usr/sbin/nologin -G sftponly anna. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  3. Задайте ему пароль: sudo passwd anna.
  4. Создайте папки (команды ниже) — верхнюю отдайте root, а внутреннюю, куда можно писать, — anna.
  5. Создайте файл с блоком Match: sudo nano /etc/ssh/sshd_config.d/10-sftp.conf, впишите блок ниже и сохраните: Ctrl+O, Enter, Ctrl+X.
  6. Проверьте файл командой sudo sshd -t. Если она ничего не ответила, ошибок нет. Примените настройки: sudo systemctl reload ssh. Открытые подключения при этом не рвутся.
  7. Проверьте вход с другого компьютера: 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> ls

pwd покажет папку /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пишете в корень, а он принадлежит rootcd upload и загружайте туда
вход не идёт, а в журнале нет слова chrootблок Match не подхватился для annaid 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.

Источники

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше