79 lines
2.3 KiB
Markdown
79 lines
2.3 KiB
Markdown
---
|
||
title: AList简介和使用
|
||
date: 2025-12-17
|
||
---
|
||
|
||
# 一、简介
|
||
  [AList](https://alistgo.com/zh/)是一个支持多种存储，支持网页浏览和 WebDAV 的文件列表程序，由 gin 和 Solidjs 驱动。
|
||
|
||
# 二、安装
|
||
## 2.1 Docker安装
|
||
```yml
|
||
services:
|
||
alist:
|
||
image: xhofe/alist:v3.41.0
|
||
container_name: alist
|
||
restart: unless-stopped
|
||
volumes:
|
||
- ./data:/opt/alist/data
|
||
- /srv:/srv
|
||
ports:
|
||
- "5244:5244"
|
||
environment:
|
||
- PUID=0
|
||
- PGID=0
|
||
```
|
||
|
||
  这里的srv为宿主机的系统服务数据目录，添加该映射，可以让Alist能够访问宿主机/srv目录下的本地文件。
|
||
|
||
# 三、挂载
|
||
## 3.1 挂载本地存储
|
||
  打开控制台，选择存储->添加->本地存储，设置挂载路径（自定义，如`/local`），选择根文件夹路径为`/srv`，点击添加。
|
||
  这里的`/srv`文件夹为`docker`里面的文件夹路径，一般只需要更改`docker compose`文件里面的`/srv:/srv`前面的`srv`路径为宿主机路径即可，后面的`/srv`路径不要更改。
|
||
  可以在宿主机的`/srv`目录中添加文件，查看AList的主页是否可以正确显示。
|
||
|
||
# 四、API
|
||
  在线调试地址：[Alist-Public](https://alist-public.apifox.cn/)
|
||
|
||
## 4.1 登录
|
||
```JavaScript
|
||
const username = ''
|
||
const password = ''
|
||
|
||
// 1. 登录获取token
|
||
const login = await axios.post(`${AListUrl}/api/auth/login`, {
|
||
username,
|
||
password
|
||
})
|
||
|
||
const token = login.data.data.token
|
||
```
|
||
|
||
## 4.2 上传文件
|
||
```JavaScript
|
||
const data = new FormData()
|
||
data.append('file', options.file)
|
||
|
||
const filePath = `${AListPath}/${options.file.name}`
|
||
|
||
await axios({
|
||
method: 'put',
|
||
url: `${AListUrl}/api/fs/form`,
|
||
headers: {
|
||
Authorization: token,
|
||
'File-Path': filePath
|
||
},
|
||
data
|
||
})
|
||
```
|
||
|
||
## 4.3 下载文件
|
||
  在AList的文件路径中加上前缀`/p/`。例如文件路径为`/local/Test/test.mp4`，则下载路径为`/p/local/Test/test.mp4`。
|
||
::: tip
|
||
以上为相对路径，使用时加上相应的ip和端口号。
|
||
:::
|
||
|
||
::: warning
|
||
如果出现无法访问的情况，需要在设置->全局里面，将`签名所有`关闭。
|
||
签名所有：Alist是否将为这个存储下的所有文件请求生成带签名的临时链接，如果开启则需要带上校验码签名，否则不需要。
|
||
::: |