1. 项目缘起为什么我们需要一个统一的网盘管理器如果你和我一样手里攥着好几个网盘的账号——百度网盘存着工作资料阿里云盘塞满了电影和剧集夸克网盘可能用来中转一些临时文件OneDrive同步着办公文档。每次想找点东西都得在不同的网页、不同的客户端之间来回切换不仅麻烦而且各个网盘之间文件无法互通管理起来简直是一场灾难。更别提有些网盘客户端那感人的上传下载速度和时不时弹出的广告了。所以当我在社区里第一次看到AList这个名字时眼前确实一亮。它不是什么新出的网盘服务而是一个开源的、支持将多种存储服务包括但不限于几十种主流网盘、对象存储、本地存储等聚合到一起的“文件列表程序”。简单来说你可以把它理解为一个“网盘聚合器”或者“统一文件网关”。通过部署一个AList服务你就能在一个统一的Web界面里浏览、管理、上传、下载你所有已挂载网盘里的文件甚至可以直接在线预览视频、文档、图片生成直链分享给朋友。这解决了几个核心痛点管理分散、访问不便和功能单一。你不用再记一堆网址和密码所有资源尽在掌握对于家庭影音库搭建、个人知识库管理或者小型团队文件共享来说它提供了一个极其轻量且强大的中心化解决方案。最近“alist倒挂夸克网盘”、“openlist挂载夸克网盘”这些热词频繁出现也侧面印证了大家对于低成本、高效率管理夸克网盘这类服务的迫切需求。本教程将手把手带你完成AList在Linux和Windows两大主流平台上的部署并挂载你常用的网盘。整个过程不涉及复杂编程更像是在搭积木只要跟着步骤走半小时内你就能拥有自己的私人云盘管理中心。2. 部署前哨战理解AList的核心与准备工作在动手之前我们得先搞清楚AList到底是个什么东西以及我们需要准备些什么。这能帮你避开后面很多“为什么这一步要这样做”的坑。2.1 AList的核心工作模式不是同步是代理这是最重要的一个概念很多人会误解。AList并不像Resilio Sync或Syncthing那样在本地和云端之间同步文件。它更像是一个“智能的网页书签管理器”或“API网关”。工作方式当你通过AList的网页界面点击一个文件时AList会代表你使用你预先配置好的账号令牌向对应的网盘API发起请求获取到这个文件的临时访问链接直链然后你的浏览器或下载工具就直接从这个临时链接下载文件。文件数据流是“网盘 - 你的设备”AList服务器只负责中转这个链接请求本身不存储文件内容除非你开启了本地代理等功能。因此它对服务器本身的存储空间要求极低但对网络的稳定性和延迟有一定要求因为每次文件列表读取和文件访问都需要实时调用网盘API。优势节省服务器存储空间可以实时访问网盘最新内容添加/移除存储源非常灵活。劣势严重依赖各个网盘服务的API稳定性和速率限制。如果某个网盘API抽风或变更对应的挂载就可能暂时失效需要等待AList社区更新驱动。2.2 环境准备与关键选择无论Linux还是Windows部署前都需要确认以下几点一台可长期运行的设备这是你的AList服务将安家的地方。可以是家用电脑需要长期开机适合个人重度使用。NAS如群晖、威联通、极空间绝佳选择24小时运行功耗低。云服务器如腾讯云、阿里云ECS有公网IP方便随时随地访问但需注意云服务器的流量费用和网盘API访问的跨境延迟。旧手机/电视盒子通过Termux等工具有一定动手能力也可行但性能可能受限。网络环境设备需要能稳定访问互联网特别是能顺畅连接你要挂载的网盘服务。如果某些网盘服务在海外而你的服务器在国内可能会遇到速度慢或无法访问的问题这时可能需要考虑网络优化方案注意此处仅提及现象不讨论任何具体技术手段。选择部署方式AList提供了多种部署方式我们将选择最主流、最易维护的两种。Docker部署推荐尤其适合Linux和NAS这是目前最主流的方式。Docker能将AList及其依赖环境打包成一个独立的容器与宿主机系统隔离安装、升级、迁移都极其方便几乎是一键完成。如果你听说过“docker安装部署”、“docker部署kodbox”那么对Docker应该不陌生。本教程Linux部分将重点采用此法。可执行文件直接运行适合Windows和快速体验AList官方提供了编译好的可执行文件下载后直接运行即可。这种方式最简单粗暴适合Windows用户快速上手但在管理后台运行、开机自启等方面需要一些额外配置。准备好这些认知和条件后我们就可以分平台开始实战了。3. Linux平台部署实战以Docker方案为例Linux服务器是部署各类服务的首选其稳定性和资源控制能力很强。这里我们以最常见的Ubuntu 20.04/22.04 LTS系统为例其他发行版CentOS, Debian命令略有不同但思路一致。3.1 基础环境搭建安装Docker与Docker Compose如果你的系统已经安装了Docker和Docker Compose可以跳过这一步。如果没有请依次执行以下命令。首先更新系统包索引并安装一些必要的工具sudo apt update sudo apt install -y apt-transport-https ca-certificates curl software-properties-common接着添加Docker的官方GPG密钥和软件源curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null更新源并安装Docker引擎sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io安装完成后启动Docker服务并设置开机自启sudo systemctl start docker sudo systemctl enable docker为了不用每次执行docker命令都加sudo可以将当前用户加入docker组操作后需要退出当前终端重新登录生效sudo usermod -aG docker $USER最后安装Docker Compose插件新版本Docker推荐使用docker compose插件而非独立的docker-compose二进制文件sudo apt install -y docker-compose-plugin验证安装是否成功docker --version docker compose version看到版本号输出即表示环境准备就绪。3.2 使用Docker Compose一键部署AListDocker Compose允许我们用一个YAML文件来定义和运行多容器应用。对于AList单服务用它来管理配置和启动非常清晰。创建项目目录并编写配置文件 在家目录或你喜欢的路径下创建一个用于存放AList配置的目录并进入该目录。mkdir -p ~/alist cd ~/alist使用vim或nano创建docker-compose.yml文件vim docker-compose.yml将以下配置内容粘贴进去。这里有几个关键参数需要理解version: 3.8 services: alist: image: xhofe/alist:latest container_name: alist restart: unless-stopped ports: - 5244:5244 environment: - PUID1000 - PGID1000 - UMASK022 volumes: - ./data:/opt/alist/data - ./config:/opt/alist/config # 如果需要在容器内挂载本地目录作为存储可以取消下面的注释并修改路径 # - /path/to/your/local/folder:/dataimage: xhofe/alist:latest: 使用官方镜像。你也可以指定特定版本如v3.29.1以获得更稳定的体验。restart: unless-stopped: 容器意外退出时会自动重启保证服务高可用。ports: - 5244:5244: 将容器内的5244端口映射到宿主机的5244端口。5244就是AList的默认Web访问端口。如果宿主机这个端口已被占用可以修改前面的数字例如- 8080:5244。environment: 设置环境变量。PUID/PGID需要设置为宿主机上你当前用户的UID和GID通常都是1000这决定了容器内进程的权限避免生成的文件所有者是root导致管理不便。可以用id -u和id -g命令查看。volumes:这是数据持久化的关键它将容器内的目录映射到宿主机的目录。./data:/opt/alist/data: 映射数据目录用于存放AList的数据库等。./config:/opt/alist/config: 映射配置目录。这样即使容器被删除你的配置和数据也安全地保存在宿主机上。启动AList服务 在docker-compose.yml文件所在目录执行docker compose up -d-d参数代表在后台运行。命令执行后Docker会拉取镜像并启动容器。获取管理员密码 AList启动后默认的用户名是admin密码是随机生成并存储在容器内的。我们需要查看日志来获取它。docker logs alist在输出的日志信息中仔细寻找类似下面的一行INFO[2023-10-27 08:00:00] admin password: xxxxxx这个xxxxxx就是你的初始管理员密码。请务必记录下来。访问并初始化 打开浏览器访问http://你的服务器IP地址:5244。如果你在服务器本机操作可以访问http://localhost:5244。 使用用户名admin和刚才查到的密码登录。 首次登录后强烈建议你立即在管理后台左下角头像 - 管理中修改这个随机密码。3.3 进阶配置与管理部署完成只是第一步让服务稳定、安全地运行更重要。设置反向代理可选但推荐直接通过IP:5244访问不够美观也不安全。你可以使用Nginx或Caddy等Web服务器为AList设置反向代理绑定域名并使用HTTPSSSL证书。这能提供更安全的访问方式和更好的用户体验。例如一个简单的Nginx配置片段如下server { listen 80; server_name alist.yourdomain.com; # 你的域名 location / { proxy_pass http://localhost:5244; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } # 强烈建议配置SSL此处略去申请和配置SSL证书的步骤 }配置后你就可以通过https://alist.yourdomain.com访问了。服务更新当AList发布新版本时更新非常简单。进入docker-compose.yml所在目录执行docker compose pull # 拉取最新镜像 docker compose down # 停止并删除旧容器 docker compose up -d # 用新镜像重新创建并启动容器你的所有配置和数据./data和./config都会保留。查看日志与排错docker logs -f alist # 实时查看日志 docker compose logs -f # 使用compose查看日志如果遇到无法登录、挂载失败等问题首先查看日志通常会有明确的错误信息。4. Windows平台部署实战可执行文件方案对于Windows用户特别是希望在自己日常使用的电脑上快速搭建一个AList服务来管理网盘使用可执行文件是最直接的方法。4.1 下载与运行AList获取程序 访问AList的GitHub Releases页面https://github.com/alist-org/alist/releases在最新的发布版本中找到名为alist-windows-amd64.zip的文件如果你的系统是64位的话下载并解压到一个你喜欢的目录例如D:\Tools\AList。解压后你会看到几个文件其中alist.exe就是主程序。首次运行与获取密码打开命令提示符CMD或 PowerShell并切换到你的AList目录。cd D:\Tools\AList运行以下命令来启动AList并生成初始数据.\alist.exe server程序运行后同样会在控制台输出管理员密码。仔细在屏幕上寻找admin password: xxxxxx这一行信息并记录。按CtrlC可以停止服务。以服务方式运行实现开机自启 在命令行窗口运行的方式不够方便我们需要将其注册为Windows服务实现后台运行和开机启动。首先以管理员身份打开一个新的PowerShell或CMD窗口。使用AList自带的命令安装服务。确保你的工作目录在AList.exe所在文件夹。.\alist.exe service install启动服务.\alist.exe service start现在AList已经在后台运行了。你可以通过系统服务管理器services.msc找到名为AList的服务并将其启动类型设置为“自动”。停止/卸载服务的命令.\alist.exe service stop .\alist.exe service uninstall访问与管理 打开浏览器访问http://localhost:5244。使用admin和初始密码登录并记得修改密码。4.2 Windows下的路径与防火墙注意事项数据目录Windows版本的数据默认存储在程序所在目录的data文件夹下。如果你移动了alist.exe这个相对路径依然有效。但为了更好管理你可以在启动服务前通过修改配置文件或环境变量来指定数据目录不过对于新手保持默认即可。防火墙如果需要在局域网内其他设备访问这台Windows电脑上的AList例如用手机访问http://电脑IP:5244你需要允许5244端口的入站连接。打开“Windows Defender 防火墙”点击“高级设置”在“入站规则”中新建一条规则选择“端口”TCP特定本地端口5244然后允许连接最后命名规则即可。5. 核心操作挂载你的第一个网盘以夸克网盘为例部署好服务只是搭好了舞台挂载网盘才是唱戏。这里以近期热门的“夸克网盘”为例演示挂载流程。其他网盘阿里云盘、百度网盘、OneDrive等流程高度相似核心都是获取对应的“刷新令牌”或“访问令牌”。5.1 获取夸克网盘的刷新令牌这是挂载第三方网盘最核心也最容易出错的一步。由于网盘官方不直接提供这种令牌我们需要通过“抓包”或使用开发者工具来获取。这里介绍一种相对简单且由社区验证过的方法请注意此方法依赖于网盘官方未修改其登录协议未来可能失效。准备工作在电脑上安装一个带有开发者工具的浏览器Chrome、Edge、Firefox均可。打开登录页面访问夸克网盘网页版 (https://pan.quark.com)并确保你没有登录。打开开发者工具按F12打开开发者工具切换到“网络”(Network)选项卡。勾选上“保留日志”(Preserve log)。开始登录在网页上输入你的手机号和密码点击登录。注意不要使用扫码登录。查找关键请求在开发者工具的“网络”面板中你会看到刷出一系列请求。仔细寻找一个名称类似account.quark.com或带有token关键词的请求。通常是一个POST请求。提取令牌点击这个请求在右侧的“响应”(Response)或“负载”(Payload)标签页里寻找一个名为refresh_token或access_token的字段。我们需要的是refresh_token的值它是一长串字母数字组成的字符串。完整地复制它。重要提示这个过程需要一些耐心和细心。如果找不到可以去AList的官方文档或GitHub讨论区搜索最新教程社区用户经常会分享稳定的获取方法。令牌是你的网盘访问凭证请妥善保管不要泄露。5.2 在AList中添加存储登录你的AList管理后台。在左侧菜单栏找到并点击“存储”然后点击右上角的“添加”按钮。在驱动列表里找到并选择“Quark Cloud Drive (夸克网盘)”。开始填写配置信息挂载路径这是你在AList中访问这个网盘的路径。例如填写/quark那么你之后访问http://你的AList地址/quark就能看到夸克网盘的内容。排序和备注根据喜好填写方便管理多个存储。刷新令牌将上一步复制的refresh_token粘贴到这里。根文件夹ID默认为root表示挂载网盘的根目录。如果你想只挂载某个特定文件夹需要先获取该文件夹的ID方法较复杂一般用root即可。排序方式选择文件列表的默认排序规则。其他选项保持默认直接点击页面底部的“添加”按钮。如果一切顺利你的存储列表里就会出现新添加的夸克网盘状态显示为“已就绪”。点击主页的“存储”位置或者直接访问你设置的挂载路径如/quark就能浏览和管理你的夸克网盘文件了。你可以在线播放视频、查看图片、下载文件甚至通过AList生成分享链接。6. 深度使用技巧与常见问题排雷挂上网盘只是开始要让AList更好用还得了解一些进阶玩法和避坑指南。6.1 提升体验的实用配置WebDAV挂载到本地这是实现“网盘挂载到本地”这个标题的另一层含义。AList支持WebDAV协议这意味着你可以在Windows的“映射网络驱动器”、macOS的“连接服务器”或者各种支持WebDAV的文件管理器如RaiDrive中将AList的某个目录甚至整个AList挂载为一个本地磁盘。在AList管理后台的“设置”-“全局”中开启WebDAV并设置好账号密码。然后在本地电脑上添加一个网络位置地址填http://你的AList地址:5244/dav输入账号密码就能像操作本地文件夹一样操作云盘文件了非常强大。设置访客账户与权限控制如果你希望分享给家人朋友使用但不想给他们管理员权限可以在“用户”页面创建新用户并为其分配特定的存储访问权限只读或读写。自定义主题与预览AList支持修改前端界面。在“设置”-“全局”中可以修改站点标题、Logo等。更高级的你可以通过修改index.html文件或使用第三方主题来深度定制界面。对于视频预览它依赖于前端的播放器对主流格式支持较好但如果遇到无法预览的情况可能需要检查文件格式或考虑转码。6.2 高频问题与解决方案挂载失败状态显示“错误”首要检查去AList管理后台的“日志”页面查看具体错误信息比盲目搜索有效得多。令牌失效这是最常见的原因。网盘的刷新令牌refresh_token可能过期通常有效期较长或被撤销。需要重新按照第5.1节的方法获取新的refresh_token并更新存储配置。API变更网盘官方修改了接口导致AList的驱动暂时失效。关注AList的GitHub项目更新等待新版本驱动发布。临时解决方案可能是回退到旧版网盘客户端或使用其他获取令牌的方法。网络问题你的服务器无法访问该网盘的API服务器。尝试在服务器上ping或curl测试连通性。文件列表加载慢或视频播放卡顿网络延迟服务器与网盘服务器之间的网络延迟高。如果服务器在海外挂载国内网盘就可能出现此问题。考虑更换服务器地域或使用网络优化合规范围内。AList代理对于视频等大文件AList默认可能尝试“代理”传输即文件流经过AList服务器中转。你可以在存储的编辑页面找到“Web代理”或“本地代理”选项并禁用它让浏览器直接从网盘直链下载/播放速度会快很多。但注意有些网盘直链有防盗链或IP限制禁用代理后可能无法播放。客户端播放器尝试更换AList内置播放器或者使用第三方播放器如PotPlayer通过WebDAV挂载后播放。如何更新AList版本Docker版如前所述使用docker compose pull docker compose down docker compose up -d。Windows可执行文件版停止AList服务下载新版本的alist-windows-amd64.zip解压并覆盖旧的文件注意备份好data文件夹然后重新启动服务。数据备份定期备份docker-compose.yml文件所在的整个目录Linux Docker版或alist.exe同级目录下的data文件夹Windows版。这里面包含了你的所有存储配置、用户信息和元数据。即使系统重装只要恢复这个目录你的AList就能恢复原样。AList的强大之处在于它的社区和不断丰富的驱动支持。除了常见的公有云盘它还能挂载SFTP、S3协议的对象存储、本地路径、甚至其他AList服务器。通过组合使用你可以搭建出一个无比灵活的个人云存储架构。部署过程看似步骤不少但每一步都有其道理理顺之后维护起来非常简单。