搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

AlistGo/alist

运维与部署

自建一个聚合多种存储的文件列表与 WebDAV 服务,用统一网页浏览、预览和下载各云端文件。

50,428
7,904
Go
AGPL-3.0
创建于 5 年前

项目介绍

AList 是一个自托管的文件列表与 WebDAV 服务,把多个存储来源的文件集中到一个网页界面里浏览和管理。它不搬移数据,而是调用各存储服务商提供的官方 SDK 或接口,把本地磁盘、OneDrive/SharePoint、Google Drive、S3、FTP/SFTP、WebDAV、SMB、Dropbox、Azure Blob Storage、ProtonDrive,以及阿里云盘、百度网盘、115、夸克、UC 等众多网盘统一到一个入口 (L44-L101)。

它适合文件分散在多个云账号或网络硬盘上的用户,希望用一个目录统一浏览、分享和下载。内置预览覆盖 PDF、Markdown、代码、纯文本、图片画廊、带字幕或歌词的视频音频,以及 Office 文档;密码保护路由、直链下载、打包下载、网页上传、重命名/移动/复制、离线下载等功能覆盖日常文件管理。

项目使用 Go 编写后端、SolidJS 构建前端,以 AGPL-3.0 许可证开源 LICENSE。流量处理很轻:只做 302 重定向或流式转发,不拦截、存储或篡改用户数据。

快速使用

使用 Docker 部署是最直接的入门方式,README 给出的运行命令如下:

docker run -d --restart=always \
  -v /etc/alist:/opt/alist/data \
  -p 5244:5244 \
  -e PUID=0 -e PGID=0 -e UMASK=022 \
  --name="alist" xhofe/alist:latest

容器启动后访问 http://<你的主机>:5244 进入网页界面。初始管理员密码由程序生成,可用以下命令输出:

docker exec -it alist ./alist admin random

在管理后台添加一个存储、填入对应服务商的凭据并挂载,文件就会出现在公开文件列表中,同时可通过生成的 WebDAV 地址访问。项目提供在线演示 演示站,安装说明见官方文档 文档。

使用约束

  • 需要为 /opt/alist/data 配置持久化存储,否则容器重建后配置数据库会丢失。
  • 需要能访问 5244 端口;对外公开服务前应先配置身份验证和受保护路由。
  • 每个存储后端都要用各自的凭据或令牌连接,部分服务商需要先开通 API 访问;OneDrive/SharePoint 在不便使用 API 时可通过 WebDAV 接入 WebDAV 说明。
  • 实际行为取决于服务商官方接口。账号被封、下载限速以及服务商侧接口变动不受项目控制,README 免责声明中也作出了说明。
  • 修改并再分发软件时需遵守 AGPL-3.0 许可证。

HotRepo 点评

AList 是一个使用规模很大的成熟项目:记录的快照中约有 5.04 万 Star 和 7900 Fork。HotRepo 唯一一条记录是 2026-11-08 的 Go 语言日榜,当天新增 11 Star、最好名次为第 12。这只是单次观察,不能当作增长趋势,但说明当时它处在 Go 语言日榜前列。它长期有用的核心原因是存储后端覆盖面广:多数同类工具只支持少数服务商,而 AList 把大量网盘当作统一接口下的一等挂载对象。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。