ali-webdav

本项目实现了阿里云盘的webdav协议，只需要简单的配置一下，就可以让阿里云盘变身为webdav协议的文件服务器。 基于此，你可以把阿里云盘挂载为Windows、Linux、Mac系统的磁盘，可以通过NAS系统做文件管理或文件同步，更多玩法等你挖掘

环境准备

ali-webdav 依赖 Java 环境来运行。如果您是从代码开始构建并运行Nacos，还需要为此配置 Maven环境，请确保是在以下版本环境中安装使用:

1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。
2. 64 bit JDK 1.8+；下载 & 配置。
3. Maven 3.2.x+；下载 & 配置。

下载源码或者安装包

你可以通过源码和发行包两种方式来获取 ali-webdav。

下载源码

# 代码下载 
git clone  https://github.com/maruifu/ali-webdav.git
cd ali-webdav/
# 代码打包 
mvn clean package -Dmaven.test.skip=true
# 运行
java -jar ali-webdav-0.1.0.jar  --aliyundrive.refresh-token="12ecb25e6ef23f0baf6bc3f9221022c7"  
# 也可以这样
java -jar ali-webdav-0.1.0.jar  --aliyundrive.refresh-token="12ecb25e6ef23f0baf6bc3f9221022c7"  --server.port="8888"  --aliyundrive.auth.enable="true"  --aliyundrive.auth.username="username"  --aliyundrive.auth.password="password"

# aliyundrive.refresh-token 是你的refreshToken 必填参数
# server.port 是你的端口默认是8080 选填
# aliyundrive.auth.enable 是否开启WebDav账户验证，默认开启true 选填
# aliyundrive.auth.username WebDav账户，默认admin 选填
# aliyundrive.auth.password WebDav密码，默认admin 选填

如果执行失败请创建该目录或者修改代码中目录 /usr/local/java/docker/ 为 ./

下载编译后压缩包方式

您可以从 最新稳定版本 下载对应系统的 ali-webdav-server-$version.zip 包。

    #  使用前获取refresh-token值，教程查看https://github.com/MaRuifu/ali-webdav/blob/main/tutorial/getToken.md
    # linux  或 mac 
    1.unzip ali-webdav-$version.zip z
    2.cd ali-webdav-server-0.1.0
    # 修改start.sh 文件中的refresh_token
    3.sh ./start.sh
    # windows
    1.解压ali-webdav-server-$version.zip 文件
    2.修改refresh-token值
    3.点击start.bat文件

容器运行

# 运行
docker run -d --name=ali-webdav --restart=always -p 8888:8080  -e ALIYUNDRIVE_REFRESH_TOKEN="12ecb25e6ef23f0baf6bc3f9221022c7"xiaomageit/ali-webdav:0.1.0
# 也可以这样
docker run -d --name=ali-webdav --restart=always -p 8888:8080  -v /etc/localtime:/etc/localtime -v /Users/maruifu/work/temp/:/usr/local/java/docker/ -e TZ="Asia/Shanghai" -e ALIYUNDRIVE_REFRESH_TOKEN="12ecb25e6ef23f0baf6bc3f9221022c7" -e ALIYUNDRIVE_AUTH_PASSWORD="admin" -e JAVA_OPTS="-Xmx1g" xiaomageit/ali-webdav:0.1.0

# ALIYUNDRIVE_REFRESH_TOKEN 是你的refreshToken 必填参数
# /usr/local/java/docker/ 挂载卷自动维护了最新的refreshToken，建议挂载
# ALIYUNDRIVE_AUTH_ENABLE 是否开启WebDav账户验证，默认开启true 选填
# ALIYUNDRIVE_AUTH_USERNAME WebDav账户，默认admin 选填
# ALIYUNDRIVE_AUTH_PASSWORD WebDav密码，默认admin 选填
# JAVA_OPTS 可修改最大内存占用，比如 -e JAVA_OPTS="-Xmx512m" 表示最大内存限制为512m

新手教程

群晖

点击我查看教程

Windows10

TODO

Linux 或 Mac

TODO

客户端兼容性

客户端	下载	上传	备注
群辉Cloud Sync	可用	可用	使用单向同步非常稳定
Rclone	可用	可用	推荐，支持各个系统
Mac原生	可用	可用
Windows原生	可用	有点小问题	不建议，适配有点问题，上传报错
RaiDrive	可用	可用	Windows平台下建议用这个

浏览器获取refreshToken方式

点击我查看获取方式

功能说明

支持的功能

1. 查看文件夹、查看文件
2. 文件移动目录
3. 文件重命名
4. 文件下载
5. 文件删除
6. 文件上传（支持大文件自动分批上传）
7. 支持超大文件上传（官方限制30G）
8. 支持WebDav权限校验（默认账户密码：admin/admin）
9. 文件下载断点续传
10. Webdav下的流媒体播放等功能

暂不支持的功能

1. 移动文件到其他目录的同时，修改文件名。比如 /a.zip 移动到 /b/a1.zip，是不支持的
2. 文件上传断点续传
3. 部分客户端兼容性不好

已知问题

1. 没有做文件sha1校验，不保证上传文件的100%准确性（一般场景下，是没问题的）
2. 通过文件名和文件大小判断是否重复。也就是说如果一个文件即使发生了更新，但其大小没有任何改变，是不会自动上传的
3. 不支持文件名包含 / 字符