教你从零开始搭建 Alist 私人网盘教程，比 Nextcloud 更方便

时间：2025-04-19作者：皮皮分类：软件下载评论：0

近来看见一位博主自己搭建的Alist资源下载云盘挺实用的，特地研究了一番。经过了几次踩雷的过程以后，总算勉强上线，特此将折腾布署的过程和你们分享，希望可以给你们带来些许帮助，顺便我也可以做一份备忘笔记，以备后用。

Alist是哪些？为何值得一试？

Alist官方将其描述为”一个支持多种储存的文件列表程序”。但我认为，把它理解为一个强悍的<>在线云云盘更贴切。它的优势在那儿呢？

<>多种格式支持：可以即时浏览图片、视频、音频、PDF等多种文件格式。<>方便访问：简单设置后，无需登陆，旅客即可直接访问资源。<>功能丰富：不仅浏览，还包括下载等多种实用功能。<>高度可订制：支持自定义界面，可以构建专属于你的云盘风格。<>多平台支持：支持挂载多种云盘和储存服务，如本地储存、Drive、等。

<>假如你想先体验一下Alist的魅力，可以访问我搭建的在线示例：

假如认为里面搭建的Alist不错，自己也想自动搭建，这么请依照下边的步骤来进行，即可完成和我一样的疗效。

搭建Alist的打算工作

在开始之前，我们须要打算以下资源：

<>VPS服务器：推荐使用或系统，最低配置1核1G显存即可。（必需）<>域名：即使不是必需，但拥有一个域名可以让你的云盘更专业，访问更便捷。（可选）<>基本的Linux命令行知识：不须要很专业，但要能执行简单的命令。

Alist搭建步骤解读

1.<>安装

首先，我们须要在服务器上安装。为何选择？由于它可以让我们的布署过程显得更简单、更安全。使用以下命令安装：

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

安装完成后，可以运行--确认安装是否成功。

<>安装成功

2.<>创建Alist项目目录

接出来，我们须要为Alist创建一个专门的目录：

mkdir /var/docker/alist -p && cd /var/docker/alist

3.<>创建配置文件

在刚刚创建的目录中，我们须要创建一个-.yml文件：

nano docker-compose.yml

将以下内容粘贴到文件中：

services:
    alist:
        image: 'xhofe/alist:latest'
        container_name: alist
        volumes:
            - '/etc/alist:/opt/alist/data'
        ports:
            - '5244:5244'
        environment:
            - PUID=0
            - PGID=0
            - UMASK=022
        restart: unless-stopped

保存并退出（按Ctrl+X，之后按Y，最后按Enter）。

4.<>启动Alist

如今，我们可以启动Alist了：

docker compose up -d

使用ps命令查询是否运行成功；

5.<>访问Alist

打开浏览器，输入你的服务器IP:5244就可以看见Alist的界面了。

6.<>获取初始登陆密码

首次登陆须要密码，可以通过以下命令获取：

docker logs alist

在输出中找到“初始密码”那一行。默认用户名是admin。

7.<>登陆成功

Alist进阶配置

1.<>更改默认用户名和密码

为了安全起见，登陆后请立刻更改默认的用户名和密码。点击顶部的”管理”，之后在右边菜单中找到”用户”选项。

2.<>添加本地储存

Alist支持多种储存方法，这儿以添加本地储存为例，添加其它云盘储存的方式在Alist官方有很详细的描述，详尽的添加方式可以参考官方文档：

这儿有个须要注意的地方，挂载路径和根文件夹路径的填写，当年在我没仔细查看文档的情况下，这个地方总是填写不正确，后来找到一位博主的Alist的布署并挂载本地储存博客，才成功的解决了该问题。

这儿以首页仅仅添加一个视频的主文件夹为例：

首先，我们须要回到服务器，使用命令cd/etc/alist打开挂载的文件夹路径，使用命令mkdir视频新建一个视频的文件夹（不建议用英文），最后通过ls命令，查看视频文件夹是否创建成功。

之后回到添加本地储存的设置界面，这儿主要涉及到<>挂载路径和<>根文件夹路径的填写，

<>挂载路径填写

<>根文件夹路径填写

根据以上步骤填写完成后，即可在首页显示视频文件夹。

Alist上传文件

上传文件的方式也很简单，根据前面的步骤完成视频文件夹的创建后，我们打开主页点击视频文件夹，即可上传文件。

只须要将上传的内容拖动到下边的上传框中，即可完成文件的上传。

Alist界面美化

以上界面可能过分简单，适宜实用党。假如想要获得和在线体验网址：一样的界面，可以根据下边的步骤来操作。

回到后台主页，点击设置中的全局，这儿我们主要更改的地方为：<>自定义背部和自定义内容。通过更改这两个设置项，即可完成简单的美化工作。

将下述代码各自粘贴到设置项中，即可完成和体验网址一样的美化后的界面。

<>自定义背部

<>自定义内容

   
		
			
			    网盘资源使用说明
    
    仅用于个人分享文件，任何人可查看、下载，请勿滥用。
    
    
        警告：滥用一经发现，会立即封禁IP，永不解封。
    
    
    
        注意：国内部分地区可能因网络波动而出现速度缓慢或无法加载等情况，请耐心等待。
    
    
    如需密码，关注微信公众号："兔哥博客"，回复关键字获取。

		
        



        
            
                
                    
                        
                        
                        QQ |
                    
                
                
                    
                        
                        
                        邮箱 |
                    
                
                
                    
                        
                        
                        博客 |
                    
                
                
                    
                        
                        
                        留言 |
                    
                
                
                    
                        
                        
                        云盘 |
                    
                
                
                
                    
                        
                        
                        管理 |
                    
                
                
                
                    
                        
                        
                        Alist