NFS-сервер: типичные ошибки и как их исправить

Коротко о главном

NFS позволяет делиться каталогами между Linux-машинами так, будто они локальные. Это удобно для домашней сети, сборок, медиатеки и резервных копий. Протокол зрелый, но требует внимания к правам и сети: неверная запись в /etc/exports может открыть данные большему кругу устройств, чем вы планировали.

NFS проще Samba, если все клиенты на Linux, и не требует эмуляции Windows-протоколов. Он хорошо работает с большими файлами и поддерживается на уровне ядра, поэтому не создаёт лишней нагрузки.

NFS-сервер редко ломается сам по себе. Чаще проблема в неверной конфигурации, устаревшей версии или команде, скопированной без понимания. Разберём типичные сбои и способы их исправления.

Почему это происходит

Ошибки почти всегда связаны с контекстом: другая версия пакета, не тот пользователь, устаревший конфиг или команда из руководства для другой системы. NFS-сервер не исключение. Поэтому сначала фиксируем исходное состояние, затем меняем одну вещь за раз.

Типичные ошибки

Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.

1. mount зависает

Проверьте сеть и порт 2049, затем showmount на сервере. Часто виноват файрвол или неверный адрес. Используйте опцию -v для диагностики.

2. Permission denied при записи

Сверьте UID и права каталога на сервере. Учтите root_squash: root клиента становится анонимным пользователем и не сможет писать в каталог, принадлежащий root сервера.

3. Stale file handle

Экспорт изменился или сервер перезапускался. Размонтируйте каталог, проверьте exportfs -v и смонтируйте заново. Не удаляйте файлы на сервере во время работы клиента.

Как настроить правильно

Правильная последовательность проста: проверить версию и зависимости, сделать резервную копию конфигурации, внести минимальное изменение, проверить логи и только потом двигаться дальше.

Установка

В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:

sudo apt install nfs-kernel-server

В Fedora и RHEL-совместимых системах пакет ставится через DNF:

sudo dnf install nfs-utils

В Arch Linux и производных пакет доступен в официальных репозиториях:

sudo pacman -S nfs-utils

1. Создайте каталог и права

Выделите отдельный каталог, а не корень диска. Права должны соответствовать пользователям, которые будут работать с файлами: NFS передаёт UID и GID, а не имена.

sudo mkdir -p /srv/share
sudo chown -R user:user /srv/share
ls -ldn /srv/share

2. Опишите экспорт

Ограничьте доступ конкретной подсетью. Флаг sync безопаснее async: клиент получает подтверждение только после записи на диск.

echo '/srv/share 192.168.1.0/24(rw,sync,no_subtree_check)' | sudo tee -a /etc/exports
sudo exportfs -rav

3. Запустите службу

В Debian служба называется nfs-kernel-server, в других системах — nfs-server. Проверьте, что экспорт виден.

sudo systemctl enable --now nfs-server
sudo exportfs -v
showmount -e localhost

4. Откройте порты

Для NFSv4 достаточно TCP 2049. Для старых версий нужны дополнительные порты rpcbind и statd — по возможности используйте только четвёртую версию.

sudo ufw allow from 192.168.1.0/24 to any port 2049 proto tcp
sudo ufw status

Рабочий конфиг

Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.

# /etc/exports
/srv/share 192.168.1.0/24(rw,sync,no_subtree_check)

Практические советы

Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.

Совет 1. Не экспортируйте каталог всей сети, если достаточно одной подсети или

Не экспортируйте каталог всей сети, если достаточно одной подсети или адреса.

Совет 2. Используйте NFSv4: он проще с портами и поддерживает ACL.

Используйте NFSv4: он проще с портами и поддерживает ACL.

Совет 3. Проверяйте UID на клиенте и сервере: имена пользователей NFS не переда

Проверяйте UID на клиенте и сервере: имена пользователей NFS не передаёт.

Совет 4. Флаг root_squash по умолчанию защищает от записи root клиента на серве

Флаг root_squash по умолчанию защищает от записи root клиента на сервер.

Профилактика

Большинство повторяющихся сбоев с NFS-сервер связано не с ошибкой в самой программе, а с окружением: обновились зависимости, изменился путь, закончилось место или другой администратор поправил конфиг. Поэтому профилактика начинается с фиксации исходного состояния.

Сохраните рабочий конфиг в систему контроля версий, добавьте короткий комментарий о том, зачем нужен каждый нестандартный параметр, и запишите команду проверки. Через месяц вы скажете себе спасибо: восстановить логику по чужому файлу без пояснений почти невозможно.

Итог

Большинство ошибок с NFS-сервер лечится не переустановкой, а проверкой конфигурации, логов и прав доступа. Действуйте по одному изменению за раз — и причина быстро найдётся.