手把手教你搭建Alist

Shaw0xyz

Alist 是一个开源的文件列表程序，支持多种存储后端，包括本地文件系统、阿里云盘、OneDrive 等。它可以帮助用户方便地管理和分享文件。本文将详细介绍如何在 linux 环境下从零开始搭建 Alist，包括环境搭建、安装配置以及基本使用。


1. 环境准备

在开始之前，确保你的服务器或本地机器上安装了以下软件：

1. - Git
   
2. - Docker 和 Docker Compose

复制代码

1.1 安装 Git

如果你还没有安装 Git，可以按照以下步骤进行安装：

1.1.1 在 Ubuntu 上安装 Git

1. 
   
2. sudo apt update
   
3. sudo apt install -y git

复制代码

1.1.2 在 CentOS 上安装 Git

1. 
   
2. sudo yum install -y git

复制代码

1.1.3 在 macOS 上安装 Git

使用 Homebrew 安装 Git：

1. 
   
2. brew install git

复制代码

1.2 安装 Docker 和 Docker Compose

如果你还没有安装 Docker 和 Docker Compose，可以按照以下步骤进行安装：

1.2.1 在 Ubuntu 上安装 Docker

1. 
   
2. sudo apt update
   
3. sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
   
4. curl -fsSL <a href="https://download.docker.com/linux/ubuntu/gpg" target="_blank">https://download.docker.com/linux/ubuntu/gpg</a> | sudo apt-key add -
   
5. sudo add-apt-repository "deb [arch=amd64] <a href="https://download.docker.com/linux/ubuntu" target="_blank">https://download.docker.com/linux/ubuntu</a> $(lsb_release -cs) stable"
   
6. sudo apt update
   
7. sudo apt install -y docker-ce
   
8. sudo systemctl start docker
   
9. sudo systemctl enable docker
   

复制代码

1.2.2 在 Ubuntu 上安装 Docker Compose

1. 
   
2. sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   
3. sudo chmod +x /usr/local/bin/docker-compose
   
4. docker-compose --version

复制代码

1.2.3 在 CentOS 上安装 Docker

1. 
   
2. sudo yum install -y yum-utils
   
3. sudo yum-config-manager --add-repo <a href="https://download.docker.com/linux/centos/docker-ce.repo" target="_blank">https://download.docker.com/linux/centos/docker-ce.repo</a>
   
4. sudo yum install -y docker-ce docker-ce-cli containerd.io
   
5. sudo systemctl start docker
   
6. sudo systemctl enable docker

复制代码

1.2.4 在 CentOS 上安装 Docker Compose

1. 
   
2. sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   
3. sudo chmod +x /usr/local/bin/docker-compose
   
4. docker-compose --version

复制代码

2. 获取 Alist 源代码

使用 Git 克隆 Alist 的源代码：

1. 
   
2. git clone <a href="https://github.com/alist-org/alist.git" target="_blank">https://github.com/alist-org/alist.git</a>
   
3. cd alist

复制代码

3. 配置 Alist

在使用 Docker 运行 Alist 之前，我们需要进行一些基本的配置。

3.1 创建 Docker Compose 配置文件

在项目根目录下创建一个名为 `docker-compose.yml` 的文件，并添加以下内容：

1. 
   
2. version: '3'
   
3. services:
   
4.   alist:
   
5.     image: xhofe/alist:latest
   
6.     container_name: alist
   
7.     restart: always
   
8.     ports:
   
9.       - 5244:5244
   
10.     volumes:
    
11.       - ./data:/opt/alist/data
    

复制代码

该配置文件定义了一个名为 `alist` 的服务，将 Alist 容器的 5244 端口映射到主机的 5244 端口，并将数据目录挂载到主机的 `./data` 目录。

4. 运行 Alist

4.1 启动 Alist

在项目根目录下运行以下命令启动 Alist：

1. 
   
2. docker-compose up -d

复制代码

该命令将下载最新的 Alist 镜像，并在后台运行容器。

4.2 查看 Alist 运行状态

可以使用以下命令查看容器的运行状态：

1. 
   
2. docker-compose ps

复制代码

如果一切正常，你应该能看到 `alist` 容器正在运行。

5. 配置 Alist

5.1 访问 Alist 管理界面

打开浏览器，访问 `http://<你的服务器IP>:5244`，你将看到 Alist 的管理登录界面。默认管理员用户名和密码均为 `admin`。

5.2 修改管理员密码

首次登录后，建议立即修改管理员密码。进入管理界面后，点击右上角的头像图标，选择“修改密码”进行更改。

5.3 添加存储

在管理界面中，点击“存储管理”，选择“添加存储”。根据需要选择相应的存储类型（例如本地存储、阿里云盘、OneDrive 等），并填写相应的配置信息。

5.3.1 添加本地存储

选择“本地存储”，填写存储名称和路径。例如：

- 存储名称：local
- 存储路径：/mnt/local

点击“保存”完成配置。

5.3.2 添加阿里云盘

选择“阿里云盘”，填写存储名称和授权码。授权码可以通过 [AliyunDrive Auth](https://www.aliyundrive.com/) 获取。完成后点击“保存”。

6. 使用 Alist

6.1 访问文件列表

配置完成后，打开浏览器，访问 `http://<你的服务器IP>:5244`，你将看到 Alist 的文件列表界面。此时，你可以浏览和管理已配置的存储中的文件。

6.2 文件上传与下载

在文件列表界面中，可以通过界面上的按钮进行文件上传和下载操作。Alist 支持多文件上传、文件夹上传等功能。

6.3 分享文件

Alist 提供了文件分享功能。选择要分享的文件或文件夹，点击“分享”按钮，生成分享链接。你可以将链接发送给他人，实现文件共享。

7. 高级配置

7.1 配置 HTTPS

为了保证数据传输的安全性，建议配置 HTTPS。可以使用 Nginx 或 Caddy 等反向代理服务器为 Alist 提供 HTTPS 支持。

7.1.1 使用 Nginx 配置 HTTPS

首先，安装 Nginx 和 Certbot：

1. 
   
2. sudo apt install -y nginx certbot Python3-certbot-nginx

复制代码

然后，为你的域名获取 SSL 证书：

1. 
   
2. sudo certbot --nginx -d your-domain.com

复制代码

接下来，编辑 Nginx 配置文件 `/etc/nginx/sites-available/default`，添加反向代理配置：

1. 
   
2. 
   
3. server {
   
4.     listen 80;
   
5.     server_name your-domain.com;
   
6.     return 301 https://$host$request_uri;
   
7. }
   
8. 
   
9. server {
   
10.     listen 443 ssl;
    
11.     server_name your-domain.com;
    
12. 
    
13.     ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    
14.     ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
    
15. 
    
16.     location / {
    
17.         proxy_pass http://localhost:5244;
    
18.         proxy_set_header Host $host;
    
19.         proxy_set_header X-Real-IP $remote_addr;
    
20.         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    
21.         proxy_set_header X-Forwarded-Proto $scheme;
    
22.     }
    
23. }
    

复制代码

最后，重新加载 Nginx 配置：

1. 
   
2. sudo systemctl reload nginx
   

复制代码

现在，你可以通过 `https://your-domain.com` 安全地访问 Alist 了。

7.2 配置备份

为了防止数据丢失，建议定期备份 Alist 的数据目录。可以使用 rsync 或定时任务进行自动备份。

8. 总结

本文详细介绍了如何从零开始搭建 Alist，包括环境准备、安装配置、基本使用以及高级配置。通过本文的指导，你可以轻松地在 Linux 环境下搭建并使用 Alist，实现文件的管理与分享。希望本文对你有所帮助！