Skip to content

Commit

Permalink
Docs: update (#350)
Browse files Browse the repository at this point in the history
  • Loading branch information
anwen-anyi committed May 26, 2024
1 parent 1303efa commit dfbb393
Show file tree
Hide file tree
Showing 37 changed files with 1,184 additions and 63 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/.vuepress/public/img/advanced/s3/s3drive.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion docs/guide/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ A file list program that supports multiple storage, and supports web browsing an
- [x] [YandexDisk](https://disk.yandex.com/)
- [x] [BaiduNetdisk](https://pan.baidu.com/) / [share](./drivers/baidu_share.md)
- [x] [Quark](https://pan.quark.cn/)
- [x] [Thunder](https://pan.xunlei.com)
- [x] [Thunder / X](https://pan.xunlei.com)
- [x] [Lanzou](https://www.lanzou.com/)[NewLanzou](https://www.ilanzou.com)
- [x] [Feiji Cloud](https://feijipan.com/)
- [x] [Aliyundrive share](https://www.alipan.com/)
Expand All @@ -71,6 +71,7 @@ A file list program that supports multiple storage, and supports web browsing an
- [x] [vtencent](https://app.v.tencent.com/)
- [x] [ChaoxingGroupCloud](../guide/drivers/chaoxing.md)
- [x] [Quqi Cloud](https://quqi.com)
- [x] [163 Music Drive](../guide/drivers/163music.md)

### Discussion

Expand Down
67 changes: 66 additions & 1 deletion docs/guide/advanced/alias.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,4 +174,69 @@ Test other:/test4/video/tv
This is because Windows is case-insensitive, video and Video will be considered as the same folder, you will not have this problem if you switch to Linux or Mac

> Aliases are not supported for load balancing for the time being (if it is supported later, the document will be modified here, if it is not modified, it is not yet supported)
> Aliases are not supported for load balancing for the time being (if it is supported later, the document will be modified here, if it is not modified, it is not yet supported)
<br/>



### **Proxy Range**

You need to enable `Web Proxy` or` Webdav Native Proxy` to take effect

- Currently only applicable to:`alias``139Yun``AList V3`
- Function Description:**https://github.com/alist-org/alist/pull/6496#issue-2309839607**

<br/>



### **Protect same name**

^>v3.34.0^Now alias supports the two operations of `Delete` and` Rename`,==By default, use==

File names like file names may appear in the alias. For folders with the same folder name, you cannot `Delete` or `Rename` when the `Protect same name` is opened.

-----

::: details Protect same name Use for example

We fill in the two folders of `a` and` b` to the alias options

```
a/ b/ alias
a/1.png b/1.png alias/1.png
a/2.mp3 b/2.mp3 alias/2.mp3
a/3.mp4 b/3.mp4 ----> alias/3.mp4
a/4.mkv b/4.mkv ----> alias/4.mkv
a/5.bin b/6.css alias/5.bin ---> According to the rule, aliases in directories listed earlier take precedence, and files with different names in separate folders are given priority.
alias/6.css
```

If we attempt to Rename or Delete a file named `1.png` while the `Protect same name` feature is enabled, the following message will be displayed in the top right corner:

<div style="color: red; display: flex; justify-content: center; align-items: center; border: 3px solid red;">
<ul style="list-style-type: none;">
<li><i class="fa-solid fa-circle-exclamation">&nbsp;</i><b>same-name files cannot be Rename</b></li><br/>
<li><i class="fa-solid fa-circle-exclamation">&nbsp;</i><b>same-name files cannot be Delete</b></li>
</ul>
</div>

If we turn off the options of `Protect Same Name`, change to` a/1.png` to `a/11.png` will become the following display

- 因为a/b两个文件夹都有一样的文件,`重命名``下载`一样优先下载填写时候靠前的文件夹,同理重名修改也是先修改靠前文件夹中的文件 ( Can't translate the meaning that can be understood)

```
a/ b/ alias
a/1.png b/1.png alias/11.png
a/2.mp3 b/2.mp3 alias/2.mp3
a/3.mp4 b/3.mp4 ----> alias/3.mp4
a/4.mkv b/4.mkv ----> alias/4.mkv
a/5.bin b/6.css alias/5.bin
alias/1.png ---> Because the b folder is in the rear, the file list display is relatively backward
alias/6.css
```

If you really do n’t understand, you can test it yourself and then install the production environment by yourself

:::
33 changes: 30 additions & 3 deletions docs/guide/advanced/s3.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,19 +72,46 @@ S3 Client - S3 Browser:[https://s3browser.com](https://s3browser.com/download.

<div class="vp-card-container">
<VPCard
v-for="i in 1"
title="S3 Browser - 便携版"
title="S3 Browser - Zip Package"
logo="/img/advanced/s3/s3_logo/s3browser.png"
desc=""
link="https://s3browser.com/download/s3browser-11-6-7.zip"
background="rgba(94, 239, 227, 0.15)"
/>
<VPCard
title="S3 Browser - 安装版"
title="S3 Browser - exe Install"
logo="/img/advanced/s3/s3_logo/s3browser.png"
desc=""
link="https://s3browser.com/download/s3browser-11-6-7.exe"
background="rgba(55, 124, 252, 0.15)"
/>
<VPCard
title="S3Drive"
desc="Support Android、iOS、Linux、MacOS、Desktop"
logo="/img/advanced/s3/s3_logo/s3drive.png"
link="https://s3drive.app"
background="rgba(94, 239, 227, 0.15)"
/>
<VPCard
title="Placeholder"
logo="/logo.svg"
desc="Placeholder"
link=""
background="rgba(0, 255, 185, 0.15)"
/>
</div>


::: tabs#s3

@tab s3browser

![](/img/advanced/s3/s3browser.png)

@tab S3Drive

![](/img/advanced/s3/s3drive.png)

:::

At present, I only know this S3 Client. If you know other S3 Client, you can recommend it and then add it.
23 changes: 18 additions & 5 deletions docs/guide/drivers/123.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,19 +27,32 @@ You can view the content of the tab below to view different mounting methods (in



:::: tabs#123
::::: tabs#123

@tab personal

::: warning
## **personal**

:::: tip

Free user 10G traffic download, unlimited upload, multi-IP sharing is prohibited

- Need to use `v3.31.0` version
- Need to use `v3.33.0` version

::: warning

```json
failed get objs: failed to list objs:当前账号存在安全风险,请使用短信验证码或者微信进行登录。
```

solution:

- This is because the 123 cloud disk officially prohibits the mounting on strange devices, If you are mounted locally, `or` Windows Server server mount `to open the 123 cloud disk web page to log in or modify a password once
- example:[#6105](https://github.com/alist-org/alist/discussions/6105#discussioncomment-8628361)[#6254](https://github.com/alist-org/alist/discussions/6254#discussioncomment-8884882)

:::

## **personal**
::::

https://www.123pan.com/

Expand Down Expand Up @@ -163,7 +176,7 @@ If you are not sure whether the directory ID is correct or not, there is a direc

![123](/img/drivers/123/123_fl_id.png)

::::
:::::

## **The default download method used**

Expand Down
10 changes: 10 additions & 0 deletions docs/guide/drivers/139.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,16 @@ Update the method of authentication, please get `Authorization` to fill in



## **Proxy Range**

You need to enable `Web Proxy` or` Webdav Native Proxy` to take effect

- Currently only applicable to:`alias``139Yun``AList V3`
- Function Description:**https://github.com/alist-org/alist/pull/6496#issue-2309839607**

<br/>



## **Type**

Expand Down
78 changes: 78 additions & 0 deletions docs/guide/drivers/163music.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
# This is the icon of the page
icon: iconfont icon-state
# This control sidebar order
order: 24
# A page can have multiple categories
category:
- Guide
# A page can have multiple tags
tag:
- Storage
- Guide
- "302"
# this page is sticky in article list
sticky: true
# this page will appear in starred articles
star: true
---

# 163 Music Drive

163 Music Drive can only upload music and other operations on the mobile phone, and the web page cannot operate

<br/>



## **cookie**

Open **https://music.163.com** and then open the F12 developer mode

Open a request at will, just carry the `Cookie` to find the following two parameters and fill in the AList` Cookie`

- **__csrf****MUSIC_U**

![](/img/drivers/163/163_cookie.png)

<br/>



## **Song Limit**

You can only get 200 songs by default. If you exceed you, you can modify this option

<br/>



### **Precautions**

1. If there are many list files, it is recommended to open pagination loading, otherwise it will not be loaded
2. Cloud space can only upload audio format files, and cannot upload other format files

<br/>



### **The default download method used**

```mermaid
---
title: Which download method is used by default?
---
flowchart TB
style a1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
style a2 fill:#ff7575,stroke:#333,stroke-width:4px
subgraph ide1 [ ]
a1
end
a1[302]:::someclass====|default|a2[user equipment]
classDef someclass fill:#f96
c1[local proxy]-.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"
```
23 changes: 21 additions & 2 deletions docs/guide/drivers/189.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,12 +30,12 @@ The web -side login has been replaced with sliding verification code, **no longe
### **username**
the phone number used to log in



### **password**

password for login

<br/>



### **Root folder ID**
Expand All @@ -45,6 +45,19 @@ The string at the end of the official website url, such as:
- https://cloud.189.cn/web/main/file/folder/71398114617385472 -> `71398114617385472`
![189](/img/drivers/189.png)

<br/>

### **Family transfer**

Give 189 cloud disk adds Personal's `Family Transfer option`, which is convenient for users without VIP, and a large number of family cloud spaces upload.

- Note: The old upload interface family cloud will still limit the upload quantity, so `Rapid upload` and ` Old Upload` will not take effect
- **https://github.com/alist-org/alist/pull/6288**



<br/>



## **Family Cloud**
Expand All @@ -55,6 +68,8 @@ Open https://h5.cloud.189.cn/main.html#/family, enter the folder you want to mou

![189](/img/drivers/189/189-1.png)

<br/>



### **AList fill in examples:**
Expand All @@ -71,12 +86,16 @@ Fill in the account^1^and password^2^,Then click one request in the request, jus

Video reference: **https://www.bilibili.com/video/BV16A4y197De**

<br/>



## **suggestion**

It is recommended to use the Tianyi cloud disk client first, [**Notes click to view.**](../../faq/howto.md#when-adding-tianyi-cloud-disk-client-storage-prompt-need-img-validate-code-verification-code)

<br/>



### **The default download method used**
Expand Down
17 changes: 15 additions & 2 deletions docs/guide/drivers/Alist V2 V3.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,10 @@ The AList path you want to mount has a meta information password set
- But the root directory `/` of the other party has no password set, but other individual folders such as Ali, Baidu, 123 have set passwords, so you can fill in these but only one password.
- If the passwords of the three folders mentioned above are set differently, then you can only enter the folder with this password in the one you fill in, and you will not be able to enter without this password. You should understand.

<br/>



## **Username**

`AList` user name (account) you want to mount
Expand All @@ -100,8 +104,6 @@ The AList path you want to mount has a meta information password set

The password corresponding to the `AList` username you want to mount



:::tip Kind tips

It looks very troublesome, but you can understand it after a little operation. The details are written for Xiaobai(The premise is that [**Allow Mount**](../../config/site.md#allow-mounted) is enabled on the other party)
Expand All @@ -124,6 +126,17 @@ It looks very troublesome, but you can understand it after a little operation. T

You don’t need to write, it will be automatically filled after filling in `Username & Password` and saving

<br/>



### **Proxy Range**

You need to enable `Web Proxy` or` Webdav Native Proxy` to take effect

- Currently only applicable to:`alias``139Yun``AList V3`
- Function Description:**https://github.com/alist-org/alist/pull/6496#issue-2309839607**



@tab V2
Expand Down
7 changes: 7 additions & 0 deletions docs/guide/drivers/Crypt.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,6 +186,13 @@ Note: `Alist Crypt` used `filename_encoding = base64` in default. If you want to

Since Alist does not consider any case-insensitive internally, you may encounter problems when remote storage is case-insensitive. e.g.: use alist local driver on Windows, then use Crypt on it.

<br/>



## **Precautions**

When starting alist, I found that the Crypt prompts errors because Crypt can not find the relevant path when starting, You can fill in the Crypt [order](common.md#order) to make Crypt start slowly

<br/>

Expand Down
Loading

0 comments on commit dfbb393

Please sign in to comment.