trueaiorg/mdrive
阿里云盘的开源同步和备份工具，基于阿里云盘官方API授权。
Image
Security
Databases & storage
4
3.0K
trueaiorg/mdrive repository overview
MDrive
https://github.com/trueai-org/mdrive
多平台、模块化、可挂载、安全、加密的云盘自动同步、备份工具，支持阿里云盘、多账号、加密等，支持单向、镜像、双向等同步备份，完全免费开源。
提供 Docker、Windows、Linux、Web 等多平台版本。
支持多种算法同步与备份，保证数据的安全性，任何第三方、任何云盘服务商都无法查看或分析你的数据，只有通过你本人设置的安全密钥才能解密数据，保证您的数据安全和隐私。
更多版本，敬请期待~~
特性
- 不限速，阿里云盘官方接口支持，上传下载均不限速。
- 挂载云盘支持，支持将云盘挂载到本地，作为本地硬盘使用。
- 多线程支持，多线程上传、下载、同步，充分利用带宽。
- 定时作业，定时同步、还原、备份等。
- 在线云盘文件管理。
- 免费
- 开源
- 跨平台，支持 Windows、Linux、Unix、Mac、Android、Docker 等平台。
- 快速校验，多种算法支持 sha1、sha256、md5
- 安全，加密
- 多账号支持，多阿里云盘账号支持
- 多作业计划支持，可以配置多个同步时间点。
- 多种同步方式：镜像、备份、双向
- 极速，采用安全极速的差异算法，极速实现单向或双向同步。
- 支持秒传
- 支持过滤本地文件/文件夹，丰富的校验规则。
- 高性能，采用 .NET8 最新技术，极致的性能体现，低内存、高性能、跨平台。
- WebUI 可视化配置
- WebUI 前后端分离，保证了后台服务的高可用。
- 支持只读模式，只读模式启动服务，则不可以编辑配置。
- 支持自定义端口。
- 支持回收站功能，支持删除文件/夹到回收站。
- WebUI 支持多主题，支持黑色模式。
- 支持云盘管理和在线下载文件。
- 支持作业暂停、恢复、禁用、取消、删除等。
- 支持队列，保证作业的高可用，避免多任务卡顿以及抢占资源问题。
- 支持登录验证，下载验证。
- 支持从配置文件中启动作业。
- 支持超时自动锁定管理后台（BETA）。
- 支持在线上传（BETA）。
- 多模块支持，支持 Duplicati、Kopia 模块，直接进行加密（BETA）。
- 支持还原云盘文件（BETA）。
- 支持将云盘挂载到本地，像管理本地文件一样管理远程文件（BETA）。
- 支持将备份目录挂载到本地（BETA）。
- 支持快照，支持快照挂载（BETA）。
- 支持导入/导出配置（BETA）。
安装与使用
快速启动
# 1. docker 启动
docker pull trueaiorg/mdrive
docker run --name mdrive -d --restart=always \
-e BASIC_AUTH_USER=admin -e BASIC_AUTH_PASSWORD=123456 \
-p 8080:8080 trueaiorg/mdrive
# 2. windows 使用
a. 通过 https://github.com/trueai-org/MDriveSync/releases 下载 windows 最新免安装版，例如：MDrvie-SelfContained-x64.zip
b. 解压并执行 MDriveSync.Client.API.exe
c. 打开网站 http://localhost:8080/
d. 安装为系统服务（可选），右键文件以管理员身份运行 `一键安装或卸载*.bat`，选择安装或卸载服务。
在线预览
在线预览
账号：admin，密码：123456
截图
Docker 版
https://hub.docker.com/r/trueaiorg/mdrive
# 拉取镜像
docker pull trueaiorg/mdrive
# 快速启动并开启只读模式
docker run --name mdrive -d --restart=always \
-e BASIC_AUTH_USER=admin -e BASIC_AUTH_PASSWORD=123456 \
-e READ_ONLY=true \
-p 8080:8080 trueaiorg/mdrive
# 快速启动完整示例2，持久化、映射配置、只读、账号密码
# 如果需要，更改目录权限
sudo chmod -R 777 /home/mdrive/db
docker run --name mdrive -d --restart=always \
-v /home/mdrive/appsettings.json:/app/appsettings.json:rw \
-v /home/mdrive/db:/app/db:rw \
-e BASIC_AUTH_USER=admin -e BASIC_AUTH_PASSWORD=123456 \
-e READ_ONLY=true \
-p 18080:8080 trueaiorg/mdrive
# 确保目录存在
# 确保映射/挂载了备份目录
# 创建云盘存储目录
mkdir /home/mdrive
cd /home/mdirve
# 创建配置文件（可选）
vi appsettings.json
# 输入授权令牌，修改备份目录、作业计划时间、目标位置等
{
// ...
"Client": {
"AliyunDrives": [
{
"Id": "1",
"Name": "云盘",
"RefreshToken": "这里输入授权令牌",
"Jobs": [
{
"Id": "1",
"Name": "test",
"State": 0,
"Schedules": [
"0 * * * * ?"
],
"Sources": [
"/data"
],
"Target": "backups/test",
"RapidUpload": true,
"FileWatcher": true,
"IsTemporary": true
}
]
}
]
}
}
# 确保配置具有可写配置权限 appsettings.json
chmod 666 appsettings.json
# 快速启动示例，并挂载 /data 目录到容器 /data 只读模式，并映射端口 8080
docker run --name mdrive -d --restart=always \
-v /home/mdrive/appsettings.json:/app/appsettings.json:rw \
-v /data:/data:ro \
-e BASIC_AUTH_USER=admin -e BASIC_AUTH_PASSWORD=123456 \
-p 8080:8080 trueaiorg/mdrive
# 调试日志
docker logs mdrive
# 进入容器
docker exec -it mdrive /bin/bash
# 访问端口
http://{ip}:8080
# 更多示例
# 配置日志、映射云盘配置、映射程序配置、挂载 /data
mkdir /home/mdrive/logs
docker run --name mdrive -d --restart=always \
-v /home/mdrive/appsettings.json:/app/appsettings.json:rw \
-v /home/mdrive/logs:/app/logs \
-v /home/mdrive/db:/app/db \
-v /data:/data:ro \
-e BASIC_AUTH_USER=admin -e BASIC_AUTH_PASSWORD=123456 \
-p 8080:8080 trueaiorg/mdrive
Windows 服务版
下载 MDrive 并解压，修改授权、密钥等配置，运行 .exe 程序即可。
- 作为服务后台执行：
- 可使用系统自带的
任务计划程序，创建基本任务，选择.exe程序即可，请选择请勿启动多个实例，保证只有一个任务执行即可。 - 可使用其他服务集成，例如：nssm、winsw、iis等。
- 可使用系统自带的
友情链接
- 阿里云盘小白羊网盘 https://github.com/gaozhangmin/aliyunpan
- 阿里云盘小白羊版(暂停维护) https://github.com/liupan1890/aliyunpan
- 阿里云盘命令行客户端 https://github.com/tickstep/aliyunpan
管理后台配置
- 只读模式：WebUI 下如果开启只读模式，则允许编辑和修改，只能查看，默认
ReadOnly: false。使用方式，可以通过修改appsettings.json或 docker 使用环境变量-e READ_ONLY=true。 - 基础认证：WebUI 账号和密码，如果开启则打开网站管理后台时需要输入账号和密码，默认启用
BasicAuth。使用方式，可以通过修改appsettings.json或 docker 使用环境变量-e BASIC_AUTH_USER=admin -e BASIC_AUTH_PASSWORD=123456。
系统配置
默认
appsettings.json配置
{
"ReadOnly": null,
"BasicAuth": {
"User": "",
"Password": ""
},
"Client": {
"AliyunDrives": [
]
},
"Serilog": {
"MinimumLevel": {
"Default": "Information",
"Override": {
"Default": "Warning",
"System": "Warning",
"Microsoft": "Warning"
}
},
"WriteTo": [
{
"Name": "File",
"Args": {
"path": "logs/log.txt",
"rollingInterval": "Day",
"fileSizeLimitBytes": null,
"rollOnFileSizeLimit": false,
"retainedFileCountLimit": 31
}
}
//{
// "Name": "Console"
//}
]
},
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*",
"urls": "http://*:8080"
}
默认
Client配置（可选，默认无需配置）
RefreshToken为必填项，其他不用填写。点击获取授权令牌，或登录官网获取授权令牌。Jobs可以配置多个作业，计划中的作业时间可以可以配置多个时间点。Sources备份源目录列表，可以配置多个备份源，必填Target云盘存储目录，必填Schedules定时计划，可配置多个计划时间IsTemporary是否为临时任务或一次性的同步任务，也表示是否立即执行，如果为true，则启动时立即执行作业State作业状态，例如：100 表示暂停，0 表示未开始Mode同步模式，0 镜像同步（以本地为主，远程为镜像，删除不一致冗余的远程文件），1 冗余同步（同步到远程，不删除远程文件），2 双向同步（远程与本地如果有冲突则进行重命名）
{
"Client": { // 客户端备份/同步配置
"AliyunDrives": [ // 阿里云盘配置
{
"Name": "云盘1", // 云盘名称
"TokenType": "Bearer", // 令牌类型，这里是Bearer类型
"AccessToken": "your_access_token", // 访问令牌，用于API访问
"RefreshToken": "your_refresh_token", // 【必填】刷新令牌，用于获取新的访问令牌
"ExpiresIn": 7200, // 令牌过期时间，单位为秒
"Metadata": "", // 阿里云盘元信息，如用户信息、云盘信息、VIP信息等
"Jobs": [ // 作业列表
{
"Id": "1", // 任务 ID
"Name": "gpkopia", // 任务/作业名称
"Description": "", // 作业描述
"State": 0, // 作业状态，例如：100 表示暂停，0 表示未开始
"Mode": 0, // 同步模式，0 镜像同步，1 冗余同步，2 双向同步（如果有冲突则重命名）
"Schedules": [ // 【必填】定时计划，使用cron表达式定义
"0 0/10 * * * ?"
],
"Filters": [ // 文件过滤列表
"**/logs/*"
],
"Sources": [ // 【必填】源目录列表
"E:\\kopia"
],
"Target": "backups/gp", // 【必填】目标存储目录
"Restore": "E:\\kopia_restore", // 还原目录
"RapidUpload": true, // 是否启用秒传功能
"DefaultDrive": "backup", // 默认备份的云盘类型，备份盘或资源盘
"CheckAlgorithm": "sha256", // 文件对比检查算法
"CheckLevel": 1, // 文件差异算法检查级别
"FileWatcher": true, // 是否启用文件系统监听
"Order": 0, // 任务显示顺序
"IsTemporary": false, // 是否为临时任务，是否立即执行
"IsRecycleBin": false, // 是否启用删除到回收站
"UploadThread": 0, // 上传并行任务数
"DownloadThread": 0, // 下载并行任务数
"Metadata": "" // 作业元信息
},
// 更多作业配置...
]
}
]
}
}
# 管理后台账号密码
# 可以通过配置，直接修改管理后台账号密码。在 docker 启动时，也可以通过环境变量设置。
{
"BasicAuth": {
"User": "admin",
"Password": "123456"
}
}
Schedules作业计划任务示例
// cron 表达式 基于 Quartz 3.8.0
// https://www.bejson.com/othertools/cron/
// 每 5 秒
0/5 * * * * ?
// 每分钟
0 * * * * ?
// 每 5 分钟
0 0/5 * * * ?
// 每 10 分钟
0 0/10 * * * ?
// 每天 9 点
0 0 9 * * ?
// 每天 8 点 10 分
0 10 8 * * ?
Filters过滤文件/文件夹示例
# 忽略文件示例
# 忽略 `.exe` 结尾的所有文件
*.duplicatidownload
*.exe
# 忽略根目录示例，以 `/` 开头表示当前备份/同步的根目录
# 忽略当前备份/同步的根目录 `/Recovery/` 下的文件夹和文件
/Recovery/*
/Recovery/
/System Volume Information/
/System Volume Information/*
/Boot/
/Boot/*
/$RECYCLE.BIN/*
/$RECYCLE.BIN/
/bootmgr
/bootTel.dat
/@Recycle/*
/@Recently-Snapshot/*
/@Recycle/
/@Recently-Snapshot/
# 忽略根目录和子目录示例
# 忽略当前备份/同步的目录下 `/.next/` 目录以及子目录下的所有文件夹和文件
**/@Recycle/*
**/@Recently-Snapshot/*
**/.@__thumb/*
**/@Transcode/*
**/.obsidian/*
**/.git/*
**/.svn/*
**/node_modules/*
**/bin/Debug/*
**/bin/Release/*
**/logs/*
**/obj/*
**/packages/*
**/.next/*
注意
注意系统日志路径配置，不同操作系统之间的差异。
# window
"path": "logs\\log.txt"
# linux
"path": "logs/log.txt"
路线图
- [2.x 紧急 🆘] 增加还原计划，还原到本地，选择文件/文件夹还原
- [2.x 紧急 🆘] 分块上传、分块下载、超大文件支持
- [3.x] 多版本、快照、加密
- [3.x] Kopia 模式、插件开发
- [3.x] 百度云盘集成、本地模式集成、阿里云 OSS、腾讯云 COS 等
- [3.x] 加密、分块插件等
- [3.x] 上传增加文件的本地时间
- [3.x] WebDAV 支持
- [3.x] 多版本、多备份、版本还原
- [3.x] 配置加密、作业加密
- [3.x] 支持自定义文件后缀。避免被任何文件分析。
- [3.x] 支持多个备份点，避免快照数据损坏（待定），支持多重备份点。
- [3.x] 还原时恢复原始权限和时间
[验证] 空文件、空文件夹也同步[验证] 快捷方式支持同步，注意可能存在兼容性问题- [修复] 指向同一目标 bug -> https://github.com/trueai-org/MDriveSync/issues/3
- [优化] 优化挂载读写性能
- [优化] 优化磁盘挂载支持秒传
- [新增] 增加 linux/unix/mac 磁盘挂载支持
- [优化] 增加一键安装为 windows 服务的脚本、或作业计划的脚本。
- [BUG] 多个源文件夹名称一致校验
- [优化] 关于 MDrive 4 小时链接下载问题优化
- Duplicati 版（自动加密）
- Kopia 版（自动加密）
- 提供 Mac 版
- 手机版（Andorid 版、Ios 版）
- 百度网盘模块
- Duplicati、Kopia 等多种模块
客户端路线图
- App 启动时，通过接口获取欢迎语，检查版本等
- App 增加下次作业时间
- App 增加公告
- App 增加上次执行结果
- Mac 版本、移动端打包、Windows 安装包、WPF 安装包
- 锁定模式，超时多少时间自动退出登录
- Windows 客户端 UI/WPF 版本
发布
通过 Github Actions 自动或生成到 Docker Hub、Window 安装包等，保证程序的安全。
性能
- 极致，待完善，仅供参考。
大小 29.7 GB, 1,467 个文件，3,640 个文件夹
首次同步：0.8秒 + 8秒（列表加载用时 9 秒）
[11:14:01 INF] Current: E:\***\publish
[11:14:01 INF] 开始例行检查
[11:14:01 INF] 作业初始化
[11:14:01 INF] Linux: False
[11:14:02 INF] 作业初始化完成，用时：1347ms
[11:14:02 INF] 作业启动中
[11:14:02 INF] 作业启动完成，用时：0ms
[11:14:02 INF] 例行检查完成
[11:14:02 INF] 同步作业开始：12/27/2023 11:14:02
[11:14:02 INF] 云盘存储根目录初始化完成，用时：194ms
[11:14:02 INF] 开始加载云盘存储文件列表
[11:14:12 INF] 云盘文件加载完成，包含 1467 个文件，3643 个文件夹。
[11:14:12 INF] 加载云盘存储文件列表完成，用时：9835ms
[11:14:12 INF] 开始执行同步
[11:14:13 INF] 扫描本地文件，总文件数：1467, 扫描文件用时: 385.6735ms
[11:14:13 INF] 同步文件夹中 4/3641，用时：1.7352ms，kopia/p6c/f66
[11:14:13 INF] 同步文件夹中 4/3641，用时：1.7352ms，kopia/xn5/_7b
[11:14:13 INF] 同步文件夹中 4/3641，用时：1.7354ms，kopia/p37/786
[11:14:13 INF] 同步文件夹中 1/3641，用时：1.7347ms，kopia/sc4/0e5
[11:14:13 INF] 同步文件夹中 5/3641，用时：1.9816ms，kopia/p8a/507
...
[11:14:13 INF] 同步文件夹中 3639/3641，用时：796.4739ms，kopia/p8a/032
[11:14:13 INF] 同步文件夹中 3640/3641，用时：796.6586ms，kopia/p03/79f
[11:14:13 INF] 同步文件夹中 3641/3641，用时：796.847ms，kopia/pd7/198
[11:14:13 INF] 同步文件夹完成，总文件夹数：1467，用时：798.2616ms
[11:14:13 INF] 同步文件中 1/1467，用时：43.6954ms，kopia/p9e/80a/bd40cee2b0538167b1ac0cfe3f3-s9a17ce26b1838062122.f
[11:14:13 INF] 同步文件中 2/1467，用时：46.7248ms，kopia/p32/927/8072e241b284b964dc4c243be92-s92bdc8b6bce76e0d123.f
[11:14:13 INF] 同步文件中 3/1467，用时：50.1298ms，kopia/p2b/e06/9d189daea0fd575d1d3af92f095-sddec03db03d4ace5122.f
...
[11:14:30 INF] 同步文件中 1466/1467，用时：17060.3177ms，kopia/pbf/0fb/8035432aee39f4ed142d17b7cca-s9a17ce26b1838062122.f
[11:14:30 INF] 同步文件中 1467/1467，用时：17063.5177ms，kopia/p65/ef2/046536ebd68a2b0ec57a3f733ff-s9a17ce26b1838062122.f
[11:14:30 INF] 同步文件完成，总文件数：1467，用时：17063.8004ms
[11:14:30 INF] 同步作业完成，用时：18250ms
[11:14:30 INF] 同步作业结束：12/27/2023 11:14:30
[11:14:31 INF] 同步作业校验完成，用时：2ms
第二次同步：总用时 2 秒（列表加载用时 10 秒）
[11:19:01 INF] 开始例行检查
[11:19:01 INF] 例行检查完成
[11:20:00 INF] 同步作业开始：12/27/2023 11:20:00
[11:20:00 INF] 云盘存储根目录初始化完成，用时：367ms
[11:20:00 INF] 开始加载云盘存储文件列表
[11:20:01 INF] 开始例行检查
[11:20:01 INF] 例行检查完成
[11:20:10 INF] 云盘文件加载完成，包含 1467 个文件，3643 个文件夹。
[11:20:10 INF] 加载云盘存储文件列表完成，用时：10047ms
[11:20:10 INF] 开始执行同步
[11:20:10 INF] 扫描本地文件，总文件数：1467, 扫描文件用时: 322.6471ms
[11:20:10 INF] 同步文件夹中 2/3641，用时：0.0552ms，kopia/p6c/f66
...
[11:20:12 INF] 同步文件夹完成，总文件夹数：1467，用时：1450.7582ms
...
[11:20:12 INF] 同步文件中 1466/1467，用时：519.4365ms，kopia/p65/ef2/046536ebd68a2b0ec57a3f733ff-s9a17ce26b1838062122.f
[11:20:12 INF] 同步文件中 1467/1467，用时：519.6538ms，kopia/qd1/275/b7e487081d0ed47ea0638caa116-s3e0aeff9c8243770123.f
[11:20:12 INF] 同步文件完成，总文件数：1467，用时：520.4528ms
[11:20:12 INF] 同步作业完成，用时：2295ms
[11:20:12 INF] 同步作业结束：12/27/2023 11:20:12
[11:20:12 INF] 同步作业校验完成，用时：1ms
鸣谢
- 阿里云盘共创团。
- 感谢 Duplicati 对本产品初期的支持。
- MDrive 向阿里云产品申请了新的产品线，MDrive 将独立运行，不再依赖 Duplicati。
- WinSW 系统服务，将本程序安装作为 Windows 服务运行。
赞助
- 推广返现
- 购买阿里云盘会员返现
- 感谢所有的贡献者
- 如果您觉得本项目对您有帮助，欢迎收藏点赞，也可通过扫码购买会员，对作者提供支持！
限时推广返现，APP 扫码购买会员
👍👍阿里云盘推广返现，8T云盘低至6元/月，点击购买会员支持作者，最高30%返现🌸🌸
微信返现客服
tab-ai
贡献者
感谢以下所有的贡献者！
示例
appsettings.json示例配置，如果您通过Docker或简单使用则无需关心此配置。
{
// 网站配置为只读模式
"ReadOnly": null,
// 网站登录授权账号密码
"BasicAuth": {
"User": "",
"Password": ""
},
"Client": {
// 阿里云盘默认启动时加载的配置项（可选）
"AliyunDrives": [
{
"Id": "1",
"Name": "云盘1",
"TokenType": "Bearer",
"AccessToken": "",
"RefreshToken": "【1】这里输入授权令牌",
"ExpiresIn": 7200,
"Jobs": [
{
"Id": "1",
"Name": "test",
"Description": "",
"State": 0,
"Schedules": [
"【2】这里是备份计划时间，例如每分钟执行：0 * * * * ?"
],
"Filters": [
"/Recovery/",
"/System Volume Information/",
"/Boot/",
"/$RECYCLE.BIN/",
"/@Recycle/",
"/@Recently-Snapshot/",
"**/node_modules/**",
"*.duplicatidownload"
],
"Sources": [
"【3】这里输入备份的文件夹，可填写多个路径，注意：windows 路径，例如：E:\\test"
],
"Target": "【4】这里输入云盘备份目录，例如：backups/test",
"Restore": "E:\\kopia_restore",
"RapidUpload": true,
"DefaultDrive": "backup",
"CheckAlgorithm": "sha256",
"CheckLevel": 1,
"FileWatcher": true,
"Order": 0,
"IsTemporary": false,
"IsRecycleBin": false,
"UploadThread": 0,
"DownloadThread": 0
}
]
}
]
},
// 日志输出
"Serilog": {
"MinimumLevel": {
"Default": "Information",
"Override": {
"Default": "Warning",
"System": "Warning",
"Microsoft": "Warning"
}
},
"WriteTo": [
// 是否将日志输出到文件
{
"Name": "File",
"Args": {
"path": "logs/log.txt",
"rollingInterval": "Day",
"fileSizeLimitBytes": null,
"rollOnFileSizeLimit": false,
"retainedFileCountLimit": 31
}
},
// 是否将日志输出到控制台
{
"Name": "Console"
}
]
},
// 系统日志配置
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*",
"urls": "http://*:8080" // 默认程序启动的端口
}
Tag summary
Content type
Image
Digest
sha256:405c7c9d9…
Size
143.5 MB
Last updated
7 months ago
docker pull trueaiorg/mdrive