Перейти к содержанию

dav-ext: Поддержка NGINX WebDAV PROPFIND, OPTIONS, LOCK, UNLOCK

Установка

Вы можете установить этот модуль в любой дистрибутив на базе RHEL, включая, но не ограничиваясь:

  • RedHat Enterprise Linux 7, 8, 9 и 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 и Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-dav-ext

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-dav-ext

Включите модуль, добавив следующее в верхнюю часть файла /etc/nginx/nginx.conf:

load_module modules/ngx_http_dav_ext_module.so;

Этот документ описывает nginx-module-dav-ext v3.0.0, выпущенный 17 декабря 2018 года.

nginx поддерживает WebDAV PROPFIND, OPTIONS, LOCK, UNLOCK.

О модуле

Стандартный ngx_http_dav_module предоставляет частичную реализацию WebDAV и поддерживает только методы GET, HEAD, PUT, DELETE, MKCOL, COPY, MOVE.

Для полной поддержки WebDAV в nginx необходимо включить стандартный ngx_http_dav_module, а также этот модуль для отсутствующих методов.

Тестирование

Тесты модуля требуют стандартные nginx-tests и библиотеку Perl HTTP::DAV.

$ export PERL5LIB=/path/to/nginx-tests/lib
$ export TEST_NGINX_BINARY=/path/to/nginx
$ prove t

Блокировка

  • Поддерживаются только эксклюзивные блокировки на запись, которые являются единственным типом блокировок, описанным в спецификации WebDAV.
  • Все текущие блокировки хранятся в списке. Проверка, ограничен ли объект блокировкой, требует O(n) операций. Огромное количество одновременно удерживаемых блокировок может ухудшить производительность. Поэтому не рекомендуется устанавливать большой таймаут блокировки, который увеличит количество блокировок.

Директивы

dav_ext_methods
Синтаксис: dav_ext_methods [PROPFIND] [OPTIONS] [LOCK] [UNLOCK]
Контекст: http, server, location

Включает поддержку указанных методов WebDAV в текущем контексте.

dav_ext_lock_zone
Синтаксис: dav_ext_lock_zone zone=NAME:SIZE [timeout=TIMEOUT]
Контекст: http

Определяет общую зону для блокировок WebDAV с указанными NAME и SIZE. Также определяет время истечения блокировки TIMEOUT. Значение по умолчанию для таймаута блокировки составляет 1 минуту.

dav_ext_lock
Синтаксис: dav_ext_lock zone=NAME
Контекст: http, server, location

Включает блокировку WebDAV в указанном контексте. Блокировки хранятся в общей зоне, указанной NAME. Эта зона должна быть определена с помощью директивы dav_ext_lock_zone.

Обратите внимание, что хотя эта директива включает возможности блокировки в текущем контексте, методы HTTP LOCK и UNLOCK также должны быть явно указаны в dav_ext_methods.

Пример 1

Простой пример без блокировок:

location / {
    root /data/www;

    dav_methods PUT DELETE MKCOL COPY MOVE;
    dav_ext_methods PROPFIND OPTIONS;
}

Пример 2

WebDAV с блокировкой:

http {
    dav_ext_lock_zone zone=foo:10m;

    ...

    server {
        ...

        location / {
            root /data/www;

            dav_methods PUT DELETE MKCOL COPY MOVE;
            dav_ext_methods PROPFIND OPTIONS LOCK UNLOCK;
            dav_ext_lock zone=foo;
        }
    }
}

Пример 3

WebDAV с блокировкой, работающий с клиентом MacOS:

http {
    dav_ext_lock_zone zone=foo:10m;

    ...

    server {
        ...

        location / {
            root /data/www;

            # включить создание директорий без завершающего слэша
            set $x $uri$request_method;
            if ($x ~ [^/]MKCOL$) {
                rewrite ^(.*)$ $1/;
            }

            dav_methods PUT DELETE MKCOL COPY MOVE;
            dav_ext_methods PROPFIND OPTIONS LOCK UNLOCK;
            dav_ext_lock zone=foo;
        }
    }
}

GitHub

Вы можете найти дополнительные советы по конфигурации и документацию для этого модуля в репозитории GitHub для nginx-module-dav-ext.