5 分钟把所有网盘接入一个 WebDAV 地址：AList 新手完整指南-开发者社区

5 分钟把所有网盘接入一个 WebDAV 地址：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

如果你同时用着阿里云盘、OneDrive、百度网盘，文件却散落在各自 App 里——AList 就是为解决这件事而生的：它是一个开源的多存储文件列表与 WebDAV 程序，用 Gin 和 Solidjs 编写，把几十种网盘和本地磁盘装进同一个网址里，适合想把网盘接入播放器、NAS 或剪辑软件的新手和普通用户。

网盘文件太散，你到底在忙什么

最常见的场景：素材存着阿里云盘，同事文件在 OneDrive，下载站资源挂在本地硬盘，每次要用就得打开三个 App、登录三个账号、分别找文件。AList 的思路反过来——不让文件去找你，而是把这些存储全部"挂载"到一个入口，你在 AList 的网页里看到一棵合并的文件树，哪个源里的文件一目了然。

它和"网盘列表聚合器"类小工具的区别在于：AList 不只是一个展示页面，它还能对文件做真操作——上传、删除、重命名、移动、跨网盘复制、整目录打包下载。每个网盘驱动都是独立模块，存放在 drivers/ 目录下，项目目前维护着 90 多个驱动，从本地磁盘、S3、WebDAV 到各家网盘，甚至包括"分享链接"驱动（把别人的网盘分享页当成只读存储直接挂进来）。

为什么选 AList：三个别处没有的点

一是把网盘变成标准协议服务。AList 启动后不止提供网页，还会在默认端口 5244 上同时给出多套服务：网页端、WebDAV（路由前缀 /dav）、S3、SFTP、FTP。这意味着任何支持 WebDAV 或 S3 的软件——Jellyfin 这类媒体库、Obsidian 笔记、VS Code 远程、剪辑软件——都能像访问网络磁盘一样读写你的网盘，无需为每个软件写插件。相关入口逻辑集中在 server/router.go 和 server/webdav/ 目录，想核对配置行为时可以直接翻。

二是只做重定向，不搬运流量。播放网盘里的视频时，AList 走 302 跳转把浏览器直接指向网盘的真实下载地址，数据不经过 AList 服务器中转，带宽和稳定性基本等同于你直连网盘本身。

三是带离线下载和搜索。内置了对 aria2、qBittorrent、Transmission、迅雷、115、PikPak 等下载器的对接（见 internal/offline_download/all.go），还能选择 Bleve、Meilisearch 或纯数据库几种搜索引擎，让"在所有网盘里找某个文件"变成一次输入的事。

最快上手：两步跑起来

第一步，把代码克隆到本地：

git clone https://gitcode.com/GitHub_Trending/al/alist

第二步，在仓库目录里执行go run .（或go run . start）即可启动；嫌装 Go 环境麻烦的话，仓库里的 Dockerfile 和 docker-compose.yml 是官方给出的容器化方案，用 Docker 直接拉起一个 AList 镜像、把数据目录挂出来，是生产环境更省事的做法。

启动后浏览器打开http://127.0.0.1:5244（端口即 internal/conf/config.go 里的默认值），用初始管理员账号登录，界面就是一个带文件树的网页。

挂上第一个网盘：全程点点鼠标

登录后台后走"存储管理 → 添加"，选一个驱动类型，比如本地或阿里云盘，按表单填对应的账号凭据或访问令牌。填完点"测试"，AList 会立即替你验证凭据是否有效、能否读到文件——这一步能挡掉绝大多数"配了但用不了"的问题。保存后，这个网盘就出现在左侧目录树里，点击进去可以像操作本地文件夹一样浏览、预览（PDF、Office 文档、Markdown、图片画廊、视频音频都支持）。

之后每多一个网盘，就重复"添加 → 测试 → 保存"，两分钟一个，挂多少个都不影响已有目录。

让播放器直接播网盘里的片

这是新手拿到 AList 后最高频的用法：打开你的播放器（Emby、Jellyfin、Infuse、VidHub 一类的都支持 WebDAV），在服务器地址里填 AList 的 WebDAV 地址，即http://你的服务器:5244/dav，用户名密码用 AList 的账号。之后媒体库扫描到的就是"所有网盘 + 本地"的合集，播放时 AList 返回 302 重定向直连源站，速度取决于网盘本身。

注意一点：如果你的 AList 部署在公网上，建议先给 WebDAV 路由加上访问限制（后台"全局设置"里有密码保护和身份验证选项），再暴露地址，避免网盘目录被陌生人逛。

进阶玩法：跨网盘搬家、离线下载、给 AI 用

熟悉基础操作后，AList 有几个容易忽略的好东西：

跨存储复制/移动：把一个文件从阿里云盘拖到本地，或从 OneDrive 复制到夸克，AList 走"源站下载 → 目标站上传"帮你完成，适合定期归档。
离线下载：在后台接入 aria2 或 qBittorrent 后，能把磁力、BT 链直接下到网盘里，省掉本地硬盘当缓冲。
全量搜索：开启搜索引擎并同步索引后，一个关键词搜遍所有挂载的网盘。
MCP 服务：仓库提供了mcp子命令（cmd/mcp.go），以标准输入输出方式把文件列表、读取、上传等能力暴露给 Claude Desktop 这类 AI 助手，让模型直接帮你找网盘里的资料，属于比较新的玩法。