Монтирование NFS-шары на клиенте сводится к двум действиям: поднять экспорт вручную командой mount -t nfs с явно заданными опциями и закрепить его в /etc/fstab, если шара должна переживать перезагрузку. Для продакшена к базовой команде добавляют защиту от зависаний (soft, timeo, retrans), а в fstab - опцию nofail.
Рабочий минимум для ручного подключения выглядит так:
sudo mount -t nfs -o vers=4.2,rsize=1048576,wsize=1048576 \ 192.0.2.10:/export/share /mnt/share
Для постоянного подключения те же параметры переносятся в строку fstab:
192.0.2.10:/export/share /mnt/share nfs vers=4.2,rsize=1048576,wsize=1048576,soft,timeo=600,retrans=2,nofail,_netdev 0 0
Дальше разбираем, откуда берутся значения vers, когда имеет смысл трогать rsize и wsize, что реально делают soft, timeo и retrans и почему без nofail недоступная шара способна отправить сервер в emergency mode.
Что мы настраиваем: клиент, сервер и точка монтирования
NFS-сервер экспортирует каталог из своей файловой системы, клиент подключает его в локальный каталог и работает с ним как с обычной папкой. Роли разделены: на сервере настраивают /etc/exports и запускают nfsd, на клиенте нужен клиентский пакет и точка монтирования.
# Debian / Ubuntu sudo apt install nfs-common # RHEL / CentOS / Rocky / AlmaLinux sudo dnf install nfs-utils
Точку монтирования создайте заранее и оставьте пустой:
sudo mkdir -p /mnt/share
Если в каталоге уже лежат файлы, после монтирования вы их не увидите: содержимое точки монтирования перекрывается экспортом, а после umount оно вернётся на место.
Проверьте связь до сервера до первой попытки mount. Набор портов зависит от версии протокола: в документации для NFSv4 указаны порты 2049 (nfs) и 111 (portmapper), а для NFSv3 - TCP 2049, TCP 20048 и TCP 111. Точную конфигурацию firewall сверяйте с документацией вашего дистрибутива и сервера:
ping -c 3 192.0.2.10 rpcinfo -p 192.0.2.10
Дальше во всех примерах используем условные 192.0.2.10:/export/share и /mnt/share. Сторона сервера, права на каталог и параметры /etc/exports разобраны в руководстве по настройке NFS в Ubuntu.
Ручное монтирование: команда mount -t nfs с опциями vers, rsize и wsize
Флаг -t nfs задаёт тип файловой системы, ключ -o принимает список опций через запятую без пробелов. Порядок опций значения не имеет, важно не ставить пробелы внутри списка.
sudo mount -t nfs -o vers=4.2,rsize=1048576,wsize=1048576 192.0.2.10:/export/share /mnt/share
Вариант без -t тоже работает: mount определяет тип по префиксу server:/path и вызывает mount.nfs. Версию протокола всё равно указывайте явно, иначе клиент и сервер договариваются о ней сами, и результат не всегда ожидаемый.
Синтаксис пути зависит от версии. В NFSv4 экспорт указывают как server:/export/share, где путь соответствует псевдокорню сервера. В NFSv3 указывают полный путь на диске, например 192.0.2.10:/srv/nfs/share. Перепутанный формат даёт ошибку вида mount.nfs: No such file or directory даже при живом сервере.
Как выбрать версию протокола vers
Версию диктует сервер, клиент должен её поддерживать. В зависимости от конфигурации ядра клиент NFS в Linux может поддерживать версии 3, 4.0, 4.1 или 4.2. Включённые на сервере версии видны в служебном файле ядра:
cat /proc/fs/nfsd/versions nfsstat -s
На клиенте фактическую версию уже смонтированных шар показывает nfsstat -m. Если опция vers не указана, клиент сначала пробует версию 4.2, а затем понижает её до поддерживаемой сервером. Явное vers=4.2 избавляет от неожиданностей согласования и подходит для современных серверов; для legacy-хранилищ и старых ядер остаётся vers=3, где нужен portmapper.
Неверная версия - одна из самых частых причин сбоя. Проявляется по-разному: mount.nfs: Protocol not supported, wrong fs type, bad option, либо молчаливое зависание на этапе согласования. Проверка занимает минуту: сверьте список версий на сервере и повторите mount с явным vers.
Когда трогать rsize и wsize
rsize и wsize задают максимальный размер блока чтения и записи в байтах. Крупные блоки снижают накладные расходы на быстрых каналах, мелкие реже страдают от фрагментации и повторов на узких или нестабильных линках.
- 1048576 (1 МиБ) - разумная стартовая точка для сетей 1/10GbE: такое значение увеличивает пропускную способность.
- Для сетей 10GbE и 100GbE имеет смысл поднимать wsize/rsize до 1-4 МБ, проверяя поддержку со стороны сетевого оборудования (например, MTU 9000).
- Значение по умолчанию зависит от ядра и версии протокола, фактические параметры смонтированной шары показывает nfsstat -m.
Меняйте размеры блоков по результатам замеров, а не наугад. Готовые наборы опций под разные нагрузки (видео, логи, базы данных) собраны в материале про настройку NFS для скорости и стабильности.
Почему монтирование зависает и как это предотвратить: soft, timeo, retrans
По умолчанию NFS монтируется в режиме hard: при недоступном сервере операции ввода-вывода повторяются бесконечно. Процессы, которые обратились к шаре, уходят в состояние D (uninterruptible sleep) и не снимаются даже kill -9. Команда df -h в такой ситуации тоже не отвечает, а umount заканчивается сообщением target is busy.
Поведение меняют три опции:
- soft: вместо бесконечного ожидания ядро возвращает приложению ошибку ввода-вывода (EIO).
- timeo: таймаут ожидания ответа в десятых долях секунды, timeo=600 означает 60 секунд.
- retrans: число повторных передач запроса. При отсутствии ответа в течение timeo время ожидания удваивается и запрос передаётся повторно, пока число повторных передач не достигнет значения retrans; после этого soft отдаёт ошибку.
Из-за удвоения таймаута между попытками суммарное ожидание не сводится к простому произведению timeo на retrans - его стоит оценивать по фактическому поведению в вашей сети. Рабочая комбинация для вспомогательных и read-only томов:
sudo mount -t nfs -o vers=4.2,soft,timeo=600,retrans=2 \ 192.0.2.10:/export/share /mnt/share
Риск soft называем прямо: при записи ошибка ввода-вывода способна привести к неполным данным и сбою приложения. Для томов, куда пишут базы и бэкапы, оценивайте компромисс отдельно; для read-only и второстепенных шар soft удобнее, чем hard с зависшими процессами. Числа timeo и retrans сверяйте с man 5 nfs вашего дистрибутива: семантика едина, а разумные значения зависят от задержек в сети.
Автомонтирование NFS при загрузке через /etc/fstab
Строка для постоянного подключения повторяет опции ручного mount и добавляет то, что относится к загрузке:
192.0.2.10:/export/share /mnt/share nfs vers=4.2,rsize=1048576,wsize=1048576,soft,timeo=600,retrans=2,nofail,_netdev 0 0
Поля по порядку: что монтируем, куда, тип ФС, опции через запятую, dump и pass. Для NFS последние два поля выставляют в 0 0: сетевую ФС не проверяет fsck.
nofail разрешает загрузке продолжиться, если шара недоступна. Без него неудачное обязательное монтирование из fstab может остановить загрузку и перевести систему в emergency mode или rescue mode. _netdev сообщает systemd, что ФС сетевая, поэтому монтирование ставится после поднятия сети.
В systemd-окружениях добавляют ещё пару ключей: x-systemd.automount монтирует шару по первому обращению, x-systemd.device-timeout=10 ограничивает ожидание устройства.
192.0.2.10:/export/share /mnt/share nfs vers=4.2,soft,timeo=600,retrans=2,nofail,_netdev,x-systemd.automount,x-systemd.device-timeout=10 0 0
Если шар много и часть из них нужна эпизодически, статический fstab уступает autofs: ресурс подключается только при обращении к каталогу. Настройка карт разобрана в статье про автоматическое монтирование NFS через autofs.
Проверка fstab без перезагрузки
Прод перезагружать не нужно: mount -a читает fstab и монтирует всё, что ещё не смонтировано.
sudo mount -a findmnt /mnt/share mount | grep nfs
Ошибка в выводе mount -a означает, что строка неверна и при ребуте поведёт себя так же. Откат простой: sudo umount /mnt/share и правка строки. Забытый nofail в такой проверке не проявится, поэтому опцию контролируйте глазами.
Типичные сбои: недоступный сервер и неверная версия протокола
Зависание при недоступном сервере. Симптомы: df -h не отвечает, процессы в состоянии D, umount возвращает target is busy. Причина в hard-режиме без таймаутов: ядро бесконечно повторяет запросы к упавшему серверу. Лечение: soft, timeo и retrans в опциях монтирования плюс nofail в fstab, чтобы загрузка не зависела от доступности шары.
Неверная версия протокола. Симптомы: mount.nfs: Protocol not supported, wrong fs type, bad option, либо отказ сервера на этапе согласования. Диагностика: showmount -e 192.0.2.10 покажет список экспортов, rpcinfo -p подтвердит регистрацию служб для NFSv3, cat /proc/fs/nfsd/versions на сервере покажет включённые версии. Дальше vers на клиенте приводится к поддерживаемой.
| Симптом | Причина | Исправление |
|---|---|---|
| df -h висит, процессы в D | hard без таймаутов, сервер недоступен | добавить soft,timeo=600,retrans=2 и nofail |
| mount.nfs: Protocol not supported | vers не поддерживается сервером или клиентом | сверить /proc/fs/nfsd/versions, указать vers=4.2 или vers=3 |
| mount.nfs: Connection timed out | закрыты нужные порты: 2049 и 111 для NFSv4, дополнительно 20048 для NFSv3 | открыть порты, проверить rpcinfo -p |
| mount.nfs: access denied by server | клиента нет в /etc/exports, ограничение по IP, root_squash | дописать клиента в exports и выполнить exportfs -ra |
| Загрузка падает в emergency mode | нет nofail | добавить nofail и _netdev |
Алгоритмы разбора зависаний, низкой скорости и ошибок ввода-вывода с nfsstat, nfsiostat и журналами ядра собраны в статье про диагностику NFS.
Проверка результата: mount, df -h и showmount
Три команды закрывают базовую проверку:
- mount | grep nfs: активные NFS-монтирования и применённые опции, здесь видно, подхватились ли vers, soft и timeo.
- df -h: точка монтирования и занятое место, подтверждает, что ФС видна ядру и отвечает на запросы.
- showmount -e 192.0.2.10: список экспортов сервера, помогает сверить, что вы монтируете нужный путь.
Фактические параметры конкретной шары (версия, rsize, wsize, таймауты) показывает nfsstat -m. Проверка записи занимает секунды и ловит ошибки прав, которые mount не считает ошибкой:
findmnt -t nfs,nfs4 /mnt/share nfsstat -m touch /mnt/share/.write_test && rm /mnt/share/.write_test
Если touch падает с Permission denied, дело в правах: uid и gid клиента не совпадают с владельцем каталога, либо на сервере включён root_squash и root клиента отображается в nobody. Разбор POSIX-прав, ACL и типовых ошибок доступа есть в материале про доступ к файловой системе и права.
Чек-лист перед вводом в эксплуатацию
- vers согласована с сервером: /proc/fs/nfsd/versions на сервере, nfsstat -m на клиенте.
- rsize и wsize заданы осознанно или оставлены по умолчанию, решение подкреплено замером скорости.
- soft, timeo и retrans выставлены для вспомогательных томов, риск EIO на записи оценён для каждого тома отдельно.
- nofail и _netdev присутствуют в строке /etc/fstab.
- mount -a проходит без ошибок, findmnt /mnt/share возвращает строку монтирования.
- mount | grep nfs, df -h и showmount -e подтверждают монтирование и правильный экспорт.
- Запись и чтение проверены: touch, запись файла, удаление.
- Сценарий с недоступным сервером протестирован: заблокируйте TCP/2049 на клиенте и убедитесь, что df -h не висит, а система загружается без ручного вмешательства.
Приведённые команды используют стандартный синтаксис mount.nfs, который одинаково работает в Debian/Ubuntu и RHEL-семействе, но значения по умолчанию и набор опций отличаются между ядрами. Сверьте timeo, retrans и размеры блоков с man 5 nfs и man 5 exports вашего дистрибутива и прогоните чек-лист на стенде до продакшена.