aliyundrive-webdav

GitHub Actions PyPI Docker Image aliyundrive-webdav Crates.io

🚀 Help me to become a full-time open-source developer by sponsoring me on GitHub

阿里云盘 WebDAV 服务，主要使用场景为配合支持 WebDAV 协议的客户端 App 如 Infuse、nPlayer 等实现在电视上直接观看云盘视频内容， 支持客户端 App 直接从阿里云盘获取文件播放而不经过运行本应用的服务器中转, 支持上传文件，但受限于 WebDAV 协议不支持文件秒传。

请注意：V2 版本基于阿里云盘开放平台接口实现，不再支持阿里云盘 Web 和 App 版本获取的 refresh token.

如果项目对你有帮助，请考虑捐赠支持项目持续维护。

Note

本项目作者没有上传需求, 故上传文件功能测试不全面且没有持续迭代计划.

安装

可以从 GitHub Releases 页面下载预先构建的二进制包， 也可以使用 pip 从 PyPI 下载:

bash pip install aliyundrive-webdav

如果系统支持 Snapcraft 比如 Ubuntu、Debian 等，也可以使用 snap 安装：

bash sudo snap install aliyundrive-webdav

OpenWrt 路由器

GitHub Releases 中有预编译的 ipk 文件， 目前提供了 aarch64/arm/mipsel/x86_64/i686 等架构的版本，可以下载后使用 opkg 安装，以 nanopi r4s 为例：

bash wget https://github.com/messense/aliyundrive-webdav/releases/download/v2.0.3/aliyundrive-webdav_2.0.3-1_aarch64_generic.ipk wget https://github.com/messense/aliyundrive-webdav/releases/download/v2.0.3/luci-app-aliyundrive-webdav_2.0.3_all.ipk wget https://github.com/messense/aliyundrive-webdav/releases/download/v2.0.3/luci-i18n-aliyundrive-webdav-zh-cn_2.0.3-1_all.ipk opkg install aliyundrive-webdav_2.0.3-1_aarch64_generic.ipk opkg install luci-app-aliyundrive-webdav_2.0.3_all.ipk opkg install luci-i18n-aliyundrive-webdav-zh-cn_2.0.3-1_all.ipk

其它 CPU 架构的路由器可在 GitHub Releases 页面中查找对应的架构的主程序 ipk 文件下载安装， 常见 OpenWrt 路由器 CPU 架构如下表（欢迎补充）：

| 路由器 | CPU 架构 | |----------------|----------------------| | nanopi r4s | aarch64generic | | 小米 AX3600 | aarch64cortex-a53 | | 斐讯 N1 盒子 | aarch64cortex-a53 | | Newifi D2 | mipsel24kc | | Pogoplug | arm_mpcore |

Tips: 不清楚 CPU 架构类型可通过运行 opkg print-architecture 命令查询。

OpenWrt 配置界面

Docker 运行

bash docker run -d --name=aliyundrive-webdav --restart=unless-stopped -p 8080:8080 \ -v /etc/aliyundrive-webdav/:/etc/aliyundrive-webdav/ \ -e REFRESH_TOKEN='your refresh token' \ -e WEBDAV_AUTH_USER=admin \ -e WEBDAV_AUTH_PASSWORD=admin \ messense/aliyundrive-webdav

其中，REFRESH_TOKEN 环境变量为你的阿里云盘 refresh_token，WEBDAV_AUTH_USER 和 WEBDAV_AUTH_PASSWORD 为连接 WebDAV 服务的用户名和密码。

QNAP 威联通 NAS

QNAP 插件

qnap-aliyunpan-webdav by @iranee.

ContainerStation (Docker)

管理员登陆 NAS 后安装 ContainerStation 并启动服务，在 Management (管理) 标签中 Create Application (新建应用)，配置如下

yaml version: '3.3' services: aliyundrive-webdav: container_name: aliyundrive-webdav restart: unless-stopped ports: - '8080:8080' environment: - 'REFRESH_TOKEN=mytoken...' image: messense/aliyundrive-webdav

其中 REFRESH_TOKEN 文档最下面说明；:8080 网盘访问映射端口，可以按需改为其他的。

点击 Create (创建)后启动，访问 http://nas地址:8080/ 即可看到你网盘的自动生成索引网页文件。

参考文档

rclone

由于 rclone 请求时总是会以上一个请求 URL 作为 Referer, 使用 rclone 时请使用 Web 版 refresh token 或者启动 aliyundrive-webdav 时增加 --no-redirect 参数.

为了避免重复上传文件，使用 rclone 时推荐使用 Nextcloud WebDAV 模式，可以支持 sha1 checksums. 另外需要配合 --no-update-modtime 参数，否则 rclone 为了更新文件修改时间还是会强制重新上传。

举个例子：

bash rclone --no-update-modtime copy abc.pdf aliyundrive-nc://docs/

获取 refresh token

命令行运行 aliyundrive-webdav qr login 扫码授权后会输出 refresh token

扫码获取 refresh token

命令行用法

```bash $ aliyundrive-webdav --help WebDAV server for AliyunDrive

Usage: aliyundrive-webdav [OPTIONS] aliyundrive-webdav

Commands: qr Scan QRCode help Print this message or the help of the given subcommand(s)

Options: --host Listen host [env: HOST=] [default: 0.0.0.0] -p, --port Listen port [env: PORT=] [default: 8080] --client-id Aliyun drive clientid [env: CLIENTID=] --client-secret Aliyun drive clientsecret [env: CLIENTSECRET=] -r, --refresh-token Aliyun drive refresh token [env: REFRESHTOKEN=] -U, --auth-user WebDAV authentication username [env: WEBDAVAUTHUSER=] -W, --auth-password WebDAV authentication password [env: WEBDAVAUTHPASSWORD=] -I, --auto-index Automatically generate index.html -S, --read-buffer-size Read/download buffer size in bytes, defaults to 10MB [default: 10485760] --upload-buffer-size Upload buffer size in bytes, defaults to 16MB [default: 16777216] --cache-size Directory entries cache size [default: 1000] --cache-ttl Directory entries cache expiration time in seconds [default: 600] --root Root directory path [default: /] -w, --workdir Working directory, refreshtoken will be stored in there if specified --no-trash Delete file permanently instead of trashing it --read-only Enable read only mode --tls-cert TLS certificate file path [env: TLSCERT=] --tls-key TLS private key file path [env: TLSKEY=] --strip-prefix Prefix to be stripped off when handling request [env: WEBDAVSTRIPPREFIX=] --debug Enable debug log --no-self-upgrade Disable self auto upgrade --skip-upload-same-size Skip uploading same size file --prefer-http-download Prefer downloading using HTTP protocol -h, --help Print help -V, --version Print version ```

Note

注意：TLS/HTTPS 暂不支持 MIPS 架构。

Note

注意：启用 --skip-upload-same-size 选项虽然能加速上传但可能会导致修改过的同样大小的文件不会被上传

License

This work is released under the MIT license. A copy of the license is provided in the LICENSE file.