WebDAV с Apache2 на Debian Etch

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

Версия и автор

Version 1.0
Author: Falko Timme

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

В примере используется сервер Debian Etch с IP-адресом 192.168.0.100. Подставьте свой IP или имя хоста при настройке.

2 Установка WebDAV

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

apt-get install apache2

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

a2enmod dav_fs
a2enmod dav

Перезагрузите Apache:

/etc/init.d/apache2 force-reload

Важно: на современных системах команды управления сервисом могут отличаться (systemctl). Debian Etch — устаревшая ветка; в новых дистрибутивах рекомендуется использовать актуальные пакеты и systemd.

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

Создадим корневую директорию для сайта и назначим владельца www-data:

mkdir -p /var/www/web1/web  
chown www-data /var/www/web1/web

Сделаем резервную копию дефолтного vhost и откроем конфигурацию:

mv /etc/apache2/sites-available/default /etc/apache2/sites-available/default_orig  
vi /etc/apache2/sites-available/default

Добавьте или отредактируйте конфигурацию так, чтобы она содержала примерно следующее:

NameVirtualHost *

        ServerAdmin webmaster@localhost

        DocumentRoot /var/www/web1/web/
        
                Options Indexes MultiViews
                AllowOverride None
                Order allow,deny
                allow from all

После изменения перезагрузите Apache:

/etc/init.d/apache2 reload

Если у вас уже есть vhost, адаптируйте путь DocumentRoot и другие настройки под вашу конфигурацию.

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

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

htpasswd -c /var/www/web1/passwd.dav test

Вас попросят ввести пароль для пользователя test.

Если клиенты Windows преобразуют имя пользователя в форму “IP\user” (например, 192.168.0.100\test), создайте второй запись в файле паролей. Не используйте ключ -c, чтобы не перезаписать файл:

htpasswd /var/www/web1/passwd.dav 192.168.0.100\\test

(Во входном имени мы используем два обратных слэша, чтобы экранировать первый.)

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

chown root:www-data /var/www/web1/passwd.dav  
chmod 640 /var/www/web1/passwd.dav

Отредактируйте vhost в /etc/apache2/sites-available/default и добавьте следующие строки (Alias + Location активируют WebDAV по URL /webdav):

Alias /webdav /var/www/web1/web


   DAV On
   AuthType Basic
   AuthName "webdav"
   AuthUserFile /var/www/web1/passwd.dav
   Require valid-user

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

NameVirtualHost *

        ServerAdmin webmaster@localhost

        DocumentRoot /var/www/web1/web/
        
                Options Indexes MultiViews
                AllowOverride None
                Order allow,deny
                allow from all
        

        Alias /webdav /var/www/web1/web

        
           DAV On
           AuthType Basic
           AuthName "webdav"
           AuthUserFile /var/www/web1/passwd.dav
           Require valid-user

Перезагрузите Apache:

/etc/init.d/apache2 reload

Важно: Basic-аутентификация передаёт базовую учётку в закодированном виде, но не шифрует её. Всегда используйте HTTPS (SSL/TLS) в продуктивной среде.

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

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

apt-get install cadaver

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

cadaver http://localhost/webdav/

Вас попросят ввести имя пользователя. Введите test и пароль. Если доступ предоставлен, WebDAV работает. Введите quit для выхода:

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

Безопасность и рекомендации

Всегда включайте HTTPS для WebDAV: Basic Auth уязвима в открытой сети.
Ограничьте доступ по IP или VPN, если возможно.
Храните файл паролей в директории с правами 640 и владельцем root:www-data.
Рассмотрите использование Digest-аутентификации или внешней системы аутентификации (LDAP) для большей безопасности.

Когда это не подходит

Если нужна сложная версия истории изменений или совместная работа с конфликтами — встроенный WebDAV не предоставляет полноценной VCS-функциональности.
Для обмена файлами большого объёма и синхронизации может быть удобнее использовать rsync, SFTP или специализированные решения (Nextcloud, Syncthing).

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

SFTP/SSH: безопасно и широко поддерживается.
WebDAV поверх HTTPS с внешним модулем аутентификации (LDAP/DB).
Облачные/корпоративные платформы (Nextcloud, ownCloud) для расширенных функций совместной работы.

Контрольный список администратора (роль: системный администратор)

Установлен пакет apache2.
Включены модули dav и dav_fs.
Создан DocumentRoot и права назначены на www-data.
Создан файл /var/www/web1/passwd.dav с пользователями.
Проверена работа через cadaver или GUI-клиент.
Внедрён SSL и протестировано подключение по HTTPS.
Настроены бэкапы конфигураций и файлов.

Контрольный список пользователя (роль: конечный пользователь)

Есть учётная запись и пароль.
Клиент WebDAV установлен (проводник ОС, cadaver, WebDAV-синхронизатор).
Проверено создание/удаление/редактирование файла в /webdav.

Критерии приёмки

Пользователь test успешно подключается к http(s):///webdav и может создавать, изменять и удалять файлы в каталоге /var/www/web1/web.
Доступ к файлу паролей ограничен: ls -l показывает owner root и группу www-data с правами 640.
В продакшне подключения происходят только по HTTPS.

Инцидентный план и откат

Если Apache не запускается после правок, восстановите резервную копию:

mv /etc/apache2/sites-available/default_orig /etc/apache2/sites-available/default
/etc/init.d/apache2 reload

Если аутентификация не работает — проверьте формат файла passwd.dav и права на него. Создайте тестового пользователя заново.
Для отката функции WebDAV просто удалите/закомментируйте блок и перезагрузите Apache.

Краткая методология настройки (шаги)

Установить Apache и модули dav, dav_fs.
Создать DocumentRoot и назначить права.
Настроить vhost и добавить Alias + Location для /webdav.
Создать файл паролей и пользователей.
Перезагрузить сервис и протестировать.
Внедрить HTTPS и политики безопасности.

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

Debian Etch — ветка старой эпохи Debian. На современных Debian/Ubuntu названия пакетов те же, но команды управления сервисом могут использовать systemctl. При миграции проверьте версии модулей apache2 и поддерживаемые методы аутентификации.

Резюме

Настройка WebDAV на Apache2 в Debian Etch состоит из установки модулей dav, создания виртуального хоста, настройки Alias/Location и файла паролей. Для продакшна обязательно применяйте HTTPS и ограничьте доступ по сети. Тестирование удобно выполнять через cadaver.

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