3步搭建全平台阿里云盘WebDAV服务：零门槛配置指南

aliyundrive-webdav是一款轻量级阿里云盘WebDAV服务工具，能解决多设备文件访问难题，让手机、电脑、电视等设备通过统一协议访问云端文件，无需重复上传下载。对于需要跨设备协作或家庭数据共享的用户，它提供了简单高效的解决方案。

一、价值解析：为什么需要阿里云盘WebDAV

传统文件管理面临多设备同步繁琐、存储空间不足等问题。阿里云盘WebDAV服务通过标准协议将云存储转化为本地可访问的"虚拟硬盘"，实现手机拍摄的照片自动同步到电脑编辑，或智能电视直接播放云端视频。相比同类工具，它支持全平台部署，从家庭NAS到路由器均可运行。

💡 避坑指南：确保阿里云盘账号已实名认证，未认证账号可能受限API调用频率。

二、准备工作：获取访问凭证

1. 安装依赖环境

git clone https://gitcode.com/gh_mirrors/ali/aliyundrive-webdav
cd aliyundrive-webdav
pip install -r requirements.txt

2. 获取Refresh Token（永久授权码）

运行项目中的令牌生成工具：

python refresh_token.py

当终端显示二维码时，使用阿里云盘App扫码登录。看到终端出现🔑符号及长字符串时，表示Refresh Token获取成功。

⚠️ 注意：Token是访问云盘的关键凭证，请勿分享给他人。建议截图保存或记录在安全地方。

💡 避坑指南：若扫码后无反应，检查网络连接或尝试重启脚本。

三、实践部署：无代码配置流程

1. 基础配置

在OpenWrt系统中找到"阿里云盘WebDAV"配置界面，填写以下信息：

• Refresh Token：粘贴获取到的授权码
• 监听主机：默认0.0.0.0（允许局域网访问）
• 监听端口：建议设置8080-65535间未占用端口
• 用户名/密码：设置访问验证凭据

2. 启动服务

保存配置后点击"启用"按钮，服务将自动后台运行。可通过系统日志确认启动状态。

💡 避坑指南：若服务启动失败，检查端口是否被占用或Token是否过期。

四、拓展应用：跨设备访问与性能优化

常见设备连接示例

• Windows资源管理器：在地址栏输入\\192.168.1.1:8080，输入用户名密码即可挂载
• 手机端：使用ES文件浏览器添加WebDAV服务器，地址填路由器IP和端口
• 智能电视：通过支持WebDAV的播放器应用，输入服务器信息访问视频文件

性能优化参数

参数	说明	推荐值
--cache-size	缓存大小(MB)	50-200
--read-buffer	读取缓冲区(KB)	1024
--max-connections	最大连接数	10

完整配置指南：docs/advanced.md

🔍 搜索提示：遇到连接问题可搜索"WebDAV错误码+设备型号"获取解决方案。