Настройка NFS-сервера в Linux с нуля: /etc/exports, флаги и проверка | AdminWiki

Настройка NFS-сервера в Linux с нуля: /etc/exports, флаги и проверка

12 ноября 2026 12 мин. чтения

Что мы получим в итоге и кому подходит это руководство

NFS-сервер в Debian и Ubuntu поднимается за пять шагов: поставить пакет nfs-kernel-server, создать каталог для экспорта, описать его в /etc/exports, применить конфигурацию командой exportfs -ra и проверить службу через systemctl status. Дальше вся статья - расшифровка этих шагов с объяснением, почему в строке экспорта стоят именно такие флаги и что ломается, если поставить другие.

К концу у вас будет каталог /srv/nfs/shared, который монтируется на клиенте по сети, доступен на запись обычному пользователю и закрыт от root-записи с клиента благодаря root_squash. Плюс чек-лист безопасности, который стоит прогнать до того, как экспорт увидит продовый трафик.

Примеры команд в статье приведены для Debian 12 и Ubuntu 22.04/24.04. В RHEL, Rocky Linux и AlmaLinux тот же стек ставится пакетом nfs-utils, служба называется nfs-server, а файл конфигурации совпадает: /etc/exports. Синтаксис опций один и тот же, поэтому руководство переносится на RHEL-семейство без переписывания конфига.

Сценарии, под которые подходит материал:

  • общий каталог приложений на двух-трёх серверах приложения (загрузки, шаблоны, статика);
  • каталог бэкапов, куда несколько машин пишут дампы;
  • домашние каталоги пользователей в небольшом кластере;
  • шаринг артефактов сборки для CI-раннеров, чтобы не гонять десятки гигабайт по сети каждый раз.

Если нужен более широкий контекст - NFS рядом с SMB и iSCSI в одном сервере хранения, разбираем это в статье про сборку СХД на базе Linux.

Установка nfs-kernel-server и подготовка каталога для экспорта

Ставим серверный пакет. В Debian и Ubuntu это nfs-kernel-server, он тянет за собой nfs-common и rpcbind:

apt update && apt install -y nfs-kernel-server

Для RHEL-семейства команда другая: dnf install -y nfs-utils, затем systemctl enable --now nfs-server.

Создаём каталог и назначаем владельца:

mkdir -p /srv/nfs/shared
chown -R nobody:nogroup /srv/nfs/shared
chmod 755 /srv/nfs/shared

В RHEL-семействе группа называется nobody, то есть chown -R nobody:nobody. Проверить фактическое имя группы можно через getent group nobody nogroup.

Связь с root_squash здесь прямая. Клиент под root обращается к серверу, сервер подменяет UID 0 на nobody, и запись выполняется от имени nobody:nogroup. Если каталог принадлежит root и закрыт на 755, такие запросы получат отказ. Владелец nobody:nogroup снимает этот класс ошибок заранее.

Если писать будут обычные пользователи, а не root, ориентируйтесь на их UID: владельцем должен быть тот же числовой UID, что и на клиенте. Владелец nobody нужен прежде всего для сценариев с root_squash.

Не делайте chmod 777 «чтобы заработало». Седьмые права маскируют несовпадение UID и оставляют каталог открытым для любого процесса на любом клиенте из списка экспорта. Правильный путь - согласовать владельца или группу, а режим выставить 755 для общих данных и 770 с выделенной группой, когда доступ должен быть ограничен.

Проверяем, что служба встала и запустилась:

systemctl status nfs-kernel-server

В ответе нужна строка active (exited) или active (running) без красных ошибок в последних строках вывода. Точное состояние зависит от версии дистрибутива и от того, есть ли уже хотя бы один экспорт: до появления записей в /etc/exports служба может оставаться в состоянии exited, а не running. Базовый гайд по пакетам и клиентской части есть в материале про настройку NFS в Ubuntu.

Проверенные первоисточники по установке и зависимостям пакета: руководство по установке NFS на Debian/Ubuntu и настройка NFS-сервера на Debian 12.

Структура /etc/exports: как читается строка экспорта

Формат строки простой: экспортируемый каталог, затем клиент, затем опции в круглых скобках. Одна строка может содержать нескольких клиентов с разными правами.

/srv/nfs/shared 192.168.1.0/24(rw,sync,no_subtree_check)

Разбираем элементы:

  • Путь - абсолютный, без завершающего слэша. /srv/nfs/shared читается корректно, /srv/nfs/shared/ уже нет.
  • Клиент - IP-адрес (192.168.1.10), подсеть в CIDR (192.168.1.0/24), hostname или маска с wildcard (*.example.com).
  • Опции - в круглых скобках сразу после клиента, без пробела. Пробел между адресом и скобкой ломает разбор строки: сервер воспримет скобки как часть имени клиента.

Разные права для разных клиентов задаются в одной строке:

/srv/nfs/shared 192.168.1.10(rw,sync,no_subtree_check) 192.168.1.0/24(ro,sync,no_subtree_check)

Читает это так: машина 192.168.1.10 пишет, вся остальная подсеть только читает. Комментарии начинаются с # и занимают всю строку целиком.

Минимальный конфиг для копирования, которого достаточно для рабочего шаринга внутри доверенной подсети:

/srv/nfs/shared 192.168.1.0/24(rw,sync,no_subtree_check,root_squash)

Порядок опций в скобках значения не имеет, важны сами флаги и отсутствие пробелов внутри скобок. Полное описание формата и допустимых опций - в man-странице exports(5).

Разбор флагов exports: rw, sync, no_subtree_check и root_squash

Ниже сводная таблица по флагам, которые встречаются в большинстве конфигов. Колонка «риск» описывает, что происходит при неверном или неосознанном значении.

ФлагЧто делаетЗачем нуженРиск неверного значения
rwРазрешает запись в экспортОбщие данные приложений, бэкапы, домашние каталогиЛишние права на запись там, где хватило бы ro: испорченные артефакты и данные
roТолько чтениеРаздача артефактов, справочников, образовНе влияет на безопасность негативно, но приложение получит отказ при попытке записи
syncПодтверждает запись после сброса на дискДанные, потеря которых недопустимаБез него (async) подтверждение уходит раньше записи
asyncПодтверждает запись до сброса на дискВременные и кэшевые каталогиПотеря данных и риск повреждения ФС при падении сервера или сети
no_subtree_checkОтключает проверку пути внутри экспортируемого поддереваЭкспорт целых каталогов, стабильная работа при переименованияхС subtree_check: ложные отказы после переименований и лишняя нагрузка
root_squashМаппит UID 0 клиента в nobodyБазовый уровень защиты от root с клиентаОтсутствие флага даёт клиентскому root полные права в экспорте
no_root_squashОставляет UID 0 как естьУзкие сценарии в изолированной доверенной сетиКомпрометация клиента равна root на сервере в границах экспорта
all_squashМаппит всех клиентов в nobodyАнонимный шаринг только на чтениеВсе файлы принадлежат nobody, разграничить пользователей не получится

Почему sync, а не async: цена производительности против риска потери данных

Разница в моменте подтверждения. С async сервер отвечает клиенту «записано» до того, как данные физически ушли на диск. Падение сервера, отключение питания или разрыв сети в этот промежуток означают потерю подтверждённых записей, а файловая система может остаться в несогласованном состоянии.

С sync подтверждение означает сброс на диск. Медленнее на операциях записи, зато клиент не получает ложное «ok». Для баз данных, конфигов и общих данных приложений выбирайте только sync.

async оправдан на каталогах, которые целиком восстановимы: кэш сборки, временные выгрузки, каталог с артефактами, которые всегда можно пересобрать. Накладные расходы sync на типовом шаринге документов или логов не критичны, поэтому в проде по умолчанию держите sync. Тонкости буферов и параметров монтирования разобраны в статье про скорость и стабильность NFS.

root_squash и no_root_squash: что реально происходит с UID 0

Механика по шагам. Клиент под root создаёт файл в смонтированном каталоге. При root_squash сервер видит UID 0 и подменяет его на nobody, файл на диске сервера принадлежит nobody:nogroup, а на клиенте он отображается как принадлежащий nobody. Это ожидаемое поведение, а не баг.

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

Практическое правило: root_squash держим всегда и указываем его явно в строке экспорта - так конфиг сам документирует намерение, и поведение не зависит от значений по умолчанию конкретного дистрибутива. no_root_squash включайте только для изолированной доверенной сети и с комментарием в /etc/exports, зачем он там. Итоговый безопасный набор для общего каталога с записью: rw,sync,no_subtree_check,root_squash.

Права, владельцы и согласование UID/GID между сервером и клиентом

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

Проверка на обеих машинах:

id username
ls -ln /srv/nfs/shared

Ключ -n в ls показывает числа вместо имён. Если числа на клиенте и сервере расходятся, вы увидите именно это, без догадок.

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

  • выделить сервисного пользователя с фиксированным UID (например, 1500) и завести его одинаково на всех узлах через Ansible или centralised directory;
  • для нескольких приложений держать отдельные каталоги, каждый со своим владельцем, а не общий каталог на всех;
  • для групповой записи использовать общую группу с фиксированным GID и режим 2770, чтобы новые файлы наследовали группу.

В NFSv4 к этому добавляется idmapd: имена передаются строками вида user@domain, и расхождение домена на клиенте и сервере приводит к тому, что сопоставление пользователей и групп завершается ошибкой, а несовпавшие пользователи и группы подменяются значениями из конфигурации (по умолчанию nobody). Проверить домен можно в /etc/idmapd.conf на обеих сторонах, ключ Domain в секции [General]. Там же в секции [Mapping] задаются Nobody-User = nobody и Nobody-Group = nogroup. После правки файла очистите кэш сопоставления командой nfsidmap -c и перемонтируйте экспорт на клиенте. Подробнее о домене идентификатора NFSv4 и параметрах idmapd - в документации по настройке домена идентификатора NFSv4.1.

Безопасность экспортов: ограничиваем клиентов и закрываем сеть

Экспорт вида /srv/nfs/shared *(rw,sync) открывает каталог любому хосту, который дотянется до 2049/tcp. В проде такой строки быть не должно.

Правила, которые закрывают основной класс инцидентов:

  • перечисляйте конкретные IP и подсети, отказывайтесь от * и широких диапазонов;
  • не экспортируйте /, /etc, /var и домашние каталоги целиком: отдельный каталог под каждую задачу;
  • root_squash везде, ro там, где запись не нужна;
  • используйте NFSv4: для него достаточно 2049/tcp, тогда как NFSv3 использует несколько портов и требует portmapper (rpcbind) на 111/tcp и 111/udp, а также дополнительную службу mountd, у которой нет общеизвестного номера порта;
  • проверяйте, что экспорт не виден снаружи доверенного периметра.

Правило для ufw на сервере, если используется NFSv4 и подсеть 192.168.1.0/24:

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

Для nftables логика та же: разрешение по адресу источника и порту 2049, блокировка остального. Если остаётесь на NFSv3, дополнительно открывайте 111/tcp и 111/udp и фиксируйте порты служб через /etc/nfs.conf: по умолчанию rpcbind назначает порты NFS динамически, и без статических значений каждый рестарт меняет порты, а правила firewall перестают совпадать с реальностью. Общие принципы защиты сетевых служб и портов NFS описаны в руководстве Red Hat по защите сетевых служб.

Проверка с чужой машины: showmount -e 192.168.1.10. Если команда показывает экспорт, который не должен быть виден этому хосту, конфиг нужно править. Сами правила доступа по клиентам и ACL в смешанной среде разобраны в материале про разграничение прав на NFS и SMB шарах.

Чек-лист перед продом:

  1. в /etc/exports нет символа * и широких подсетей;
  2. экспортируются только выделенные каталоги, не корень ФС;
  3. root_squash указан явно во всех строках;
  4. каталоги, где запись не нужна, помечены ro;
  5. firewall разрешает 2049/tcp только доверенной подсети;
  6. showmount -e с внешнего хоста не показывает лишнего;
  7. владельцы каталогов совпадают по UID с клиентскими пользователями.

Применение конфигурации и проверка статуса сервера

После правки /etc/exports перезапускать службу не обязательно. Достаточно перечитать конфиг:

exportfs -ra

Ключ -r перечитывает /etc/exports и синхронизирует таблицу экспортов, -a применяет действие ко всем записям. Активные монтирования при этом не рвутся, но новые запросы обрабатываются уже с новыми опциями.

Главный способ убедиться, что флаги применились:

exportfs -v

Вывод показывает каждый экспорт, клиента и действующие опции. Если в списке нет нужного каталога, конфиг не прочитан: ищите синтаксическую ошибку и смотрите journalctl -u nfs-kernel-server -n 50.

Перезапуск и автозапуск:

systemctl restart nfs-kernel-server
systemctl enable nfs-kernel-server

Проверка на сервере: showmount -e localhost. Важная деталь: showmount работает, напрямую обращаясь к MNT-службе сервера, а серверы только с NFSv4 могут эту службу не предоставлять. Поэтому на таком сервере команда может показать пустой список при рабочем экспорте - пустой результат не всегда означает, что экспортов нет. В этой конфигурации ориентируйтесь на exportfs -v и на реальное монтирование с клиента. Поведение утилиты описано в man-странице showmount(8).

Проверка с клиента:

mount -t nfs4 192.168.1.10:/srv/nfs/shared /mnt/share
touch /mnt/share/test.txt
ls -ln /mnt/share

Для постоянного монтирования добавьте строку в /etc/fstab с опцией _netdev, чтобы монтирование не блокировало загрузку до поднятия сети:

192.168.1.10:/srv/nfs/shared /mnt/share nfs4 _netdev,defaults 0 0

Примеры опций монтирования и разбор типовых параметров приведены в руководстве по монтированию NFS-шары в Linux.

Типовые ошибки и быстрая диагностика

Порядок проверки от сети к правам экономит время: большинство проблем локализуется за 4 команды.

  1. showmount -e 192.168.1.10 с клиента: виден ли экспорт вообще.
  2. nc -zv 192.168.1.10 2049: доступен ли порт, не режет ли firewall.
  3. exportfs -v на сервере: применились ли опции.
  4. ls -ln на каталоге и id username на обеих машинах: совпадают ли UID и режим.
  5. journalctl -u nfs-kernel-server и dmesg -T | tail -50 на сервере: текст ошибки.
  6. На клиенте монтировать с mount -v, чтобы видеть подробный вывод.
СимптомВероятная причинаЧто проверить и исправить
access denied by serverКлиента нет в списке экспортаshowmount -e и строка в /etc/exports, затем exportfs -ra
permission denied при записиro вместо rw, несовпадение UID или режим каталогаexportfs -v, ls -ln, id username, при необходимости chown и chmod
stale file handleКаталог переименован или удалён, экспорт изменёнРазмонтировать на клиенте, exportfs -ra, смонтировать заново
Монтирование зависаетFirewall, rpcbind недоступен, неверный путьnc на 2049, проверить 111 при NFSv3, уточнить путь экспорта
Файлы принадлежат nobodyОжидаемое поведение root_squash или расхождение домена idmapdСверить UID и домен в /etc/idmapd.conf, при необходимости nfsidmap -c

Если проблема не в конфиге, а в поведении под нагрузкой (лаг при записи, обрывы, рост latency), смотрите статистику RPC и метрики монтирования. Пошаговые алгоритмы собраны в статье про диагностику NFS через nfsstat, nfsiostat и mountstats.

Когда NFS - правильный выбор, а когда нет

NFS уместен в доверенной сети между Linux-хостами: общие данные приложений, бэкапы, домашние каталоги в кластере, шаринг артефактов для CI. Здесь он даёт прозрачный доступ к файлам как к локальным, без промежуточного слоя и без установки клиента под каждую ОС сверх nfs-common.

NFS не стоит брать для доступа с Windows и macOS без дополнительной настройки: там родной протокол SMB/CIFS, а NFS-клиент на этих платформах потребует отдельной возни с маппингом и Kerberos. Не подходит он и для шаринга через интернет: для этого есть VPN или SSHFS. Сценарии с интенсивными блокировками файлов под высокой нагрузкой лучше тестировать отдельно, а иногда выгоднее объектное хранилище.

КритерийNFSSMB/CIFSSSHFS
ПлатформыLinux и Unix, NFS-клиенты для Windows и macOS отдельноWindows, macOS, LinuxЛюбая с SSH-клиентом
ПроизводительностьВысокая в локальной сетиСредняя и высокая, зависит от версии протоколаНизкая, оверхед шифрования и одного TCP-канала
Безопасность по умолчаниюПривязка к IP и подсети, Kerberos опциональноАутентификация по учётным записям и ACLSSH-ключи и шифрование канала
Сложность настройкиНизкая: пакет и одна строка в exportsСредняя: пользователи, группы, ACL, SELinuxМинимальная: одна команда sshfs

Финальная проверка перед вводом в эксплуатацию: строка в /etc/exports содержит конкретную подсеть, root_squash и sync, каталог принадлежит нужному UID, exportfs -v показывает применившиеся флаги, клиент монтирует и пишет тестовый файл, а showmount -e с постороннего хоста не отдаёт лишних путей. Как только эти шесть пунктов сходятся, экспорт можно считать безопасным для рабочей сети.

Поделиться: