Skip to content

WebDav proxy to Mail.ru Cloud

License

Notifications You must be signed in to change notification settings

slothds/wdmrc-proxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 

Repository files navigation

docker/wdmrc-proxy

WebDav proxy to Mail.ru Cloud
Author yar229 (GitHub)

Предисловие

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

в связи с тем, что данный образ вдруг появился в описании к самой проксе,
подумал что было бы не плохо написать пару строчек о моей поделке.

Причины и следствия

  • Почему было принято решение использовать Docker
    1. портативность: быстро и без танцев разворачивается на новой машине.
    2. меньше мусора: если прокси перестанет быть необходимой,
      удаляется без хвостов и необходимости подчищать пакеты-зависимости.
  • Почему в качестве базового образа используется поделка с supervisord на борту
    • у Docker'а крайне печально с пробуждением сервисов,
      завязанных на сетевых протаколах после спячки (особенно на windows).
      политика restart=always у контейнера частично решает проблему,
      однако были выявлены случаи когда контейнер попросту повисал,
      что приводило к следующему сценарию: контейнер запущен,
      сервис в нём вроде бы так же запущен, однако ни на какие внешние "раздражители"
      (ни запросы, ни telnet на порт) сервис не реагирует,
      что собственно и породило идею приплести некую приблуду,
      которая будет мониторить состояние сервиса и перезапускать его, если понадобится.
      так появился супервизор в контейнере, и, по изложенным выше причинам,
      избавляться от него я не планирую.

Запуск

По умолчанию, WDMRC слушает порт 8010 на всех адресах.

docker run -d --restart always \
           --name wdmrc-proxy \
           -p 8010:8010 \
           slothds/wdmrc-proxy:stable

Дополнительные параметры

Для смены заданных по умолчанию параметров используются переменные окружения:

WDMRC_HOST - адрес, который будет слушать WDMRC
WDMRC_PORT - порт подключения к WDMRC
WDMRC_ARGS - дополнительные аргументы запуска прокси

Пример

Запуск прокси с использованием сети host машины,
с прослушиванием только localhost:8080,
максимальным числом потоков = 10 и подключением по протоколу WebV2

docker run -d --net=host \
           --name=wdmrc-proxy \
           --env=WDMRC_HOST=http://127.0.0.1 \
           --env=WDMRC_PORT=8080 \
           --env=WDMRC_ARGS="--maxthreads=10 --protocol=WebV2" \
           slothds/wdmrc-proxy:stable

Как пользоваться

т.к. данная утилита - это просто прокси, транслирующая запросы от вашего webdav клинта
к сервисам mail.ru, вам, собственно, потребуется webdav клиент.
Более детально с данным вопросом лучше ознакомиться в документации от автора:
Чтиво | FAQ на русском

WebDav URL в клиенте указываете: http://localhost:8010