wpan：夸克网盘增强客户端

项目简介

wpan 是基于夸克网盘的二次封装与功能补强项目：在夸克官方 API 之上补齐网盘管理、资源搜索转存、在线播放阅读、任务调度与消息通知等能力，并提供配套的 Flutter 客户端。服务端本地部署，数据保存在自己手里。

主要功能

夸克网盘能力

• 夸克 Cookie / TV 扫码登录，多账号配置管理
• 文件浏览、重命名、移动、上传、删除、批量操作
• 文件流式播放，支持 302 直连与本地代理两种模式
• 目录历史与路径规范化，常用目录快速跳转
• 并发下载与传输进度跟踪

资源搜索与转存

• 基于 pansou 的网盘资源聚合搜索，支持多搜索源插件
• 搜索结果可复制分享链接、一键转存
• 手动转存支持填写分享链接、提取码和保存路径
• 自动转存 / 定时同步，支持每天、每周规则，完成后推送站内消息

任务中心

统一管理转存任务与自动同步任务，支持任务搜索、状态筛选、执行详情、去同步和删除，并回显执行记录与失败原因。

播放与阅读

• 影视、短剧、播客 / 有声书等资源浏览与在线播放
• 视频播放器支持全屏、倍速、字幕、音轨、跳过片头片尾和投屏
• 短剧播放器支持选集、连续播放和手势控制
• 音频支持后台播放、定时关闭和断点续播
• EPUB / TXT / PDF 电子书阅读，保留阅读进度
• 播放历史记录与首页最近观看回显

资源发现与消息

• 热门推荐：豆瓣实时榜单（电影、电视剧）、短剧榜单、听书榜单，支持分页加载并联动全网资源搜索
• 站内消息中心：全部 / 夸克 / 系统分类，未读筛选、全部已读、消息删除
• WebSocket 实时推送，转存 / 同步结果及时通知
• 多用户与超级管理员权限，用户管理、头像 / 资料修改、密码修改
• App 与服务端在线检查更新

安装与使用

先启动服务端，再安装 Android 客户端，最后在客户端登录页通过局域网发现或手动输入服务端地址完成连接。

服务端：docker run 快速启动

mkdir -p /opt/wpan/conf /opt/wpan/data /opt/wpan/log

docker run -d --name wpan-server --restart unless-stopped -p 18090:18090 --add-host host.docker.internal:host-gateway -v /opt/wpan/conf:/app/conf -v /opt/wpan/data:/app/data -v /opt/wpan/log:/app/log hanlinwang0606/ohome:runtime-v2026.11.03

服务端：独立运行包（Windows / macOS / Linux）

从 Releases 下载对应平台的独立运行包并解压，目录中自带 launcher[.exe]、bin/server[.exe]、conf/config.yaml、sql/init_data.sql。首次启动请运行 launcher，不要直接运行 server。

客户端连接服务端

1. 先确认服务端已经启动
2. 手机和服务端尽量处于同一局域网
3. 在客户端登录页优先使用局域网发现
4. 自动发现失败时手动输入服务端地址，例如 http://192.168.1.10:18090

客户端下载地址见 Releases。默认超级管理员账号密码为 admin/123。

注意事项

• 服务端部署时 conf/config.yaml、data、log 三个目录最重要，建议定期备份。
• 本项目为个人兴趣开发，通过程序自动化提高网盘使用效率；没有任何破解行为，只是对夸克已有 API 进行封装，所有数据来自夸克官方 API。
• 作者不对网盘内容负责，也不对夸克官方 API 未来变动导致的影响负责，请自行斟酌使用。
• 源码公开仅供学习与交流，未授权商业使用，严禁用于非法用途。

---

本作品整理自 GitHub 开源项目 leftScience/wpan，原作者 @leftScience，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。