Что мы получим в итоге и кому подходит это руководство
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 шарах.
Чек-лист перед продом:
- в /etc/exports нет символа * и широких подсетей;
- экспортируются только выделенные каталоги, не корень ФС;
- root_squash указан явно во всех строках;
- каталоги, где запись не нужна, помечены ro;
- firewall разрешает 2049/tcp только доверенной подсети;
- showmount -e с внешнего хоста не показывает лишнего;
- владельцы каталогов совпадают по 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 команды.
- showmount -e 192.168.1.10 с клиента: виден ли экспорт вообще.
- nc -zv 192.168.1.10 2049: доступен ли порт, не режет ли firewall.
- exportfs -v на сервере: применились ли опции.
- ls -ln на каталоге и id username на обеих машинах: совпадают ли UID и режим.
- journalctl -u nfs-kernel-server и dmesg -T | tail -50 на сервере: текст ошибки.
- На клиенте монтировать с 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. Сценарии с интенсивными блокировками файлов под высокой нагрузкой лучше тестировать отдельно, а иногда выгоднее объектное хранилище.
| Критерий | NFS | SMB/CIFS | SSHFS |
|---|---|---|---|
| Платформы | Linux и Unix, NFS-клиенты для Windows и macOS отдельно | Windows, macOS, Linux | Любая с SSH-клиентом |
| Производительность | Высокая в локальной сети | Средняя и высокая, зависит от версии протокола | Низкая, оверхед шифрования и одного TCP-канала |
| Безопасность по умолчанию | Привязка к IP и подсети, Kerberos опционально | Аутентификация по учётным записям и ACL | SSH-ключи и шифрование канала |
| Сложность настройки | Низкая: пакет и одна строка в exports | Средняя: пользователи, группы, ACL, SELinux | Минимальная: одна команда sshfs |
Финальная проверка перед вводом в эксплуатацию: строка в /etc/exports содержит конкретную подсеть, root_squash и sync, каталог принадлежит нужному UID, exportfs -v показывает применившиеся флаги, клиент монтирует и пишет тестовый файл, а showmount -e с постороннего хоста не отдаёт лишних путей. Как только эти шесть пунктов сходятся, экспорт можно считать безопасным для рабочей сети.