Alist · 支持多存储的全能文件列表程序 · 基于 Gin 与 SolidJS 的自部署网盘聚合部署与使用全指南
项目仓库： https://github.com/AlistGo/alist
开源协议：AGPL-3.0 · 技术栈：Gin（Go）+ SolidJS · 文档：alistgo.com · Docker
镜像：xhofe/alist · 支持本地 / 阿里云盘 / OneDrive / Google
Drive / S3 / WebDAV 等数十种存储
1 项目简介
Alist 是一个支持多存储的文件列表程序，后端用 Gin（Go）、前端用 SolidJS 编写。它把本地磁盘、各种网盘（阿里云盘、OneDrive、Google Drive、115、夸克、蓝奏云等）、S3、WebDAV、FTP 等存储统一挂到一个 Web 界面里，提供文件预览、分享、WebDAV 访问与离线下载等能力。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | Alist |
| 仓库地址 | github.com/AlistGo/alist |
| 项目定位 | 多存储聚合的文件列表 / 网盘程序 |
| 开源协议 | AGPL-3.0 |
| 技术栈 | Gin（Go）、SolidJS |
| 文档 | alistgo.com |
| API 文档 | alist-public.apifox.cn |
| Docker 镜像 | xhofe/alist |
| Demo | al.nn.ci |
1.2 适用场景
- 把多个网盘 / 对象存储聚合到一个 Web 界面统一浏览与分享。
- 自建带预览（PDF / 视频 / 音频 / Office / Markdown）的文件站。
- 通过 WebDAV 把 Alist 挂载到支持 WebDAV 的客户端。
1.3 能力边界（官方口径 / 免责声明）
- 官方免责：本程序调用官方 SDK / 接口，不破坏官方接口行为；只做 302 跳转 / 流量转发，不拦截、不存储、不篡改用户数据。
- 使用前须自行承担账号封禁、限速等风险；使用中请遵守相关法律法规，勿滥用。
- Issues 仅用于 Bug 与功能请求，一般问题去 Discussion 论坛。
2 功能特性
- 多存储支持：本地存储、阿里云盘、OneDrive/SharePoint（全球/中国/德/美）、189云、Google Drive、123Pan、FTP/SFTP、PikPak、S3、Seafile、又拍云、WebDAV、Teambition、MediaFire、ProtonDrive、139云、YandexDisk、百度网盘、Terabox、UC、夸克、迅雷、蓝奏云、阿里分享、Google 相册、Mega、百度相册、SMB、115、Cloudreve、Dropbox、飞鸡盘、dogecloud、Azure Blob 等。
- 开箱即用：易部署、开箱即用。
- 文件预览：PDF、Markdown、代码、纯文本；画廊模式图片预览；视频音频预览（支持歌词与字幕）；Office 文档（docx/pptx/xlsx）预览；README.md 渲染。
- 分享与下载：文件永久链接复制、直接下载。
- 主题与多语言：暗色模式、i18n。
- 访问控制：路由密码保护与认证。
- WebDAV：可作为 WebDAV 服务（详见官方文档）。
- Docker 部署、Cloudflare Workers 代理。
- 打包下载：文件 / 文件夹打包下载。
- Web 上传：允许访客上传，删除、新建目录、重命名、移动、复制。
- 离线下载、跨存储复制、单线程下载 / 流多线程加速。
3 官方界面预览
Alist 前台为文件管理器风格界面：目录树、文件列表、预览面板；管理后台可挂载多个存储、设置账号与权限。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 官方文档 | https://alistgo.com/ | 安装、使用、WebDAV 文档 |
| 仓库主页 | https://github.com/AlistGo/alist | 源码、Releases |
| API 文档 | alist-public.apifox.cn | 开放 API |
| Demo | al.nn.ci | 在线演示 |
| Docker 镜像 | hub.docker.com/r/xhofe/alist | 容器镜像 |
| Discussion | github.com/AlistGo/alist/discussions | 一般问题 |
| Telegram | t.me/alist_chat | 交流群 |
| Discord | discord.gg/F4ymsH4xv2 | 交流群 |
5 前置要求与服务器配置
5.1 软件前提
- 任选：Docker（推荐）或单个 Go 二进制运行。
- 各网盘存储需要在对应平台开放授权（OAuth / Cookie / Token），按官方文档逐存储配置。
5.2 硬件建议
- 普通 VPS 即可；文件实际存储在各网盘 / 对象存储，本机主要做中转与索引。
5.3 端口与资源
- Web 服务默认端口 5244（按官方文档）；WebDAV 走 HTTP。
6 方式一：Docker 部署（推荐）
docker pull xhofe/alist
# 按官方文档启动并挂载数据目录7 方式二：Release 二进制运行
从 Releases 下载对应平台二进制，解压后运行；按官方文档初始化管理员密码并挂载存储。
8 配置项说明
- 存储挂载：管理后台添加各存储（本地 / 网盘 / S3 / WebDAV），填入对应授权信息。
- 访问控制：路由密码保护、账号与权限。
- WebDAV：按 alistgo.com/guide/webdav.html 配置。
9 常用运维命令
- 启动 / 重启容器：
docker compose up -d/restart - 查看日志：
docker logs alist - 重置管理密码：按官方文档提供的命令行方式。
10 常见故障排查
- 网盘挂载失败：核对授权是否过期、官方接口是否变更；以官方文档与 Discussion 为准。
- 预览不支持某格式：以官方文档列出的预览类型为准。
- 被网盘限流 / 封号风险：官方免责声明已提示，控制频率。
11 风险与合规说明
- 许可证：AGPL-3.0。
- 免责声明：官方明确本程序只做 302 跳转 / 流量转发，不存储篡改用户数据；账号封禁、限速等风险由使用者自行承担。
- 请遵守各网盘服务条款与相关法律法规，勿滥用；侵权请联系作者。
- 本文整理自官方 README，命令与配置以官方文档最新说明为准；不包含 star 数等动态数据。