messense/aliyundrive-webdav

aliyundrive-webdav

概述

aliyundrive-webdav是一款将阿里云盘转换为WebDAV服务的工具，主要用于配合支持WebDAV协议的客户端应用（如Infuse、nPlayer等），实现在电视等设备上直接观看阿里云盘视频内容。支持客户端直接从阿里云盘获取文件播放而不经过运行本应用的服务器中转，同时支持文件上传（受限于WebDAV协议不支持文件秒传）。

注意：V2版本基于阿里云盘开放平台接口实现，不再支持通过阿里云盘Web端和App获取的refresh token。由于作者不再使用梅林固件，V2版本不再免费支持Koolshare梅林固件系统，如有需要可考虑付费支持。

核心功能与特性

• 支持WebDAV协议，兼容各类WebDAV客户端
• 视频文件直取播放，无需服务器中转，降低带宽占用
• 支持文件上传（不支持秒传）
• 目录条目缓存机制，提升访问效率
• 支持基本身份认证，保障服务安全
• 可配置根目录、缓存大小及过期时间
• 支持TLS加密（部分架构不支持）

使用场景

• 家庭媒体中心：配合电视盒子、智能电视上的视频客户端（如Infuse、nPlayer）播放阿里云盘视频
• 多设备文件共享：通过WebDAV客户端在不同设备间访问阿里云盘文件
• 轻量级云存储访问：为不支持阿里云盘官方客户端的设备提供文件访问能力

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

Docker Compose配置（适用于QNAP等NAS）

yaml
version: '3.3'
services:
  aliyundrive-webdav:
    container_name: aliyundrive-webdav
    restart: unless-stopped
    ports:
      - '8080:8080'  # 可根据需要修改映射端口
    environment:
      - 'REFRESH_TOKEN=mytoken...'  # 替换为你的refresh token
      - 'WEBDAV_AUTH_USER=admin'    # WebDAV访问用户名
      - 'WEBDAV_AUTH_PASSWORD=admin' # WebDAV访问密码
    image: messense/aliyundrive-webdav

获取Refresh Token

使用以下任一方式获取阿里云盘的refresh token：

1. 在线工具：访问在线工具获取
2. 命令行扫码：运行容器后执行命令 docker exec -it aliyundrive-webdav aliyundrive-webdav qr login，扫码授权后即可输出refresh token

配置参数说明

环境变量

命令行选项

通过docker exec -it aliyundrive-webdav aliyundrive-webdav --help可查看所有命令行选项，主要包括：

• --host <HOST>: 监听地址
• -p, --port <PORT>: 监听端口
• -r, --refresh-token <REFRESH_TOKEN>: refresh token
• -U, --auth-user <AUTH_USER>: 认证用户名
• -W, --auth-password <AUTH_PASSWORD>: 认证密码
• -I, --auto-index: 自动生成index.html
• --read-buffer-size <SIZE>: 读取/下载缓冲区大小（默认10MB）
• --upload-buffer-size <SIZE>: 上传缓冲区大小（默认16MB）
• --cache-size <SIZE>: 目录缓存大小（默认1000）
• --cache-ttl <SECONDS>: 缓存过期时间（默认600秒）
• --no-trash: 删除文件时直接永久删除（不放入回收站）
• --read-only: 启用只读模式
• --debug: 启用调试日志

注意事项

• TLS/HTTPS支持：暂不支持MIPS架构设备
• 上传功能：作者无上传需求，测试不全面且无持续迭代计划
• --skip-upload-same-size选项：启用后会跳过相同大小文件的上传，但可能导致修改过的同大小文件无法上传
• 确保refresh token有效，失效后需重新获取并更新环境变量

许可证

本项目基于MIT许可证开源，详见https://github.com/messense/aliyundrive-webdav/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82