Skip to content

Commit ffb3ad4

Browse files
TwoOnefourTwoOnefour
committed
docs(teldrive): Add driver teldrive
1 parent 520de91 commit ffb3ad4

File tree

3 files changed

+182
-0
lines changed

3 files changed

+182
-0
lines changed

‎docs/.vuepress/public/img/drivers/teldrive/fetch_teldrive_cookie.png‎

80.6 KB
Loading

‎docs/guide/drivers/teldrive.md‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
# This is the title of the article
3+
title: teldrive
4+
# This is the icon of the page
5+
icon: iconfont icon-state
6+
# This control sidebar order
7+
order: 214
8+
# A page can have multiple categories
9+
category:
10+
- Guide
11+
# A page can have multiple tags
12+
tag:
13+
- Storage
14+
- Guide
15+
- "302"
16+
# this page is sticky in article list
17+
sticky: true
18+
# this page will appear in starred articles
19+
star: true
20+
---
21+
22+
# Teldrive
23+
24+
Teldrive is a telegram based cloud storage, which is maintained by telegram official team.
25+
26+
**features:**
27+
- No storage limit
28+
- no file size limit.
29+
- Bandwidth limited applied if your account is not subscribe Telegram Premium. Speed depends on the distance from teldrive service to your account datacenter location(DC1-DC5).
30+
31+
Official repository: [teldrive](https://github.com/tgdrive/teldrive)
32+
33+
Setup guide: [teldrive Installation](https://teldrive-docs.pages.dev/docs/getting-started/prerequisites)
34+
35+
## Parameters
36+
37+
### Address
38+
Your teldrive backend url without suffix dash.
39+
40+
Example: `https://teldrive.example.com`
41+
42+
### Authentication
43+
Only support `Cookie` authentication.
44+
45+
You can get cookie from your browser after login to teldrive web interface.
46+
47+
It should start with `access_token=xxx.xxx.xxx`, which is jwt token format style.
48+
49+
![fetch teldrive cookie](/img/drivers/teldrive/fetch_teldrive_cookie.png)
50+
51+
::: tip
52+
Only the string with access_token= is required.
53+
:::
54+
55+
### Chunk Size
56+
Upload chunk size in MiB.
57+
58+
Default is `10` (10MiB). You can set it to a smaller value if you have issues with large files.
59+
60+
if chunk size is bigger than file size, it will not split the file, and upload it as a whole with single thread.
61+
62+
### Concurrency
63+
Upload concurrency, default is `4`.
64+
65+
You should limit the concurrency with your machine actual memory, by calculating `chunk size * concurrency`.
66+
67+
## Download
68+
**Notice: If webdav 302 is enabled, it will create share file and public the download link with 1 hour expiration time.**
69+
70+
Otherwise, it will use the default local proxy by AlistGo.
71+
72+
## **The default download method used**
73+
74+
```mermaid
75+
---
76+
title: Which download method is used by default?
77+
---
78+
flowchart TB
79+
style a1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
80+
style a2 fill:#ff7575,stroke:#333,stroke-width:4px
81+
subgraph ide1 [ ]
82+
a1
83+
end
84+
a1[302]:::someclass====|default|a2[user equipment]
85+
classDef someclass fill:#f96
86+
c1[local proxy]-.alternative.->a2[user equipment]
87+
b1[Download proxy URL]-.alternative.->a2[user equipment]
88+
click a1 "../drivers/common.html#webdav-policy"
89+
click b1 "../drivers/common.html#webdav-policy"
90+
click c1 "../drivers/common.html#webdav-policy"
91+
```

‎docs/zh/guide/drivers/teldrive.md‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
# 这是文章标题
3+
title: teldrive
4+
# 这是页面的图标
5+
icon: iconfont icon-state
6+
# 控制侧边栏的顺序
7+
order: 214
8+
# 页面可以有多个分类
9+
category:
10+
- 指南
11+
# 页面可以有多个标签
12+
tag:
13+
- 存储
14+
- 指南
15+
- "302"
16+
# 该页面会在文章列表中置顶
17+
sticky: true
18+
# 该页面会出现在加星的文章中
19+
star: true
20+
---
21+
22+
# Teldrive
23+
24+
Teldrive 是一个基于 Telegram 的云存储服务，由 Telegram 官方团队维护。
25+
26+
**功能特点：**
27+
- 无限存储空间
28+
- 无文件大小限制
29+
- 如果未订阅 Telegram Premium，将受到带宽限制。速度取决于 Teldrive 服务与你账户的数据中心（DC1–DC5）之间的距离。
30+
31+
官方仓库：[teldrive](https://github.com/tgdrive/teldrive)
32+
33+
安装指南：[teldrive 安装教程](https://teldrive-docs.pages.dev/docs/getting-started/prerequisites)
34+
35+
## 参数说明
36+
37+
### 地址
38+
填写你的 teldrive 后端网址，不要包含后缀的短横线。
39+
例如：`https://teldrive.example.com`
40+
41+
### 认证
42+
仅支持 `Cookie` 方式认证。
43+
44+
你可以在登录 Teldrive 网页端后，通过浏览器获取 Cookie。
45+
46+
Cookie 应以 `access_token=` 开头，这是一个 JWT 格式的 Token。
47+
48+
![获取 teldrive cookie](/img/drivers/teldrive/fetch_teldrive_cookie.png)
49+
50+
::: tip
51+
只需要包含 `access_token=` 的那一串字符串。
52+
:::
53+
54+
### 分块大小
55+
上传时的分块大小，单位为 MiB。
56+
57+
默认值为 `10`（即 10MiB）。如果上传大文件出现问题，可以设置为更小的值。
58+
59+
如果分块大小大于文件本身大小，则不会进行分块，整个文件将通过单线程上传。
60+
61+
### 并发数量
62+
上传时的并发线程数，默认值为 `4`。
63+
64+
你应根据实际内存情况调整并发数，计算方式为：`分块大小 × 并发数`。
65+
66+
## 下载方式
67+
68+
**注意：如果启用了 WebDAV 302 重定向，将会生成共享文件链接，下载链接的有效期为 1 小时。**
69+
70+
否则，默认会使用 AlistGo 提供的本地代理方式。
71+
72+
## 默认使用的下载方式
73+
74+
```mermaid
75+
---
76+
title: 默认使用哪种下载方式？
77+
---
78+
flowchart TB
79+
style a1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
80+
style a2 fill:#ff7575,stroke:#333,stroke-width:4px
81+
subgraph ide1 [ ]
82+
a1
83+
end
84+
a1[302]:::someclass====|默认|a2[用户设备]
85+
classDef someclass fill:#f96
86+
c1[本地代理]-.可选.->a2[用户设备]
87+
b1[下载代理 URL]-.可选.->a2[用户设备]
88+
click a1 "../drivers/common.html#webdav-policy"
89+
click b1 "../drivers/common.html#webdav-policy"
90+
click c1 "../drivers/common.html#webdav-policy"
91+
```

0 commit comments

Comments
 (0)