路径指定为 remote:path
路径可以根据需要尽可能深,例如remote:directory/subdirectory
。
要配置 WebDAV 遥控器,您需要有它的 URL,以及用户名和密码。如果您知道要连接的系统类型,那么 rclone 可以启用额外的功能。
这是一个如何制作遥控器的示例remote
。第一次运行:
rclone config
这将指导您完成交互式设置过程:
No remotes found - make a new one
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Webdav
\ "webdav"
[snip]
Storage> webdav
URL of http host to connect to
Choose a number from below, or type in your own value
1 / Connect to example.com
\ "https://example.com"
url> https://example.com/remote.php/webdav/
Name of the Webdav site/service/software you are using
Choose a number from below, or type in your own value
1 / Nextcloud
\ "nextcloud"
2 / Owncloud
\ "owncloud"
3 / Sharepoint Online, authenticated by Microsoft account.
\ "sharepoint"
4 / Sharepoint with NTLM authentication. Usually self-hosted or on-premises.
\ "sharepoint-ntlm"
5 / Other site/service or software
\ "other"
vendor> 1
User name
user> user
Password.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank
y/g/n> y
Enter the password:
password:
Confirm the password:
password:
Bearer token instead of user/pass (e.g. a Macaroon)
bearer_token>
Remote config
--------------------
[remote]
type = webdav
url = https://example.com/remote.php/webdav/
vendor = nextcloud
user = user
pass = *** ENCRYPTED ***
bearer_token =
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
配置完成后,您可以rclone
像这样使用,
列出 WebDAV 顶层的目录
rclone lsd remote:
列出 WebDAV 中的所有文件
rclone ls remote:
将本地目录复制到名为 backup 的 WebDAV 目录
rclone copy /home/source remote:backup
修改时间和哈希
普通 WebDAV 不支持修改时间。但是,当与 Owncloud 或 Nextcloud 一起使用时,rclone 将支持修改时间。
同样,普通的 WebDAV 不支持哈希,但是当与 Owncloud 或 Nextcloud 一起使用时,rclone 将支持 SHA1 和 MD5 哈希。根据 Owncloud 或 Nextcloud 的确切版本,哈希值可能出现在所有对象上,或者仅出现在上传了哈希值的对象上。
标准选项
以下是特定于 webdav (Webdav) 的标准选项。
–webdav-url
要连接的 http 主机的 URL
- 配置:网址
- 环境变量:RCLONE_WEBDAV_URL
- 类型:字符串
- 默认: ””
- 例子:
- “https://example.com”
- 连接到 example.com
- “https://example.com”
–webdav-供应商
您正在使用的 Webdav 站点/服务/软件的名称
- 配置:供应商
- 环境变量:RCLONE_WEBDAV_VENDOR
- 类型:字符串
- 默认: ””
- 例子:
- “下一个云”
- 下云
- “自己的云”
- 自己的云
- “共享点”
- Sharepoint Online,通过 Microsoft 帐户进行身份验证。
- “共享点-ntlm”
- 使用 NTLM 身份验证的 Sharepoint。通常是自托管或本地。
- “其他”
- 其他站点/服务或软件
- “下一个云”
–webdav-用户
用户名。如果使用 NTLM 身份验证,则用户名的格式应为“域\用户”。
- 配置:用户
- 环境变量:RCLONE_WEBDAV_USER
- 类型:字符串
- 默认: ””
–webdav-pass
密码。
注意对此的输入必须是模糊的 – 请参阅rclone 模糊。
- 配置:通过
- 环境变量:RCLONE_WEBDAV_PASS
- 类型:字符串
- 默认: ””
–webdav-bearer-token
不记名令牌而不是用户/通行证(例如蛋白杏仁饼干)
- 配置:bearer_token
- 环境变量:RCLONE_WEBDAV_BEARER_TOKEN
- 类型:字符串
- 默认: ””
高级选项
以下是特定于 webdav (Webdav) 的高级选项。
–webdav-bearer-token-command
运行以获取不记名令牌的命令
- 配置:bearer_token_command
- 环境变量:RCLONE_WEBDAV_BEARER_TOKEN_COMMAND
- 类型:字符串
- 默认: ””
–webdav-编码
这设置了后端的编码。
默认编码为 Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Hash,Percent,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8 for sharepoint-ntlm 或其他身份。
- 配置:编码
- 环境变量:RCLONE_WEBDAV_ENCODING
- 类型:字符串
- 默认: ””
–webdav-headers
为所有事务设置 HTTP 标头
使用它为所有事务设置额外的 HTTP 标头
输入格式是逗号分隔的键值对列表。可以使用标准 CSV 编码。
例如设置 Cookie 使用 ‘Cookie,name=value’ 或 ‘”Cookie”,”name=value”‘。
您可以设置多个标题,例如'”Cookie”、”name=value”、”Authorization”、”xxx”‘。
- 配置:标题
- 环境变量:RCLONE_WEBDAV_HEADERS
- 类型:逗号分隔列表
- 默认:
提供者说明
有关特定提供商的说明,请参见下文。
自己的云
单击页面右下角的设置齿轮,这将显示 rclone 在配置步骤中需要的 WebDAV URL。它看起来像https://example.com/remote.php/webdav/
.
Owncloud 支持使用X-OC-Mtime
标头修改时间。
下云
这与Owncloud 的配置方式相同。需要注意的是Nextcloud最初并不支持文件的流媒体(rcat
),而Owncloud做了,但是这似乎是固定的为2020年11月27日(含rclone v1.53.1和Nextcloud服务器V19测试)。
共享点在线
Rclone 可与 OneDrive for Business 或 Office365 教育帐户提供的 Sharepoint 一起使用。只有少数帐户需要此功能,主要是 Office365 教育帐户。这些帐户有时未经域所有者github#1975验证
这意味着无法使用官方 API 添加这些帐户(其他帐户应使用“onedrive”选项)。但是,可以使用 webdav 访问它们。
要在 rclone 中使用 sharepoint 遥控器,请按如下方式添加:首先,您需要获取遥控器的 URL:
- 转到此处 打开 OneDrive 或登录
- 现在看看你的地址栏,URL 应该是这样的:
https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/_layouts/15/onedrive.aspx
您只需要此 URL 直到电子邮件地址。之后,您很可能希望添加“/Documents”。该子目录包含存储在 OneDrive 上的实际数据。
远程添加到rclone这样的:配置url
为https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/Documents
与使用普通帐户的电子邮件和密码user
和pass
。如果您启用了 2FA,则必须生成应用密码。将 设置vendor
为sharepoint
。
您的配置文件应如下所示:
[sharepoint]
type = webdav
url = https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/Documents
vendor = sharepoint
user = YourEmailAddress
pass = encryptedpassword
使用 NTLM 身份验证的 Sharepoint
如果您的(托管)Sharepoint 未绑定到 OneDrive 帐户并使用 NTLM 身份验证,请使用此选项。
要获取url
配置,与上述类似,首先在浏览器中导航到所需目录以获取 URL,然后去除打开目录名称后的所有内容。
示例:如果 URL 是:https : //example.sharepoint.com/sites/12345/Documents/Forms/AllItems.aspx
要使用的配置是:https : //example.sharepoint.com/sites/12345/Documents
将 设置vendor
为sharepoint-ntlm
。
NTLM 使用域和用户名组合进行身份验证,设置user
为DOMAIN\username
.
您的配置文件应如下所示:
[sharepoint]
type = webdav
url = https://[YOUR-DOMAIN]/some-path-to/Documents
vendor = sharepoint-ntlm
user = DOMAIN\user
pass = encryptedpassword
SharePoint 所需的标志
由于 SharePoint 对上传的文档执行一些特殊操作,因此您将无法使用文档大小或文档哈希来比较自上传后文件是否已更改/哪个文件较新。
对于 Rclone 调用从/向 SharePoint 复制文件(尤其是 Office 文件,例如 .docx、.xlsx 等)(如复制、同步等),您应该附加这些标志以确保 Rclone 使用“上次修改”日期时间属性比较您的文件:
--ignore-size --ignore-checksum --update
缓存
dCache 是一种支持多种协议和身份验证/授权方案的存储系统。对于 WebDAV 客户端,它允许用户使用用户名和密码 (BASIC)、X.509、Kerberos 和各种不记名令牌(包括Macaroons 和OpenID-Connect 访问令牌)进行身份验证 。
使用other
类型正常配置。不要输入用户名或密码,而是输入您的 Macaroon 作为bearer_token
.
配置最终看起来像这样。
[dcache]
type = webdav
url = https://dcache...
vendor = other
user =
pass =
bearer_token = your-macaroon
有一个脚本可以从 dCache WebDAV 端点获取 Macaroon,并创建一个 rclone 配置文件。
杏仁饼也可以从 dCache 附带的 dCacheView 网络浏览器/JavaScript 客户端获得。
OpenID-连接
dCache 还支持使用 OpenID-Connect 访问令牌进行身份验证。OpenID-Connect 是一种协议(基于 OAuth 2.0),它允许服务识别已通过某些中央服务进行身份验证的用户。
rclone 中对 OpenID-Connect 的支持目前是使用另一个名为oidc-agent 的软件包实现的 。这是一个有助于获取访问令牌的命令行工具。安装和配置后,通过运行oidc-token
命令获取访问令牌 。以下示例显示了从XDC OIDC Provider获得的(缩短的)访问令牌。
paul@celebrimbor:~$ oidc-token XDC
eyJraWQ[...]QFXDt0
paul@celebrimbor:~$
注意在oidc-token
命令生效之前,刷新令牌必须加载到 oidc 代理中。这是通过oidc-add
命令(例如,oidc-add XDC
)完成的。这通常在每个登录会话中执行一次。oidc-agent 文档中提供了有关此内容以及如何向您的 OIDC 提供商注册 oidc-agent 的完整详细信息。
rclonebearer_token_command
配置选项用于从 oidc-agent 获取访问令牌。
配置为普通 WebDAV 端点,使用“其他”供应商,将用户名和密码留空。出现提示时,选择编辑高级配置并输入命令以获取不记名令牌(例如,oidc-agent XDC
)。
以下示例配置显示了一个 WebDAV 端点,该端点使用 oidc-agent 从XDC OIDC 提供程序提供访问令牌。
[dcache]
type = webdav
url = https://dcache.example.org/
vendor = other
bearer_token_command = oidc-token XDC