zlobin1 / webdavmailrucloud Goto Github PK

• UA users! Mail.Ru заблокирован в вашей стране, используйте, например, эти инструкции

• Windows - .NET Framework 4.5 / .NET Core 2.0
• Linux - Mono 4.6 / .NET Core 2.0
• OS X - Mono 4.6 / .NET Core 2.0

WebDAVCloudMailRu-*-dotNet45.zip / WebDAVCloudMailRu-*-dotNetCore20.zip respectively

	-p, --port        (Default: 801) WebDAV server port or several ports separated by `,`
	-h, --host	  (Default: "http://127.0.0.1") WebDAV server host with protocol (http://* for http://0.0.0.0)
	--maxthreads      (Default: 5) Maximum concurrent connections to cloud.mail.ru
	--cache-listing   (Default: 30) Cache folders listing, sec
	--protocol        (Default: WebM1Bin) Cloud protocol
				* WebM1Bin	- (preferable) mix of mobile and DiskO protocols
				* WebV2		- desktop browser protocol

	--install <servicename>		Install as windows service (Windows/.Net only)
	--uninstall <servicename>       Uninstall windows service (Windows/.Net only)
	
	--help            Display this help screen.
	--version         Display version information.

How to use encryption !!!Beta version!!!

Using XTS AES-256 on-the-fly encryption/decryption

• Mark folder as encrypted using >>crypt init command
• Add # and separator string to your login: [email protected]#_SEP_
• After your mail.ru password add separator string and password for encrypting: MyLoginPassword_SEP_MyCryptingPassword
• After that files uploaded to this folder will be encrypted

Commands
Commands executed by making directory with special name.
Parameters with spaces must be screened by quotes.

• >>join SHARED_FOLDER_LINK Clone shared cloud.mail.ru file/folder to your account
• >>link SHARED_FOLDER_LINK [linkname] Link shared folder without wasting your space (or manually edit file /item.links.wdmrc)
  • >>link check Remove all dead links (may take time if there's a lot of links)
• >>move /full/path/from /full/path/to Fast move (if your client moves inner items recursively)
• >>copy /full/path/from /full/path/to Fast copy (if your client copies inner items recursively)
• >>lcopy x:/local/path/from /full/server/path/to If file already in cloud, add it by hash without uploading
• >>del [[/]path] Fast delete (if your client makes recursive deletions of inner items)
• >>share [[/]path] Make file/folder public
  
  • and create .share.wdmrc file with links
• >>sharev [[/]path] Make media file public
  
  • and create .share.wdmrc file with public and direct play links
• >>pl [[/]path] Make media file public
  
  • and create .share.wdmrc file with public and direct play links
    
  • and create .m3u8 playlist file
• >>crypt init Mark current folder as encrypted

Settings in wdmrc.exe.config

• Logging
  <config><log4net>
  It's standart Apache log4net configurations, take a look for examples

• Special command prefix
  <config><AdditionalSpecialCommandPrefix>
  custom special command prefix instead of >>. Make possible to use special commands if client doesn't allow >>.

• 2 Factor Authentification
  <config><TwoFactorAuthHandlerName>
  At this time you can use

  • AuthCodeWindow - asks for authcode in GUI window (only for .NET Framework releases)
  • AuthCodeConsole - asks for authcode in application console

  Be careful, this methods does not usable when application started as a service/daemon.
  You can make your own 2FA handlers inherited from ITwoFaHandler and put it in separate dll which name starts with MailRuCloudApi.TwoFA

Connect with (almost any) file manager that supports WebDAV using Basic authentification with no encryption and

• your cloud.mail.ru email and password
• or anonymous login if only public links list/download required (WinSCP script example)

Automatically split/join when uploading/downloading files larger than cloud allows.

Russian FAQ
geektimes.ru - Снова про WebDAV и Облако Mail.Ru
glashkoff.com - Как бесплатно подключить Облако Mail.Ru через WebDAV
manjaro.ru - Облако Mail.Ru подключаем через эмулятор WebDav как сетевой диск

Using as windows service

• Run cmd with Administrator rights
• Then, for example, wdmrc.exe --install wdmrc -p 801 --maxthreads 15
  
• net start wdmrc

(tested under Elementary OS and Lubuntu)

• download and unzip latest release _{^{(obsolete alternative way from Алексей Немиро )}}
• .Net Framework (WebDAVCloudMailRu-*-dotNet45.zip)
  • sudo apt install apt mono-complete
  • mono wdmrc.exe -p <port>
• .Net Core (WebDAVCloudMailRu-*-dotNetCore20.zip)
  • install .NET Core
  • dotnet wdmrc.dll <params>

See also

• Package for Gentoo Linux by powerman
• Docker image by slothds (DockerHub, GitHub)

# cat /etc/ssl/certs/* >ca-bundle.crt
# cert-sync ca-bundle.crt
# rm ca-bundle.crt

• download and unzip latest release _{^{(obsolete alternative way from Алексей Немиро )}}
• .Net Framework (WebDAVCloudMailRu-*-dotNet45.zip)
  • brew install mono (how to install brew)
  • mono wdmrc.exe -p <port>
• .Net Core (WebDAVCloudMailRu-*-dotNetCore20.zip)
  • install .NET Core
  • dotnet wdmrc.dll <params>

Use any client supports webdav.

• RaiDrive
• NetDrive
• rclone mount
• Total Commander:
  • requires to update WebDAV plugin to v.2.9
  • turn on (connection properties) -> Send\Receive accents in URLs as UTF-8 Unicode
• WebDrive:
  • disable (disk properties) -> HTTP Settings -> Do chunked upload for large files.
• avoid using Unicode non-printing characters such as right-to-left mark in file/folder names

• Ramon de Klein for nwebdav server
• Erast Korolev for Mail.Ru.net-cloud-client
• Gareth Lennox for XTSSharp
• C-A-T for testing and essential information

• Official client Disk-O:
• Total Commander plugin for cloud.mail.ru service
  
• MARC-FS - FUSE filesystem attempt for Mail.Ru Cloud