AList 网盘聚合上手指南：从启动服务到接入第一个存储源

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 是一款支持多存储的文件列表 / WebDAV 程序，可将本地磁盘与各类云盘聚合到一个浏览器页面中，支持在线预览、上传和目录管理，也能以 WebDAV 协议接入桌面端。本文面向新手，按「启动服务、登录控制台、接入第一个存储源、验证访问」四步带你走通。

部署完成后你会得到哪些入口

AList 启动后，文件并不是散落在各处的链接，而是集中到几个固定入口：

• 浏览器列表页：打开服务地址即可浏览目录、在线预览 PDF / 图片 / 视频 / Office 文档，并执行上传、删除、重命名、移动、复制等操作。
• 独立挂载路径：每个接入的存储源都分配一个自己的网页路径（例如/files），多个网盘并列出现在同一棵目录树下。
• WebDAV 服务：服务内置 WebDAV 接口，可挂载到支持该协议的桌面客户端，把网盘当成本地文件夹使用。

先记住这几点：后面所有配置，目的就是把文件挂到这些入口上。

最短上手路径：启动 AList 服务

方式一：使用预编译版本

到项目的发布页面下载与操作系统匹配的压缩包，解压后在解压目录内执行：

./alist server

这条命令用于 Linux / macOS（Windows 对应alist.exe server），作用是启动 Web 服务。首次运行时会在当前目录自动生成data/目录，其中包含主配置文件config.json和数据库文件。成功标志：终端打印出 HTTP 监听地址（默认端口 5244），并输出管理员账号的初始密码，请把密码复制保存。

方式二：从源码编译

需要本机已安装 Go（用go version确认）。执行：

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

构建成功后目录中会生成可执行文件alist，之后启动方式与方式一完全相同。

如何进入 AList 控制台并登录管理员

在启动服务的同一台机器上，用浏览器打开http://localhost:5244；如果服务跑在另一台机器上，把 localhost 换成该机器 IP。

登录时注意两点：

• 管理员用户名固定为admin。
• 初始密码是首次启动时随机生成、并打印在终端日志中的（日志行提示 "initial password is"）。如果已经关掉终端看不到密码，可以删除data目录后重新初始化生成新密码；也可以在启动前通过环境变量ALIST_ADMIN_PASSWORD预先指定。

登录成功后，建议先在用户管理里改掉这个初始密码，再继续配置存储。

第一个存储源怎么配置

先接本地存储：它不需要任何账号凭证，是最快验证整条链路的方式。

操作路径（界面文案以实际版本为准）：

1. 控制台侧边栏进入「存储」，点击「添加存储」。
2. 存储类型选择Local（本地）。
3. 填写两个关键字段：
   • 根目录：服务器上真实存在的目录，如/srv/files；
   • Web 路径：该存储映射到网页上的路径，如/files。
4. 点击保存，回到主页刷新。

保存后，主页目录树中会出现/files这一项，它指向的就是你在根目录里放的文件。

怎么验证文件可以正常访问

验证只需做两件事：

• 在浏览器中进入刚才配置的挂载路径（如/files），能看到目录和文件列表即说明存储源生效。
• 双击一个图片、PDF 或文本文件，页面直接渲染出内容，说明在线预览可用。

如果之后要挂载到桌面客户端，可以在配置中开启 WebDAV 入口，再用任意 WebDAV 客户端挂载；WebDAV 的具体用法以仓库 README 和官方文档说明为准。

端口冲突与访问失败怎么排查

遇到问题时，按「先看现象、再查对应位置」的顺序来：

现象	先查什么
页面打不开、连接被拒绝	服务进程是否还在运行；日志里的监听端口是否仍为 5244
启动日志提示端口被占用	打开data/config.json，把 HTTP 端口改成未被占用的值后重启
主页看不到挂载路径	Web 路径是否以/开头填写；对应存储是否被禁用
进入挂载路径后提示存储错误	根目录路径是否存在、运行服务的账号是否有读取权限
本机正常、其他机器打不开	防火墙 / 安全组是否放行了该端口

端口和地址配置都在data/config.json中，改完后需要重启服务才生效。

下一步：扩展存储与常用命令

常用命令一览（Linux / macOS 示例，Windows 将./alist换成alist.exe）：

命令	作用
./alist version	查看当前版本号
./alist help	列出全部可用命令
./alist restart	重启服务

接下来可以做的事：

• 在「添加存储」的类型列表中选择其他网盘类型（如 OneDrive、阿里云盘等），流程与本地存储相同，只是多一步填写账号或凭证。
• 想确认当前版本支持哪些存储，查看仓库 README 的 Features 一节即可，drivers/目录中则是每种存储驱动的对应实现。
• 需要多用户、权限控制或 WebDAV 细节时，以仓库 README 和官方文档为准。

到这里，一个可浏览、可预览、可扩展的网盘聚合入口已经搭好。按上面的顺序接入下一个存储源，整个过程通常只需要几分钟。

【免费下载链接】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