手把手教你搭建Alist
本帖最后由 Shaw0xyz 于 2024-5-22 13:20 编辑Alist 是一个开源的文件列表程序，支持多种存储后端，包括本地文件系统、阿里云盘、OneDrive 等。它可以帮助用户方便地管理和分享文件。本文将详细介绍如何在 Linux 环境下从零开始搭建 Alist，包括环境搭建、安装配置以及基本使用。
1. 环境准备
在开始之前，确保你的服务器或本地机器上安装了以下软件：
- Git
- Docker 和 Docker Compose
1.1 安装 Git
如果你还没有安装 Git，可以按照以下步骤进行安装：
1.1.1 在 Ubuntu 上安装 Git
sudo apt update
sudo apt install -y git
1.1.2 在 CentOS 上安装 Git
sudo yum install -y git
1.1.3 在 macOS 上安装 Git
使用 Homebrew 安装 Git：
brew install git
1.2 安装 Docker 和 Docker Compose
如果你还没有安装 Docker 和 Docker Compose，可以按照以下步骤进行安装：
1.2.1 在 Ubuntu 上安装 Docker
sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
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 -
sudo add-apt-repository "deb <a href="https://download.docker.com/linux/ubuntu" target="_blank">https://download.docker.com/linux/ubuntu</a> $(lsb_release -cs) stable"
sudo apt update
sudo apt install -y docker-ce
sudo systemctl start docker
sudo systemctl enable docker
1.2.2 在 Ubuntu 上安装 Docker Compose
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
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version
1.2.3 在 CentOS 上安装 Docker
sudo yum install -y yum-utils
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>
sudo yum install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker
1.2.4 在 CentOS 上安装 Docker Compose
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
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version
2. 获取 Alist 源代码
使用 Git 克隆 Alist 的源代码：
git clone <a href="https://github.com/alist-org/alist.git" target="_blank">https://github.com/alist-org/alist.git</a>
cd alist
3. 配置 Alist
在使用 Docker 运行 Alist 之前，我们需要进行一些基本的配置。
3.1 创建 Docker Compose 配置文件
在项目根目录下创建一个名为 `docker-compose.yml` 的文件，并添加以下内容：
version: '3'
services:
alist:
image: xhofe/alist:latest
container_name: alist
restart: always
ports:
- 5244:5244
volumes:
- ./data:/opt/alist/data
该配置文件定义了一个名为 `alist` 的服务，将 Alist 容器的 5244 端口映射到主机的 5244 端口，并将数据目录挂载到主机的 `./data` 目录。
4. 运行 Alist
4.1 启动 Alist
在项目根目录下运行以下命令启动 Alist：
docker-compose up -d
该命令将下载最新的 Alist 镜像，并在后台运行容器。
4.2 查看 Alist 运行状态
可以使用以下命令查看容器的运行状态：
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 添加阿里云盘
选择“阿里云盘”，填写存储名称和授权码。授权码可以通过 (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：
sudo apt install -y nginx certbot python3-certbot-nginx
然后，为你的域名获取 SSL 证书：
sudo certbot --nginx -d your-domain.com
接下来，编辑 Nginx 配置文件 `/etc/nginx/sites-available/default`，添加反向代理配置：
server {
listen 80;
server_name your-domain.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name your-domain.com;
ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
location / {
proxy_pass http://localhost:5244;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
最后，重新加载 Nginx 配置：
sudo systemctl reload nginx
现在，你可以通过 `https://your-domain.com` 安全地访问 Alist 了。
7.2 配置备份
为了防止数据丢失，建议定期备份 Alist 的数据目录。可以使用 rsync 或定时任务进行自动备份。
8. 总结
本文详细介绍了如何从零开始搭建 Alist，包括环境准备、安装配置、基本使用以及高级配置。通过本文的指导，你可以轻松地在 Linux 环境下搭建并使用 Alist，实现文件的管理与分享。希望本文对你有所帮助！
页:
[1]