Настройка WebDAV на OpenSUSE 11.3

Автор: Falko Timme
Версия 1.0
Следите за мной в Twitter

Введение

Этот документ объясняет, как настроить WebDAV с Apache2 на сервере OpenSUSE 11.3. WebDAV (Web-based Distributed Authoring and Versioning) — это расширение HTTP, которое позволяет редактировать файлы прямо на сервере Apache без загрузки/выгрузки через FTP. Также WebDAV подходит для обычной передачи файлов (загрузка/скачивание).

Важно: я не даю гарантии, что инструкции сработают без адаптации в вашей среде.

Сценарий и термины

Сервер в примере: OpenSUSE 11.3 с IP 192.168.0.100.
WebDAV: расширение HTTP для удалённого управления файлами.
vhost: виртуальный хост Apache для домена.

Краткое определение WebDAV: протокол, расширяющий HTTP методами для совместного редактирования и управления файлами на удалённом сервере.

1 Предварительная заметка

В примере используется OpenSUSE 11.3 и домен www.example1.com. Адаптируйте пути, имена пользователей и домены под вашу инфраструктуру.

2 Установка WebDAV

Если Apache ещё не установлен, выполните:

yast2 -i apache2

Затем включите модули WebDAV:

a2enmod dav  
a2enmod dav_fs  
a2enmod dav_lock

Создайте системные ссылки для автозапуска Apache и запустите сервис:

chkconfig --add apache2

/etc/init.d/apache2 start

Важно: на старых системах OpenSUSE утилиты управления сервисами и пути могут отличаться — проверяйте документацию вашей версии.

3 Создание виртуального хоста

В этом примере создаём vhost для www.example1.com с корнем /srv/www/web1/web. Если у вас уже есть vhost, примените соответствующие изменения к нему.

Создаём директорию и задаём владельца (пользователь wwwrun, группа www):

mkdir -p /srv/www/web1/web  
chown wwwrun:www /srv/www/web1/web

Создаём конфигурационный файл vhost:

vi /etc/apache2/vhosts.d/www.example1.com.conf

Откройте /etc/apache2/httpd.conf и добавьте строку NameVirtualHost перед Include /etc/apache2/vhosts.d/.conf:

vi /etc/apache2/httpd.conf

| [...] ### Virtual server configuration ############################################ # # VirtualHost: If you want to maintain multiple domains/hostnames on your # machine you can setup VirtualHost containers for them. Most configurations # use only name-based virtual hosts so the server doesn't need to worry about # IP addresses. This is indicated by the asterisks in the directives below. # # Please see the documentation at # # for further details before you try to setup virtual hosts. # # You may use the command line option '-S' to verify your virtual host # configuration. # NameVirtualHost * Include /etc/apache2/vhosts.d/*.conf [...] |

Перезапустите Apache:

/etc/init.d/apache2 restart

4 Настройка виртуального хоста для WebDAV

Создаём файл паролей WebDAV и пользователя test (ключ -c создаёт файл, если он отсутствует):

htpasswd2 -c /srv/www/web1/passwd.dav test

Вас попросят ввести пароль. Не используйте -c, если файл passwd.dav уже существует — это пересоздаст файл и удалит других пользователей.

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

chown root:www /srv/www/web1/passwd.dav  
chmod 640 /srv/www/web1/passwd.dav

Добавляем в конфигурацию vhost директивы Alias и Location для включения WebDAV:

vi /etc/apache2/vhosts.d/www.example1.com.conf

| [...] Alias /webdav /srv/www/web1/web DAV On AuthType Basic AuthName "webdav" AuthUserFile /srv/www/web1/passwd.dav Require valid-user [...] |

Alias + обеспечивают вызов WebDAV по /webdav, при этом остальные URL в vhost остаются обычными HTTP.

Полный vhost в итоге будет выглядеть так:

| ServerAdmin webmaster@localhost ServerName www.example1.com ServerAlias example1.com DocumentRoot /srv/www/web1/web/ Options Indexes MultiViews AllowOverride None Order allow,deny allow from all Alias /webdav /srv/www/web1/web DAV On AuthType Basic AuthName "webdav" AuthUserFile /srv/www/web1/passwd.dav Require valid-user |

Далее указываем место для базы блокировок WebDAV. В примере — /var/lib/dav/:

mkdir /var/lib/dav/  
chown wwwrun:www /var/lib/dav/

Откройте /etc/apache2/httpd.conf и добавьте DAVLockDB выше строки NameVirtualHost *:

vi /etc/apache2/httpd.conf

| [...] ### Virtual server configuration ############################################ # # VirtualHost: If you want to maintain multiple domains/hostnames on your # machine you can setup VirtualHost containers for them. Most configurations # use only name-based virtual hosts so the server doesn't need to worry about # IP addresses. This is indicated by the asterisks in the directives below. # # Please see the documentation at # # for further details before you try to setup virtual hosts. # # You may use the command line option '-S' to verify your virtual host # configuration. # # Location of the WebDAV lock database. DAVLockDB /var/lib/dav/lockdb NameVirtualHost * Include /etc/apache2/vhosts.d/*.conf [...] |

Перезапустите Apache:

/etc/init.d/apache2 restart

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

Установим cadaver — консольный клиент WebDAV:

yast2 -i cadaver

Проверим работу:

cadaver http://www.example1.com/webdav/

Вас попросят ввести имя пользователя: введите test и его пароль. При успешной аутентификации вы попадёте в WebDAV-оболочку. Команда quit завершит сессию:

server1:~ # cadaver http://www.example1.com/webdav/  
Authentication required for webdav on server `www.example1.com':  
Username: test  
Password:  
dav:/webdav/> quit  
Connection to `www.example1.com' closed.  
server1:~ #

URL WebDAV: http://www.example1.com/webdav/ для Linux-клиентов; для Windows-клиентов иногда требуется явно указывать порт, например http://www.example1.com:80/webdav/.

6 Безопасность и жёсткая настройка

Важно обеспечить безопасность при использовании WebDAV — базовая аутентификация передаёт пароли в кодировке Base64 (что не шифрует), поэтому рекомендуется:

Всегда включать HTTPS (TLS). Настройте сертификаты и редирект HTTP → HTTPS.
Использовать модули аутентификации на основе хэшей/LDAP/Kerberos при необходимости.
Ограничить права на файловой системе: только необходимые пользователи/группы должны иметь запись.
Размещать DAVLockDB и passwd-файлы в недоступных из web местах (как в примере).
Ограничивать доступ по IP/подсетям, если WebDAV нужен только локально или корпоративной сети.

Пример минимальной настройки HTTPS (установить mod_ssl и сертификат) и добавить в виртуальный хост перенаправление с 80 на 443 и SSL-конфигурацию — см. документацию Apache для вашей версии.

7 Отказоустойчивость и резервное копирование

База блокировок DAVLockDB должна поддерживаться при бэкапах; её потеря может нарушить механизмы блокировок.
Резервируйте passwd.dav вне веб-каталога и включайте регулярное копирование.
Для крупной нагрузки рассмотрите выделенную файловую систему или NAS с поддержкой блокировок.

8 Типичные проблемы и быстрый план реагирования

Краткий runbook для диагностики проблем:

Проверка статуса Apache:

/etc/init.d/apache2 status

Проверка ошибок в логах:

tail -n 100 /var/log/apache2/error_log

Убедитесь, что модули dav, dav_fs и dav_lock загружены:

apache2ctl -M | grep dav

Проверка прав на web-каталог и файлы passwd.dav:

ls -ld /srv/www/web1/web
ls -l /srv/www/web1/passwd.dav

Если блокировки не работают — проверьте DAVLockDB и права на /var/lib/dav/.
Для проблем с аутентификацией проверьте формат файла passwd.dav (htpasswd2) и права доступа.

Если после проверки стандартных пунктов проблема сохраняется — временно включите подробное логирование (LogLevel debug) и повторите тест.

9 Когда WebDAV может не подойти

Если требуется сложная система контроля версий — используйте специализированные решения (Git, SVN).
Для сценариев с высокой конкуренцией записей и большим количеством параллельных операций WebDAV может создавать конфликты блокировок.
В публичном интернете WebDAV с базовой аутентификацией без HTTPS — риск утечки учётных данных.

10 Альтернативные подходы

Использовать SFTP/SSHFS для безопасного монтирования удалённой файловой системы.
Рассмотреть WebDAV поверх HTTPS с интеграцией с LDAP/Active Directory для централизованной аутентификации.
Для версионности и совместной работы предпочтительнее Git/Nextcloud/ownCloud в зависимости от требований.

11 Чеклист ролей (администратор / пользователь)

Администратор:

Установить apache2, включить модули dav, dav_fs, dav_lock.
Создать структуру каталогов и задать владельцев/права.
Создать passwd.dav и задать права.
Настроить DAVLockDB и перезапустить Apache.
Настроить HTTPS и ограничение доступа.

Пользователь:

Получить имя пользователя и пароль от администратора.
Подключиться cadaver/настроить монтирование в клиенте (Linux/Windows).
Проверять блокировки и уведомлять администратора при конфликтах.

12 Совместимость и миграция

Конфигурация ориентирована на Apache 2.2 (типично для OpenSUSE 11.3). Для Apache 2.4 синтаксис Require/Order может отличаться — адаптируйте под версию.
При переходе на более новые дистрибутивы проверьте команды управления сервисами (systemd вместо /etc/init.d) и утилиты (htpasswd вместо htpasswd2).

13 Краткая методология внедрения

Тестовая среда: разверните vhost на изолированном сервере.
Функциональное тестирование: аутентификация, чтение/запись, блокировки.
Безопасность: включите TLS, проверьте права и аудит.
Пилот: откройте доступ небольшой группе пользователей.
Прокатка в продакшен: мониторинг, резервное копирование, обновления.

14 Фактбокс с ключевыми параметрами

Типичная конфигурация: Apache 2.2 на OpenSUSE 11.3.
Основные файлы: /etc/apache2/vhosts.d/*.conf, /etc/apache2/httpd.conf, /srv/www/web1/, /srv/www/web1/passwd.dav, /var/lib/dav/lockdb.
Клиент для тестов: cadaver.

15 Однострочный глоссарий

WebDAV — протокол расширения HTTP для совместного редактирования и управления файлами на веб-сервере.

16 Ссылки

Важно: перед выпуском в продуктив проведите аудит безопасности и тесты производительности.

Краткое резюме

Установите Apache и модули dav, dav_fs, dav_lock.
Создайте vhost, настройте Alias и для /webdav.
Настройте файл паролей и права, укажите DAVLockDB.
Перезапустите Apache и проверьте доступ через cadaver.
Обязательно включите TLS и настройте ограничения доступа.

Социальный предпросмотр (рекомендуется для публикации):

OG Title: Настройка WebDAV на OpenSUSE 11.3
OG Description: Шаги по установке WebDAV в Apache2: настройка vhost, аутентификация, DAVLockDB, тестирование и рекомендации по безопасности.

Короткое объявление (100–200 слов)

Настройка WebDAV на OpenSUSE 11.3: простой и практичный гид для системных администраторов. В статье описаны установка apache2 и модулей dav, создание виртуального хоста, настройка аутентификации через htpasswd2 и размещение базы блокировок DAVLockDB. Приведены команды для тестирования через cadaver, рекомендации по безопасности (использование TLS, права доступа, резервное копирование), а также чеклист для администраторов и пользователей. Подойдёт для небольших команд и внутренних сервисов; перед развертыванием в публичной сети обязательно включите HTTPS и ограничьте доступ.

Как настроить WebDAV с Apache2 на OpenSUSE 11.3