xiaomageit/ali-webdav

ali-webdav镜像说明

镜像概述

本镜像实现阿里云盘的WebDAV协议，通过简单配置即可将阿里云盘转换为WebDAV文件服务器，支持将阿里云盘挂载到Windows、Linux、Mac系统作为本地磁盘使用，也可通过NAS系统进行文件管理与同步，拓展阿里云盘的使用场景。

核心功能

1. 查看文件夹与文件
2. 文件移动、重命名、删除操作
3. 文件下载（支持断点续传）
4. 文件上传（支持大文件分批上传，最大30G）
5. WebDAV权限校验（默认账户密码：admin/admin）
6. 支持流媒体播放等WebDAV相关功能

使用场景

• 系统挂载：将阿里云盘挂载为Windows、Linux、Mac本地磁盘，直接访问盘内文件
• NAS同步：通过群晖Cloud Sync等工具实现阿里云盘与NAS的文件同步
• 跨平台管理：使用Rclone等工具在不同系统中统一管理阿里云盘文件

配置说明

环境变量参数

• ALIYUNDRIVE_REFRESH_TOKEN：阿里云盘的refreshToken（必填）
• ALIYUNDRIVE_AUTH_ENABLE：是否开启WebDAV账户验证（默认true，选填）
• ALIYUNDRIVE_AUTH_USERNAME：WebDAV账户（默认admin，选填）
• ALIYUNDRIVE_AUTH_PASSWORD：WebDAV密码（默认admin，选填）
• JAVA_OPTS：JVM参数，如限制内存（例如 -Xmx1g，选填）
• TZ：时区设置（例如 Asia/Shanghai，选填）

Docker部署示例

基础运行

bash
docker run -d --name=ali-webdav --restart=always -p 8888:8080 \
  -e ALIYUNDRIVE_REFRESH_TOKEN="你的refreshToken" \
  xiaomageit/ali-webdav:0.1.0

带挂载卷与自定义配置

bash
docker run -d --name=ali-webdav --restart=always -p 8888:8080 \
  -v /etc/localtime:/etc/localtime \
  -v /本地路径:/usr/local/java/docker/ \
  -e TZ="Asia/Shanghai" \
  -e ALIYUNDRIVE_REFRESH_TOKEN="你的refreshToken" \
  -e ALIYUNDRIVE_AUTH_PASSWORD="自定义密码" \
  -e JAVA_OPTS="-Xmx512m" \
  xiaomageit/ali-webdav:0.1.0

挂载 /usr/local/java/docker/ 目录可自动维护最新的refreshToken，建议挂载。

客户端兼容性

获取refreshToken

参考https://github.com/MaRuifu/ali-webdav/blob/main/tutorial/getToken.md%E8%8E%B7%E5%8F%96%E9%98%BF%E9%87%8C%E4%BA%91%E7%9B%98%E7%9A%84refreshToken%E3%80%82

已知限制

1. 不支持移动文件时同时修改文件名
2. 文件上传暂不支持断点续传
3. 文件名不能包含 / 字符
4. 未做文件sha1校验，不保证100%上传准确性