aliyundrive-webdav
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。 由于本项目作者不再使用梅林固件,V2 版本不再免费支持 Koolshare 梅林固件系统,如有需要请考虑付费支持。
如果项目对你有帮助,请考虑捐赠支持项目持续维护。 也可以考虑加入aliyundrive-webdav 知识星球获取咨询和技术支持服务。
Note
本项目作者没有上传需求, 故上传文件功能测试不全面且没有持续迭代计划.
安装
可以从 GitHub Releases 页面下载预先构建的二进制包, 也可以使用 pip 从 PyPI 下载:
pip install aliyundrive-webdav
如果系统支持 Snapcraft 比如 Ubuntu、Debian 等,也可以使用 snap 安装:
sudo snap install aliyundrive-webdav
OpenWrt 路由器
GitHub Releases 中有预编译的 ipk 文件, 目前提供了 aarch64/arm/mipsel/x86_64/i686 等架构的版本,可以下载后使用 opkg 安装,以 nanopi r4s 为例:
wget https://github.com/messense/aliyundrive-webdav/releases/download/v2.3.3/aliyundrive-webdav_2.3.3-1_aarch64_generic.ipk wget https://github.com/messense/aliyundrive-webdav/releases/download/v2.3.3/luci-app-aliyundrive-webdav_2.3.3_all.ipk wget https://github.com/messense/aliyundrive-webdav/releases/download/v2.3.3/luci-i18n-aliyundrive-webdav-zh-cn_2.3.3-1_all.ipk opkg install aliyundrive-webdav_2.3.3-1_aarch64_generic.ipk opkg install luci-app-aliyundrive-webdav_2.3.3_all.ipk opkg install luci-i18n-aliyundrive-webdav-zh-cn_2.3.3-1_all.ipk
其它 CPU 架构的路由器可在 GitHub Releases 页面中查找对应的架构的主程序 ipk 文件下载安装, 常见 OpenWrt 路由器 CPU 架构如下表(欢迎补充):
路由器 | CPU 架构 |
---|---|
nanopi r4s | aarch64_generic |
小米 AX3600 | aarch64_cortex-a53 |
斐讯 N1 盒子 | aarch64_cortex-a53 |
Newifi D2 | mipsel_24kc |
Pogoplug | arm_mpcore |
Tips: 不清楚 CPU 架构类型可通过运行
opkg print-architecture
命令查询。
Docker 运行
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 (新建应用),配置如下
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 时推荐使用 Nextcloud WebDAV 模式,可以支持 sha1 checksums. 另外需要配合 --no-update-modtime
参数,否则 rclone 为了更新文件修改时间还是会强制重新上传。
举个例子:
rclone --no-update-modtime copy abc.pdf aliyundrive-nc://docs/
获取 refresh token
- 通过在线工具获取 refresh token
- 命令行运行
aliyundrive-webdav qr login
扫码授权后会输出 refresh token
命令行用法
$ aliyundrive-webdav --help WebDAV server for AliyunDrive Usage: aliyundrive-webdav [OPTIONS] aliyundrive-webdav <COMMAND> Commands: qr Scan QRCode help Print this message or the help of the given subcommand(s) Options: --host <HOST> Listen host
[env: HOST=]
[default: 0.0.0.0]
-p, –port <PORT> Listen port
[env: PORT=]
[default: 8080]
–client-id <CLIENT_ID> Aliyun drive client_id
[env: CLIENT_ID=]
–client-secret <CLIENT_SECRET> Aliyun drive client_secret
[env: CLIENT_SECRET=]
–drive-type <DRIVE_TYPE> Aliyun drive type
[env: DRIVE_TYPE=]
Possible values: – resource: Resource drive – backup: Backup drive – default: Default drive -r, –refresh-token <REFRESH_TOKEN> Aliyun drive refresh token
[env: REFRESH_TOKEN=]
-U, –auth-user <AUTH_USER> WebDAV authentication username
[env: WEBDAV_AUTH_USER=]
-W, –auth-password <AUTH_PASSWORD> WebDAV authentication password
[env: WEBDAV_AUTH_PASSWORD=]
-I, –auto-index Automatically generate index.html -S, –read-buffer-size <READ_BUFFER_SIZE> Read/download buffer size in bytes, defaults to 10MB
[default: 10485760]
–upload-buffer-size <UPLOAD_BUFFER_SIZE> Upload buffer size in bytes, defaults to 16MB
[default: 16777216]
–cache-size <CACHE_SIZE> Directory entries cache size
[default: 1000]
–cache-ttl <CACHE_TTL> Directory entries cache expiration time in seconds
[default: 600]
–root <ROOT> Root directory path
[env: WEBDAV_ROOT=]
[default: /]
-w, –workdir <WORKDIR> Working directory, refresh_token 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_CERT> TLS certificate file path
[env: TLS_CERT=]
–tls-key <TLS_KEY> TLS private key file path
[env: TLS_KEY=]
–strip-prefix <STRIP_PREFIX> Prefix to be stripped off when handling request
[env: WEBDAV_STRIP_PREFIX=]
–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 –redirect Enable 302 redirect when possible -h, –help Print help (see a summary with ‘-h’) -V, –version Print version
[env: HOST=]
[default: 0.0.0.0]
-p, –port Listen port
[env: PORT=]
[default: 8080]
–client-id Aliyun drive client_id
[env: CLIENT_ID=]
–client-secret Aliyun drive client_secret
[env: CLIENT_SECRET=]
–drive-type Aliyun drive type
[env: DRIVE_TYPE=]
Possible values: – resource: Resource drive – backup: Backup drive – default: Default drive -r, –refresh-token Aliyun drive refresh token
[env: REFRESH_TOKEN=]
-U, –auth-user WebDAV authentication username
[env: WEBDAV_AUTH_USER=]
-W, –auth-password WebDAV authentication password
[env: WEBDAV_AUTH_PASSWORD=]
-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
[env: WEBDAV_ROOT=]
[default: /]
-w, –workdir Working directory, refresh_token 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: TLS_CERT=]
–tls-key TLS private key file path
[env: TLS_KEY=]
–strip-prefix Prefix to be stripped off when handling request
[env: WEBDAV_STRIP_PREFIX=]
–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 –redirect Enable 302 redirect when possible -h, –help Print help (see a summary with ‘-h’) -V, –version Print version” tabindex=”0″ role=”button” style=”box-sizing: border-box; position: relative; display: flex !important; padding: 0px !important; font-size: 14px; font-weight: var(–base-text-weight-medium, 500); line-height: 20px; white-space: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border: 0px; border-radius: 6px; appearance: none; color: var(–fgColor-accent, var(–color-accent-fg)); background-color: transparent; box-shadow: none; transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1) 0s, background-color, box-shadow, border-color; justify-content: center !important; align-items: center !important; margin: var(–base-size-8, 8px) !important; width: var(–control-small-size, 28px); height: var(–control-small-size, 28px);”>
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.