自建网盘聚合文件站从部署到挂载的完整手册
关于本站：第三方整理的中文文档站，非官方页面；内容来自公开资料整理，功能与界面以官方最新版为准。
这份文档写给「手里有好几家网盘、还有一台吃灰的 NAS 或服务器，想把这些零散存储汇成一个自己的文件站」的人。围绕的核心工具是一款用 Go 语言写的开源文件列表程序：部署一次，把各家网盘和本机磁盘一起挂载进去，浏览器打开就是一个带搜索、可预览、能打包下载的文件门户；它还自带 WebDAV 和 S3 服务，能把聚合后的目录再输出给播放器、手机、电视盒子和 NAS 软件直接使用。
和「装完就点」的普通应用不同，这类程序的价值在部署、挂载、权限这三件套上。所以本站按「先认清它是什么 → 选一条路把程序装起来 → 把存储挂进来 → 在网页里用起来 → 输出给其他设备 → 加固与排错」这条主线展开，每个环节都拆成只讲一个功能点的小页面，按顺序读下去就能从零搭出一个完整可用的文件站。内容整理自官方文档与公开资料，功能细节可能随版本变化，以官方最新版为准。
产品档案速览
| 项目 | 情况 |
|---|---|
| 产品定位 | 支持多种存储的开源文件列表程序，浏览器即文件门户 |
| 技术形态 | 后端 Gin + 前端 Solidjs，单一可执行文件，AGPL-3.0 协议开源 |
| 默认端口 | 5244（网页与 WebDAV 同端口走 /dav 路径），S3 服务另开 5246 |
| 部署方式 | 一键脚本（Linux/Windows）、手动二进制、Docker、付费桌面版 |
| 支持存储 | 本机磁盘 + 阿里云盘、百度网盘、夸克网盘、OneDrive、Google Drive、天翼云盘、123 云盘、PikPak、S3、WebDAV、FTP 等数十种 |
| 对外服务 | WebDAV、S3 协议、FTP/SFTP、直链与打包下载 |
| 扩展能力 | 离线下载（Aria2、qBittorrent、115、PikPak 等）、搜索索引、目录合并、两步验证 |
版本号与功能边界以官方发布为准，本站仅作第三方整理。
结构导览
全站分七组，每组入口页如下：
- 认识 AList：先弄清它是什么、能挂哪些存储、开源版和桌面版差在哪。入口见自建文件站的程序定位与工作方式。
- 部署安装：一键脚本、手动二进制、Docker、桌面版四条路线，以及首次启动拿密码、开机自启、升级。入口见部署方式怎么选。
- 挂载存储：添加存储的通用流程、阿里云盘等热门网盘的令牌获取、302 与代理两种下载策略。入口见后台添加第一个存储。
- 日常使用：浏览预览、打包下载、上传复制、离线下载、搜索索引、目录合并。入口见在线预览视频与文档。
- 对外服务：把聚合目录交给 WebDAV 客户端、播放器与 S3 工具。入口见WebDAV 服务开启与权限。
- 安全权限：多用户权限、目录加密、两步验证、签名防盗链、防封号须知。入口见用元信息给目录加密。
- 疑难解答：按症状分组的排查手册，装不上、登不进、看不了、下不动都能对号入座。入口见安装启动类问题排查。