diff --git a/pages/guide/drivers/123_open.md b/pages/guide/drivers/123_open.md index 87dcd9624..68ed98c2e 100644 --- a/pages/guide/drivers/123_open.md +++ b/pages/guide/drivers/123_open.md @@ -242,9 +242,9 @@ flowchart TB subgraph ide1 [ ] a1 end - a1[302]:::someclass====|default|a2[user equipment] + a1[local proxy]:::someclass====|default|a2[user equipment] classDef someclass fill:#f96 - c1[local proxy]-.alternative.->a2[user equipment] + c1[302]-.alternative.->a2[user equipment] b1[Download proxy URL]-.alternative.->a2[user equipment] click a1 "../drivers/common.html#webdav-policy" click b1 "../drivers/common.html#webdav-policy" @@ -265,9 +265,9 @@ flowchart TB subgraph ide1 [ ] a1 end - a1[302]:::someclass====|默认|a2[用户设备] + a1[本机代理]:::someclass====|默认|a2[用户设备] classDef someclass fill:#f96 - c1[本机代理]-.备选.->a2[用户设备] + c1[302]-.备选.->a2[用户设备] b1[代理URL]-.备选.->a2[用户设备] click a1 "../drivers/common.html#webdav-策略" click b1 "../drivers/common.html#webdav-策略" diff --git a/pages/guide/drivers/baidu.md b/pages/guide/drivers/baidu.md index 394bc6cc1..3adf31c0d 100644 --- a/pages/guide/drivers/baidu.md +++ b/pages/guide/drivers/baidu.md @@ -124,45 +124,61 @@ flowchart TB All methods require you to [click here](https://api.oplist.org/) to obtain the refresh token. The **first method** requires developer permissions, while the **latter two** do not. -1. If you have Baidu Netdisk developer permissions, please select **"Baidu Netdisk Auth Login"**, and in the Baidu Netdisk developer app backend, set the callback URL to the one provided on the webpage. After clicking "Get Token," you will automatically receive a refresh token. You can then configure your own `client_id` and `client_secret` in OpenList. +1. If you have Baidu Netdisk developer permissions, please select **"Baidu Netdisk Auth Login"**, and in the Baidu Netdisk developer app backend, set the callback URL to the one provided on the webpage. After clicking "Get Token," you will automatically receive a refresh token. You can then configure your own `client_id` and `client_secret` in OpenList. + (Please note: If using Baidu Netdisk's API, ensure the “Use Online API” option is unchecked, otherwise it will prevent connection.) + ![](/img/drivers/baidu/dev_token.png) - Want to obtain developer permissions? Please follow the steps below to apply for developer permissions on Baidu Cloud Open Platform: + Want to obtain developer permissions? Please follow the steps below to apply for developer permissions on Baidu Cloud Open Platform: + (Please note that we do not advocate the abuse of Baidu Netdisk developer permissions. You need to bear the operational risks yourself.) 1. Please go to [Baidu Open Platform](https://pan.baidu.com/union). - ![](/img/drivers/baidu/dev_platform.png) + ![](/img/drivers/baidu/dev_platform.png) + 2. Log in to your Baidu account. - ![](/img/drivers/baidu/dev_platform_login.png){width=200px} + ![](/img/drivers/baidu/dev_platform_login.png){width=200px} + 3. Follow the steps to complete the developer certification (supplement account information, such as real-name authentication, email, etc.). - 4. After completion, the system will automatically redirect to the [Baidu Open Platform Console](https://pan.baidu.com/union/console/applist). + + 4. After completion, the system will automatically redirect to the [Baidu Open Platform Console](https://pan.baidu.com/union/console/applist). + If you cannot access the console, you may not have completed the certification. Please return to step one and try again. - ![](/img/drivers/baidu/dev_platform_console.png){width=600px} - 5. Create an application using the create button in the console. + ![](/img/drivers/baidu/dev_platform_console.png){width=600px} + + 5. Create an application using the create button in the console. + (Please note that individual developers can only create one application. If you have other uses for the application, please use methods two and three. Here we assume you don't have an application and are willing to create one for OpenList.) - ![](/img/drivers/baidu/dev_app_create_button.png){width=600px} + ![](/img/drivers/baidu/dev_app_create_button.png){width=600px} + 6. Select "Software" as the application category, and fill in the application name and description according to your preference. Please note that these three contents cannot be changed once set, so please think carefully before filling them out. - ![](/img/drivers/baidu/dev_app_create_panel.png){width=600px} - 7. After creation is complete, you'll return to the control panel. Click on the application name to enter the application details page. + ![](/img/drivers/baidu/dev_app_create_panel.png){width=600px} + + 7. After creation is complete, you'll return to the control panel. Click on the application name to enter the application details page. + (Please note that you don't need to apply for online review to use it normally.) - ![](/img/drivers/baidu/dev_app_console.png){width=200px} + ![](/img/drivers/baidu/dev_app_console.png){width=200px} + 8. Select Security Settings and fill in the application callback URL with the provided callback address and save. - ![](/img/drivers/baidu/dev_app_info.png){width=600px} + ![](/img/drivers/baidu/dev_app_info.png){width=600px} + + ``` + https://api.oplist.org/baiduyun/callback + ``` - ``` - https://api.oplist.org/baiduyun/callback - ``` + ![](/img/drivers/baidu/dev_app_settings_safety.png){width=600px} - ![](/img/drivers/baidu/dev_app_settings_safety.png){width=600px} 9. Return to the application details page and copy the necessary AppKey and SecretKey. + 10. Use the [OpenList Token Acquisition Tool](https://api.oplist.org/) to log in via Baidu Netdisk authentication and fill in the corresponding keys to obtain the token. + 11. Fill in the corresponding parameters and settings according to the image at the beginning of this method to start using it. 2. This method uses a built-in API call via our intermediary server to refresh the access token. It is already available online. Simply check the option to use the parameters provided by OpenList, click "Get Token," and you will receive a refresh token. In the storage configuration page of OpenList, enable the "Use Online API" option, and enter the refresh token to start using it. @@ -184,46 +200,61 @@ All methods require you to [click here](https://api.oplist.org/) to obtain the r 全部都要[点击这里](https://api.oplist.org/) 来获取刷新令牌。第一种需要开发者权限,后**两种**不需要。 -1. 如果你有百度网盘开发者权限,请选择“百度网盘 验证登录”,并在百度网盘开发者应用后台里填入配置回调地址为该网页提供的回调地址。点击获取token后即可自动获取刷新令牌,并在openlist中配置您自己的cilent_id和cilent_secret。 - (请注意如使用百度网盘的api,请务必确保OpenList存储设置中“使用在线API”选项为非勾选状态,否则会导致无法连接。) +1. 如果你有百度网盘开发者权限,请选择“百度网盘 验证登录”,并在百度网盘开发者应用后台里填入配置回调地址为该网页提供的回调地址。点击获取token后即可自动获取刷新令牌,并在openlist中配置您自己的cilent_id和cilent_secret。 + + (请注意如使用百度网盘的api,请务必确保OpenList存储设置中“使用在线API”选项为非勾选状态,否则会导致无法连接。) ![](/img/drivers/baidu/dev_token.png) - 想要获取开发者权限?请按下方操作访问百度云开放平台申请开发者权限 + 想要获取开发者权限?请按下方操作访问百度云开放平台申请开发者权限 + (请注意我们并不提倡滥用百度网盘的开发者权限,您需要自行承担操作风险) 1. 请前往[百度开放平台](https://pan.baidu.com/union)。 - ![](/img/drivers/baidu/dev_platform.png) + ![](/img/drivers/baidu/dev_platform.png) + 2. 登录你的百度账号。 - ![](/img/drivers/baidu/dev_platform_login.png){width=200px} + ![](/img/drivers/baidu/dev_platform_login.png){width=200px} + 3. 按照步骤填写信息完成开发者认证。(补充账户信息,如实名,邮箱等。) + 4. 在完成后系统会自动跳转到[百度开放平台控制台](https://pan.baidu.com/union/console/applist)。 + 如果你无法访问控制台,可能是没有完成认证,请返回第一步重试。 - ![](/img/drivers/baidu/dev_platform_console.png){width=600px} - 5. 使用控制台的创建按钮创建一个应用。 + ![](/img/drivers/baidu/dev_platform_console.png){width=600px} + + 5. 使用控制台的创建按钮创建一个应用。 + (请注意个人开发者只能创建一个应用,如您对应用有其他使用,请使用第二和三方法,此处默认您没有应用且愿意为openlist创建应用。) - ![](/img/drivers/baidu/dev_app_create_button.png){width=600px} + ![](/img/drivers/baidu/dev_app_create_button.png){width=600px} + 6. 选择应用类别为”软件“,并按自己的想法填写应用名称和描述,请注意这三个内容一旦设定完成无法更改,请深思熟虑后填写。 - ![](/img/drivers/baidu/dev_app_create_panel.png){width=600px} - 7. 创建完成后将会回到控制面板,点击应用名称进入应用详情页。 + ![](/img/drivers/baidu/dev_app_create_panel.png){width=600px} + + 7. 创建完成后将会回到控制面板,点击应用名称进入应用详情页。 + (请注意您不需要申请上线审核就可以正常使用。) - ![](/img/drivers/baidu/dev_app_console.png){width=200px} + ![](/img/drivers/baidu/dev_app_console.png){width=200px} + 8. 选择安全设置,并填写应用回调地址为提供的回调地址并保存。 - ![](/img/drivers/baidu/dev_app_info.png){width=600px} + ![](/img/drivers/baidu/dev_app_info.png){width=600px} - ``` - https://api.oplist.org/baiduyun/callback - ``` + ``` + https://api.oplist.org/baiduyun/callback + ``` + + ![](/img/drivers/baidu/dev_app_settings_safety.png){width=600px} - ![](/img/drivers/baidu/dev_app_settings_safety.png){width=600px} 9. 回到应用详情页,复制必要的Appkey与Secretkey + 10. 使用[OpenList Token 获取工具](https://api.oplist.org/)通过百度网盘验证登录填写对应的Key,获取令牌。 + 11. 按照本方法开始处的图片填写对应的参数和设置即可使用。 2. 内置API调用的实现方式,利用我们建立的服务器中转刷新access_token,目前已经上线,勾选使用OpenList提供的参数,点击获取token即可获得刷新令牌。在OpenList的存储配置界面,打开使用online api选项,经刷新令牌填入即可使用。 @@ -552,9 +583,9 @@ flowchart TB subgraph ide1 [ ] a1 end - a1[302]:::someclass====|default|a2[user equipment] + a1[local proxy]:::someclass====|default|a2[user equipment] classDef someclass fill:#f96 - c1[local proxy]-.alternative.->a2[user equipment] + c1[302]-.alternative.->a2[user equipment] b1[Download proxy URL]-.alternative.->a2[user equipment] click a1 "../drivers/common.html#webdav-policy" click b1 "../drivers/common.html#webdav-policy" @@ -562,6 +593,7 @@ flowchart TB ``` ::: + ::: zh-CN ```mermaid @@ -574,9 +606,9 @@ flowchart TB subgraph ide1 [ ] a1 end - a1[302]:::someclass====|默认|a2[用户设备] + a1[本机代理]:::someclass====|默认|a2[用户设备] classDef someclass fill:#f96 - c1[本机代理]-.备选.->a2[用户设备] + c1[302]-.备选.->a2[用户设备] b1[代理URL]-.备选.->a2[用户设备] click a1 "../drivers/common.html#webdav-策略" click b1 "../drivers/common.html#webdav-策略" diff --git a/pages/guide/drivers/webdav.md b/pages/guide/drivers/webdav.md index 42e63de20..790c66fb0 100644 --- a/pages/guide/drivers/webdav.md +++ b/pages/guide/drivers/webdav.md @@ -55,6 +55,49 @@ The path of fodler you want to mount, same as join in address 要挂载的文件夹路径,与加入地址相同 ::: +## Tls insecure skip verify { lang="zh-CN" } + +## 跳过 SSL 证书验证 { lang="zh-CN" } + +::: en +Whether to skip SSL certificate verification. If your WebDAV server uses a self-signed certificate, you may need to enable this option. Enabling it will reduce security, please use it with caution. +::: +::: zh-CN +是否跳过 SSL 证书验证。如果你的 WebDAV 服务器使用自签名证书,可能需要启用此选项。启用后会降低安全性,请谨慎使用。 +::: + +## Support 302 redirect { lang="en" } + +## 支持 302 重定向 { lang="zh-CN" } + +::: zh-CN + +通常情况下,WebDAV 服务器会直接返回文件内容,由于需要授权,只能代理下载。但一些服务器会重定向到实际的文件地址,如 OpenList `WebDav 策略` 的 `302 重定向`。 + +WebDAV 存储设置的 `Web 代理` 选项默认为开启状态,如果关闭,OpenList 将会尝试获取重定向后的地址,然后将该地址返回给用户设备直接下载。 + +前提条件: + +1. WebDAV 服务器必须支持返回 302,如果返回 200,则无法使用此功能,关闭 Web 代理将无法使用。 +2. 返回的 302 地址必须是公开可访问的地址,不得需要授权信息,否则用户设备无法下载。 +3. 在存储设置中关闭 `Web 代理` 选项。 + +::: + +::: en + +In general, WebDAV servers return the file content directly. Due to the need for authorization, only proxy downloads are possible. However, some servers redirect to the actual file address, such as OpenList `WebDav Policy`'s `302 Redirect`. + +The `Web Proxy` option in WebDAV storage settings is enabled by default. If disabled, OpenList will attempt to obtain the redirected address and return it to the user device for direct download. + +Prerequisites: + +1. The WebDAV server must support returning 302; if it returns 200, this feature cannot be used, and disabling Web Proxy will make it unusable. +2. The returned 302 address must be publicly accessible and must not require authorization information; otherwise, the user device cannot download it. +3. Disable the `Web Proxy` option in the storage settings. + +::: + ## OneDrive/SharePoint { lang="zh-CN" } ## OneDrive/SharePoint { lang="en" } @@ -90,6 +133,10 @@ The username is the OneDrive account email, and the password is the OneDrive acc Another situation is that the corresponding OneDrive account has not been used for a long time, which will also prompt this problem. Try to log in to the account again from the OneDrive web page. The system will prompt you to change the password. After updating the password, try again with the changed password. +- **failed link: failed get link: redirect failed, status: 200** + + This error indicates that the WebDAV server does not support 302 redirects. You need to enable the `Web Proxy` option in the storage settings to use proxy downloads. + ::: ::: zh-CN @@ -103,6 +150,10 @@ The username is the OneDrive account email, and the password is the OneDrive acc 另外一种情况是对应的 OneDrive 账号太长时间没有操作也会提示这个问题,尝试从 OneDrive 网页端重新登录账号,系统会提示要求更改密码,更新密码后,使用更改后的密码再次尝试即可 +- **failed link: failed get link: redirect failed, status: 200** + + 此错误表示 WebDAV 服务器不支持 302 重定向,需要在存储设置中启用 `Web 代理` 选项以使用代理下载。 + ::: ## 默认使用的下载方式 { lang="zh-CN" } @@ -116,19 +167,22 @@ The username is the OneDrive account email, and the password is the OneDrive acc title: Which download method is used by default? --- flowchart TB - style c1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff + style a1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff style a2 fill:#ff7575,stroke:#333,stroke-width:4px subgraph ide1 [ ] - c1 + a1 end - c1[local proxy]:::someclass==default===>a2[user equipment] + a1[local proxy]:::someclass====|default|a2[user equipment] classDef someclass fill:#f96 + c1[302]-.alternative.->a2[user equipment] b1[Download proxy URL]-.alternative.->a2[user equipment] + click a1 "../drivers/common.html#webdav-policy" click b1 "../drivers/common.html#webdav-policy" click c1 "../drivers/common.html#webdav-policy" ``` ::: + ::: zh-CN ```mermaid @@ -136,14 +190,16 @@ flowchart TB title: 默认使用的哪种下载方式? --- flowchart TB - style c1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff + style a1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff style a2 fill:#ff7575,stroke:#333,stroke-width:4px subgraph ide1 [ ] - c1 + a1 end - c1[本机代理]:::someclass==默认===>a2[用户设备] + a1[本机代理]:::someclass====|默认|a2[用户设备] classDef someclass fill:#f96 + c1[302]-.备选.->a2[用户设备] b1[代理URL]-.备选.->a2[用户设备] + click a1 "../drivers/common.html#webdav-策略" click b1 "../drivers/common.html#webdav-策略" click c1 "../drivers/common.html#webdav-策略" ```