企业官网建设流程全解析

AList部署教程：从安装到跑通的多存储文件管理完整指南

【免费下载链接】alist🗂️A file list/WebDAV program that supports multiple storages, powered by Gin and Solidjs. / 一个支持多存储的文件列表/WebDAV程序，使用 Gin 和 Solidjs。项目地址: https://gitcode.com/GitHub_Trending/al/alist

AList 是一款开源的多存储文件列表程序，用 Gin 和 Solidjs 写就，能把本地磁盘加上各大网盘装进同一个网页里统一浏览、预览和管理。跟着这份指南，你会在自己的电脑上从零把它跑起来，几分钟就能打开属于自己的文件中心，把散落在各处的文件归拢到一个入口。

🗂 文件散在五个网盘里，先给它一个统一入口

很多人的文件是这么分布的：照片在 A 网盘，工作文档在 B 网盘，视频躺在本地硬盘，代码备份又塞进了另一块云盘。每个平台一个 App、一个账号，找东西得来回切。

AList 的思路是把"入口"这件事抽出来：它本身不存文件，而是给这些存储各装一个驱动（Driver，可以理解成适配某个网盘的插件），再由一套网页把它们的目录树拼在一起。

你不需要把文件搬家，只是给它们一个共同的"门口"。这也是为什么它的 drivers/ 目录里躺着几十种网盘和本地、对象存储的实现——支持面越宽，你这个统一入口能管到的文件就越多。

⚙ 准备好环境，一条命令编译出程序

先确认电脑装过 Go（一种用于编译程序的编程语言），终端里能看到版本号即可，具体版本不挑。然后拿到源码并编译：

git clone https://gitcode.com/GitHub_Trending/al/alist cd alist && go build -o alist main.go

这条命令会克隆仓库，再编译出一个可直接运行的alist可执行文件。Windows 上产物是alist.exe，后面命令里对应的名字换成它就行。

对配置和硬件没有苛刻要求，常见电脑都跑得动：

🚀 首次启动，拿到你的管理后台

编译出来的文件就是全部程序，直接启动：

./alist server

首次运行会自动在当前目录生成一个data文件夹，里面装着config.json配置文件和data.db数据库，所有状态都存在这两处。

程序会自动创建一个管理员账号admin，并把初始密码打印到启动日志里（随机 8 位，也可以提前用环境变量ALIST_ADMIN_PASSWORD指定）。启动后打开浏览器访问http://localhost:5244，用admin加刚才那个密码登录，你就进入了 AList 的 Web 管理界面。

进去先做一件事：把默认密码改掉，避免裸奔。

📁 给 AList 加第一个存储源

登录后在"存储"页面就能添加源，选类型、填根目录，保存即生效。想直接看本地文件是最快的路径，对应的配置长这样：

{ "driver": "Local", "root": "/your/files/path" }

把root换成你机器上真实存在的目录，保存后回到首页，这个文件夹的内容就会出现在 AList 的目录树里。想接着接网盘，照同样的套路选对应驱动、按提示填密钥即可——原理都一样，只是填的参数不同。

添加完记得让改动生效：

./alist restart

🔧 三个高频卡点，一次说清

• 端口被占，起不来：现象是日志里报端口冲突。原因是有别的程序占用了5244，在config.json里改port字段，重启即可。
• 浏览器打不开页面：先确认进程还活着，再看防火墙有没有放行该端口，多数情况是防火墙拦了。
• 登录进不去：多半是密码没记对。初始密码在启动日志里，忘了就删掉data下的data.db重来，但会丢已有配置，谨慎操作。

➡ 跑通之后还能挖什么

本地源只是起点。把常用的网盘逐个挂上去，配合内置的文件预览、搜索，就能在手机上、电脑上用同一个地址管理全部文件；它同样支持 WebDAV 对外输出，方便接到别的工具里。

下一步就打开浏览器登录后台，把默认密码改掉并添加第一个本地存储源，让它真正开始替你归拢文件。

【免费下载链接】alist🗂️A file list/WebDAV program that supports multiple storages, powered by Gin and Solidjs. / 一个支持多存储的文件列表/WebDAV程序，使用 Gin 和 Solidjs。项目地址: https://gitcode.com/GitHub_Trending/al/alist