Alist 是一个功能强大的文件列表程序，它可以挂载多种网盘、对象存储、本地存储等，并通过统一的 Web 界面进行管理和访问。本文将围绕“怎么用 Alist”这一核心问题，为您详细解答相关的疑问，帮助您快速上手和充分利用 Alist 的功能，而不是泛泛而谈其概念或历史。
Alist 能为我做什么？（“是什么”的应用层面）
简单来说，Alist 能让你在一个网页界面里，同时看到并操作来自不同地方的文件。它不是帮你备份或同步文件，而是像一个“文件路由器”或“统一入口”，将各种独立的存储服务（比如你在阿里云盘、百度网盘、Google Drive、OneDrive 里的文件，甚至你服务器本地的硬盘空间）整合在一起。
具体来说，Alist 可以做以下事情：
- 统一文件浏览和管理： 在同一个浏览器窗口中查看所有挂载的存储内容，无需打开多个网盘客户端或网站。支持文件的在线预览（图片、文本、部分音视频）。
- 便捷的文件访问： 通过浏览器直接下载文件，支持断点续传。
- 多种存储支持： 它支持市面上绝大多数主流的云存储，包括但不限于：
- 国内：阿里云盘、百度网盘、夸克网盘、迅雷网盘、天翼云盘、移动云盘等。
- 国外：Google Drive、OneDrive、Dropbox、Mega、Box 等。
- 对象存储：S3 兼容存储（AWS S3, MinIO）、阿里云 OSS、腾讯云 COS、七牛云 Kodo 等。
- WebDAV：可以挂载支持 WebDAV 协议的设备或服务。
- 本地存储：直接挂载运行 Alist 的服务器本地文件夹。
- 其他：FTP、SFTP、PikPak、SMB 等。
- WebDAV 服务端： 将 Alist 变成一个 WebDAV 服务器，允许你通过 WebDAV 客户端（如电脑的文件管理器、手机的文件管理 App）直接像访问网络硬盘一样访问 Alist 中挂载的所有文件。
- 文件直链： 生成文件的直接下载链接，方便分享或用于其他应用。
- 用户及权限管理： 可以创建多个用户，并为不同的用户设置访问特定目录的权限。
- 在线播放： 部分驱动支持视频和音频文件的在线播放。
- 文件操作： 支持基本的复制、移动、重命名、删除等操作（具体取决于底层存储驱动是否支持）。
我为什么要用 Alist？（“为什么”的使用优势）
相比直接使用各个存储服务的官方客户端或网页，使用 Alist 的主要优势在于：
- 打破壁垒，集中管理： 无需频繁切换应用或网页，在一个地方就能看遍所有文件。
- 绕过客户端限制： 有些网盘客户端可能有下载限速、必须安装客户端才能下载等限制，通过 Alist 可以直接走 HTTP 下载，通常可以跑满带宽（取决于你的服务器和网盘服务商）。
- 方便分享和集成： 生成直链或通过 WebDAV 访问，方便与其他应用联动，比如将云盘挂载到本地电脑或服务器、配合媒体库软件（如 Plex、Jellyfin）在线刮削和播放云盘里的视频。
- 界面整洁统一： 无论底层存储是什么类型，Alist 都提供一致的界面风格和操作体验。
- 跨平台部署： 可以在 Windows、Linux、macOS、Docker 等多种环境下运行。
- 开源免费： Alist 本身是免费开源的软件。
在哪里可以运行 Alist？（“哪里”的部署位置）
Alist 可以在多种设备和环境中运行，只要它有支持的操作系统和足够的资源：
- 个人电脑： Windows、macOS、Linux 桌面操作系统。
- 服务器： Linux 服务器（物理机、虚拟机、VPS）。
- NAS 设备： 群晖（Synology）、威联通（QNAP）等支持 Docker 或有社区套件的应用商店。
- 软路由/开发板： 性能足够的路由器或树莓派等单板计算机。
- Docker： 最推荐的方式，方便部署、管理和迁移，对环境依赖少。可以在任何支持 Docker 的设备上运行。
选择在哪里运行取决于你的需求。如果在家里使用，可以在家里的电脑或 NAS 上运行；如果需要外网访问，通常需要在具备公网 IP 的服务器或 NAS 上部署，并做好端口转发或使用内网穿透服务。
使用 Alist 需要花费多少钱？（“多少”的成本）
Alist 本身是完全免费且开源的软件，使用它无需支付任何授权费用。
你可能产生的费用通常来源于：
- 存储服务费用： 如果你使用的云盘是付费的（例如 OneDrive 容量升级、阿里云盘会员等），这部分费用与 Alist 无关。
- 运行 Alist 的设备费用： 如果你在 VPS 或云服务器上运行 Alist，需要支付服务器的租用费用；如果在家里运行，可能会产生额外的电费（相对较低）。
- 网络流量费用： 如果你通过外网访问 Alist，可能会产生服务器的流量费用，但这通常包含在 VPS 或服务器的套餐内。
总结来说，Alist 软件本身零成本，成本主要取决于你选择的存储服务和运行环境。
如何安装和启动 Alist？（“如何”的部署方法）
Alist 的安装方法有多种，以下介绍几种常见且推荐的方式：
在 Windows 上安装
这是最简单直接的方式，适合个人电脑或临时使用。
- 访问 Alist 的 GitHub Releases 页面 (https://github.com/alist-org/alist/releases)。
- 根据你的 Windows 版本（32位或64位）下载对应的压缩包 (通常是
alist-xxxx-windows-amd64.zip)。 - 将下载的压缩包解压到你想要安装的文件夹，例如
D:\Alist。 - 进入解压后的文件夹，找到
alist.exe可执行文件。 - 首次运行获取初始密码： 按住
Shift键同时右击该文件夹空白处，选择“在此处打开 PowerShell 窗口”或“在此处打开命令窗口”。输入命令.\alist.exe admin并按回车。
C:\your\path> .\alist.exe admin
# 会在输出中显示随机生成的管理员密码
请记下这个初始密码，后续登录后台需要用到。
- 启动 Alist： 双击运行
alist.exe文件。一个命令行窗口会打开，显示 Alist 的启动日志。看到“start server”之类的字样表示启动成功。 - 访问： 打开浏览器，访问地址
http://localhost:5244。如果无法访问，可能是端口被占用或防火墙阻止，可以尝试关闭防火墙或更改 Alist 端口。
要停止 Alist，关闭命令行窗口即可。
在 Linux 上使用安装脚本
对于 Linux 服务器或虚拟机，使用官方提供的一键安装脚本非常方便。
- 打开终端，使用以下命令下载并运行安装脚本：
curl -fsSL “https://alist.nn.ci/go.sh” | bash -s install
- 脚本会自动下载最新版本的 Alist 并将其安装为系统服务。
- 安装完成后，脚本会提示你如何查看管理员的初始密码。通常使用命令：
alist admin
记下这个密码。
- 管理服务：
- 启动 Alist：
systemctl start alist - 停止 Alist：
systemctl stop alist - 重启 Alist：
systemctl restart alist - 查看状态：
systemctl status alist
- 启动 Alist：
- 访问： 打开浏览器，访问服务器的 IP 地址和端口 5244，例如
http://你的服务器IP:5244。
使用 Docker 安装 (推荐)
Docker 是部署 Alist 最灵活、最干净的方式，方便更新和管理。
- 确保你的系统已经安装了 Docker 和 Docker Compose (可选，但推荐)。
- 打开终端或命令提示符，运行以下命令来下载 Alist 镜像并创建容器：
docker run -d –restart=always -p 5244:5244 -v /opt/alist:/opt/alist –name=”alist” xhofe/alist:latest
命令解释：
-d: 后台运行容器。--restart=always: Docker 服务重启后，容器也会自动重启。-p 5244:5244: 将容器内部的 5244 端口映射到宿主机的 5244 端口。你可以将宿主机的端口改为其他未占用的端口，例如-p 80:5244将容器映射到宿主机的 80 端口。-v /opt/alist:/opt/alist: 将宿主机的/opt/alist目录挂载到容器内部的/opt/alist目录。Alist 的所有配置、数据文件都会存储在宿主机的/opt/alist目录下（如果/opt/alist不存在，Docker 会自动创建）。请根据你的实际需求修改宿主机路径。--name="alist": 为容器指定一个名称，方便管理。xhofe/alist:latest: 使用最新版本的 Alist 官方 Docker 镜像。
- 首次运行获取初始密码： 容器启动后，你需要查看其日志来获取管理员初始密码。使用命令：
docker logs alist
在日志输出中查找包含“password”的行，记下初始密码。
- 访问： 打开浏览器，访问宿主机的 IP 地址和映射的端口，例如
http://你的服务器IP:5244或http://你的服务器IP(如果映射到 80 端口)。
如何配置 Alist？（“怎么”进行设置）
安装并启动 Alist 后，最重要的配置就是添加存储。
登录管理员后台
- 打开浏览器，访问你的 Alist 地址 (例如
http://你的服务器IP:5244)。 - 在首页右上角或页面底部找到“管理”或“Management”链接，点击进入登录页面。
- 输入用户名
admin和你之前获取到的初始密码。 - 首次登录成功后，强烈建议立即修改管理员密码，在“用户”或“Users”菜单中找到 admin 用户进行修改。
添加存储（挂载网盘/文件夹）
这是 Alist 的核心功能配置，步骤如下：
- 登录管理员后台后，在左侧导航栏找到“存储”或“Storage”，点击“添加”或“Add”。
- 在新页面中填写配置信息：
- 驱动 (Driver): 从下拉菜单中选择你要挂载的存储类型，例如“阿里云盘”、“OneDrive”、“WebDAV”等。
- 挂载路径 (Mount Path): 这是这个存储在 Alist 文件树中显示的位置。例如，填写
/阿里云盘表示挂载后可以在根目录下看到一个名为“阿里云盘”的文件夹；填写/我的文件/云盘则会在“我的文件”下创建“云盘”文件夹。挂载路径必须以/开头，不能是根目录/(根目录是所有挂载点的容器)。 - 其他参数： 根据你选择的驱动类型，下方会出现不同的配置项。这些参数非常重要且各不相同。你需要根据 Alist 官方文档或相关教程获取对应驱动的详细配置方法。
- 例如，挂载阿里云盘可能需要填写 Token。
- 挂载 OneDrive 可能需要注册一个应用程序并获取 Client ID 和 Client Secret，然后进行授权获取 Refresh Token。
- 挂载 WebDAV 需要填写 WebDAV URL、用户名和密码。
- 挂载本地存储需要填写本地文件夹的绝对路径。
请仔细阅读 Alist 官方文档中关于特定驱动的配置说明，这是能否成功挂载的关键。
- 顺序 (Order): 设置挂载点的显示顺序，数字越小越靠前。
- 其他可选设置如缓存、读写状态等，可以根据需要调整。
- 填写完毕后，点击页面底部的“保存”按钮。
- 保存成功后，Alist 会尝试连接并加载该存储的内容。回到 Alist 的首页，刷新页面，你应该就能看到你刚刚添加的挂载点出现在指定的挂载路径下了。
- 如果添加失败，通常是因为驱动参数填写错误。回到后台的“存储”列表，找到该存储项，查看错误信息并检查配置。
修改存储配置
在管理员后台的“存储”列表页，点击已添加存储项右侧的编辑按钮，可以修改其配置。修改后记得点击保存。
其他常用后台配置
- 设置 (Settings): 可以修改网站标题、LOGO、端口号、首页内容、主题等。
- 用户 (Users): 管理用户账号，修改密码，分配用户组。
- 用户组 (Groups): 创建用户组，为不同组设置全局或特定路径的访问权限、限速等。
- 任务 (Tasks): 查看一些后台任务的执行状态。
如何日常使用 Alist？（“怎么”进行文件操作）
配置好存储后，日常使用 Alist 主要通过其 Web 界面进行。
浏览和查看文件
- 打开浏览器，访问你的 Alist 地址。
- 你会看到你在后台设置的各个挂载点。点击文件夹图标进入子目录。
- 页面会显示当前目录下的文件和文件夹列表。
- 对于支持在线预览的文件类型（如图片、纯文本文件、Markdown 文件，部分音视频文件），点击文件名可以直接在浏览器中打开预览或播放。
下载文件
- 下载单个文件： 在文件列表页，点击文件名旁边的下载图标（通常是一个向下箭头的图标），或者右击文件选择下载。
- 下载多个文件： 勾选你想要下载的多个文件和文件夹，页面底部会出现操作栏，点击下载图标。Alist 通常会将选中的多个文件打包成一个 ZIP 文件供你下载。
上传文件
上传功能是否可用取决于你挂载的存储驱动是否支持写入操作（许多网盘驱动是只读的，例如阿里云盘早期版本）。
- 进入你想要上传文件的目标文件夹。
- 如果该目录支持上传，页面上会有“上传”按钮或支持拖拽文件到页面进行上传。
- 点击“上传”按钮，选择本地文件进行上传，或直接将文件从电脑文件夹拖拽到 Alist 的网页界面。
- 上传进度会显示在页面上。
文件管理操作（复制、移动、重命名、删除）
这些操作同样取决于底层存储驱动是否支持。如果支持，操作方式通常是：
- 勾选需要操作的文件或文件夹。
- 页面底部会出现操作栏，包含复制、移动、重命名、删除等选项。
- 点击相应的操作按钮，根据提示完成操作（例如，移动文件需要选择目标文件夹）。
通过 WebDAV 访问
这是 Alist 非常实用的功能之一，可以将你的各种网盘通过 WebDAV 协议“挂载”到电脑或手机上，使其看起来像本地硬盘一样，方便文件管理或配合其他支持 WebDAV 的应用使用。
- 启用 WebDAV： 默认情况下 Alist 的 WebDAV 功能是开启的。其 WebDAV 地址通常是 Alist 地址加上
/dav后缀。例如，如果你的 Alist 地址是http://你的服务器IP:5244，那么 WebDAV 地址就是http://你的服务器IP:5244/dav。 - 使用 WebDAV 客户端：
- Windows： 打开“此电脑”（或“我的电脑”），右击空白处选择“添加一个网络位置”，按照向导输入 WebDAV 地址，然后输入你在 Alist 后台设置的用户名和密码（可以是 admin 用户，也可以是你在后台创建的其他用户）。
- macOS： 在 Finder 中，前往 -> 连接服务器，输入 WebDAV 地址并连接，输入用户名和密码。
- 手机： 大部分文件管理器 App（如 ES 文件浏览器、Solid Explorer 等）支持添加 WebDAV 连接，输入地址、用户名和密码即可。
- 连接成功后，你就可以像访问本地文件夹一样，在文件管理器中浏览、打开、复制、粘贴 Alist 中挂载的文件了。
需要注意的是，通过 WebDAV 进行文件操作的速度和稳定性取决于你的网络环境以及底层存储驱动对 WebDAV 写入、移动等操作的支持程度。
创建公共分享链接
- 在 Alist Web 界面找到你想要分享的文件或文件夹。
- 在文件/文件夹旁边找到分享图标或右击选择分享。
- 配置分享选项，例如设置有效期、是否需要密码等。
- 点击生成链接，将生成的分享链接发送给需要的人即可。
其他常见问题（“怎么”解决问题）
如何更新 Alist？
更新方法取决于你的安装方式：
- Windows 版本： 下载最新版本的压缩包，解压后覆盖原有的
alist.exe文件（注意备份你的data文件夹，它包含了配置数据）。然后重新运行新的alist.exe。 - Linux 脚本安装： 再次运行安装脚本即可自动更新：
curl -fsSL “https://alist.nn.ci/go.sh” | bash -s install
- Docker 版本： 停止并删除旧容器，然后拉取最新镜像并重新创建容器：
docker stop alist
docker rm alist
docker rmi xhofe/alist:latest # 可选，删除旧镜像
docker pull xhofe/alist:latest
docker run -d –restart=always -p 5244:5244 -v /opt/alist:/opt/alist –name=”alist” xhofe/alist:latest
请确保在重新创建容器时，卷映射 (
-v参数) 指向的是你原来存放配置文件的目录，这样配置就不会丢失。
忘记管理员密码怎么办？
可以通过命令行重置或获取。方法与首次运行获取密码类似：
- Windows： 在 Alist 目录下打开命令提示符或 PowerShell，运行
alist.exe admin。 - Linux 脚本安装： 运行
alist admin命令。 - Docker： 如果你挂载了数据卷，可以进入容器内部执行命令或通过修改配置文件。更简单的可能是直接删除容器，然后使用上面的
docker run命令重新创建一个新的，获取新的初始密码，再手动恢复配置（如果之前有备份 data 目录）。
Alist 无法访问或启动失败怎么办？
- 检查端口： 确保 Alist 使用的端口（默认为 5244）没有被其他程序占用，并且防火墙允许该端口的流量通过。如果你是通过外网访问，还需要检查路由器或云服务商的安全组/防火墙设置，确保外部端口已正确映射或放行到运行 Alist 的设备的内部端口。
- 查看日志： 查看 Alist 的运行日志。如果是脚本安装或 Docker，使用
systemctl status alist或docker logs alist命令查看日志输出，通常会有错误提示。 - 检查配置： 如果是启动后无法访问某个挂载点，登录后台检查该存储的配置参数是否正确，尤其是各种 Token、密钥、路径等。
- 重启尝试： 尝试停止并重新启动 Alist 服务或 Docker 容器。
通过以上详细的“是什么、为什么、哪里、多少、如何、怎么”的使用层面解答，相信您已经对如何安装、配置和日常使用 Alist 有了全面的了解。掌握了这些基本操作，您就可以充分利用 Alist 将您的各种分散存储整合成一个易于访问和管理的统一平台了。
