yuanhaishan/webdav-aliyundriver

阿里云盘WebDAV服务镜像

镜像概述

本镜像实现了阿里云盘的WebDAV协议支持，通过简单配置即可将阿里云盘转换为WebDAV文件服务器，支持标准WebDAV协议访问，方便用户通过各类WebDAV客户端管理和访问阿里云盘中的文件。

核心功能特性

• WebDAV协议兼容：遵循标准WebDAV协议，可与FileZilla、Total Commander、macOS Finder等主流客户端配合使用
• refreshToken自动维护：通过挂载卷持久化存储并自动更新refreshToken，避免频繁手动配置
• 安全访问控制：支持自定义管理员密码，保障服务访问安全
• 资源配置灵活：可通过环境变量调整JVM内存限制，适应不同硬件环境

使用场景

• 个人用户通过WebDAV客户端（如Windows资源管理器、macOS Finder）直接管理阿里云盘文件
• 家庭或小型团队共享阿里云盘资源，实现跨设备文件同步
• 集成到NAS系统或其他需要文件存储的应用中，扩展存储能力

使用方法

容器运行命令

bash
docker run -d --name=webdav-aliyundriver --restart=always -p 8080:8080 \
  -v /etc/localtime:/etc/localtime \
  -v /etc/aliyun-driver/:/etc/aliyun-driver/ \
  -e TZ="Asia/Shanghai" \
  -e ALIYUNDRIVE_REFRESH_TOKEN="your refreshToken" \
  -e ALIYUNDRIVE_AUTH_PASSWORD="admin" \
  -e JAVA_OPTS="-Xmx1g" \
  docker.xuanyuan.run/yuanhaishan/webdav-aliyundriver:v2.4.0

参数说明

挂载卷

• /etc/localtime:/etc/localtime：同步容器与主机时区
• /etc/aliyun-driver/:/etc/aliyun-driver/：用于持久化存储refreshToken，建议挂载，镜像会自动维护最新的refreshToken

环境变量

• TZ：时区设置，推荐使用Asia/Shanghai
• ALIYUNDRIVE_REFRESH_TOKEN：阿里云盘刷新令牌，必需参数，获取方式见下文
• ALIYUNDRIVE_AUTH_PASSWORD：WebDAV服务管理员密码，默认值为admin，建议修改以提高安全性
• JAVA_OPTS：JVM参数配置，用于调整内存占用，如-Xmx512m表示限制最大内存为512MB

ALIYUNDRIVE_REFRESH_TOKEN获取方式

1. 使用浏览器（建议Chrome）访问阿里云盘官网并登录：[***]
2. 登录成功后，按F12打开开发者工具，切换到Application选项卡
3. 在左侧导航栏展开Local Storage，点击https://www.aliyundrive.com/
4. 在右侧列表中找到token项，点击展开后复制refresh_token的值（格式为小写字母和数字，无需复制双引号）

示例：ca6bf2175d73as2188efg81f87e55f11