1. 项目概述为什么你需要一个自己的Alist如果你经常在多个网盘、云存储服务之间切换比如同时用着阿里云盘存电影、OneDrive同步工作文档、Google Drive放些学习资料那你肯定体会过那种来回登录、文件散落各处、下载速度飘忽不定的烦恼。更别提想给朋友分享个文件还得先下载到本地再上传到另一个平台的尴尬。Alist这个开源项目就是为了解决这些痛点而生的。它本质上是一个支持多种存储的文件列表程序你可以把它理解为你所有云端存储的“统一管理后台”和“高速下载中转站”。我最初接触Alist就是因为受不了阿里云盘官方客户端那捉摸不定的下载速度以及想用一个Web界面管理我所有的网盘。自己部署一个Alist后最大的感受就是“掌控感”回来了。文件列表清晰在线预览方便更重要的是通过WebDAV等协议我可以让本地播放器、笔记软件直接挂载我的云端文件库体验无缝衔接。网络上关于Alist的热搜词比如“alist挂载阿里网盘下载速度慢怎么解决”、“alist怎么获取阿里云盘令牌”恰恰反映了大家最关心的两个核心问题性能和配置。这篇文章我就以一个过来人的身份手把手带你完成Alist从安装、基础配置到性能调优的全过程并分享一些官方文档里不会写的实战心得和避坑指南。2. 环境准备选对“地基”事半功倍在开始安装Alist之前我们需要一个稳定可靠的运行环境。Alist是一个用Go语言编写的程序这意味着它本身是跨平台的但最常见的部署方式是在Linux服务器上无论是实体机、VPS还是容器。这里我们主要讨论两种主流方案传统系统级安装和Docker容器化安装。选择哪种取决于你的技术偏好和服务器环境。2.1 方案对比传统安装 vs Docker安装很多教程一上来就让你执行一堆命令但很少告诉你为什么选这个。我们先做个简单的对比特性传统系统安装Docker容器安装上手难度中等需要手动处理依赖和进程管理较低一条命令即可运行环境隔离维护成本较高升级、备份需手动操作较低镜像升级、数据迁移方便资源占用较低直接运行二进制文件略高包含容器运行时开销灵活性高可直接修改二进制或配置文件高通过卷挂载和变量配置推荐场景熟悉Linux系统管理追求极致轻量新手友好环境复杂或需快速部署对于绝大多数个人用户和小型应用场景我强烈推荐使用Docker方式。它不仅简化了安装流程更重要的是解决了环境依赖和版本冲突的问题。你不需要关心服务器上是CentOS还是Ubuntu也不用折腾Go环境Docker镜像里一切都准备好了。2.2 基础环境检查与依赖安装无论选择哪种方式你的服务器都需要具备基本的网络连接和包管理工具。以最常见的Ubuntu 22.04 LTS为例我们首先更新系统并安装一些可能用到的工具。通过SSH连接到你的服务器后执行以下命令# 更新软件包列表 sudo apt update sudo apt upgrade -y # 安装常用工具如vim, curl, wget等按需安装 sudo apt install -y curl wget vim如果你决定采用传统安装方式可能需要确保系统已安装较新版本的GLIBC库。但如前所述我们将以Docker作为主要路径进行讲解因此可以跳过复杂的编译环境准备。注意如果你的服务器位于国内可能会遇到访问Docker Hub镜像仓库速度慢的问题。建议先配置国内镜像加速器。例如对于腾讯云服务器可以编辑/etc/docker/daemon.json文件若不存在则创建加入以下内容{ registry-mirrors: [ https://mirror.ccs.tencentyun.com ] }然后重启Docker服务sudo systemctl restart docker。3. 核心安装实战两种路径详解准备好了环境我们现在进入核心的安装环节。我会详细讲解两种方法你可以根据自己的情况选择。3.1 路径一使用Docker安装推荐Docker安装是目前最简洁、最不易出错的方式。首先确保你的系统已经安装了Docker和Docker Compose。如果没有安装可以参考以下快速命令适用于Ubuntu/Debian# 安装Docker curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo systemctl start docker sudo systemctl enable docker # 安装Docker Compose (v2) sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose安装完成后创建一个专门的工作目录并编写docker-compose.yml文件。这是管理容器服务的最佳实践比直接使用docker run命令更易于维护和升级。mkdir -p ~/alist cd ~/alist vim docker-compose.yml在docker-compose.yml文件中输入以下内容。这里有几个关键点我做了调整和说明version: 3.8 services: alist: image: xhofe/alist:latest container_name: alist restart: unless-stopped volumes: - ./data:/opt/alist/data - ./config:/opt/alist/config ports: - 5244:5244 environment: - PUID1000 - PGID1000 - UMASK022 # 如果遇到下载问题可以尝试使用阿里云镜像 # image: registry.cn-hangzhou.aliyuncs.com/xhofe/alist:latest配置解读volumes这里将容器内的数据目录和配置目录映射到了宿主机的./data和./config目录。这是最重要的设置之一它保证了即使容器被删除你的账户信息和存储配置也不会丢失。ports将容器内的5244端口映射到宿主机的5244端口。你可以把前面的5244改为其他未被占用的端口比如8080:5244。environment设置运行容器的用户ID和组ID以及文件掩码这会影响容器内生成文件的权限。PUID1000和PGID1000通常对应第一个非root用户。关于镜像官方镜像xhofe/alist:latest通常没问题。如果拉取缓慢可以注释掉它使用下面那行阿里云镜像地址。保存文件后在docker-compose.yml所在目录执行一条命令即可启动docker-compose up -d-d参数代表后台运行。执行后使用docker-compose ps查看状态显示为Up即表示启动成功。此时在浏览器访问http://你的服务器IP:5244就能看到Alist的初始化页面了。3.2 路径二传统系统安装备用方案如果你因为某些原因无法或不想使用Docker可以采用传统安装。Alist提供了编译好的可执行文件直接下载运行即可。首先访问Alist的GitHub Releases页面https://github.com/alist-org/alist/releases找到最新版本。你需要根据你的服务器CPU架构选择对应的文件。对于常见的x86_64 Linux服务器选择alist-linux-amd64.tar.gz。在服务器上我们可以用命令行快速完成下载和解压# 进入一个合适的目录如 /opt cd /opt # 下载最新版本请将v3.36.0替换为实际看到的最新版本号 wget https://github.com/alist-org/alist/releases/download/v3.36.0/alist-linux-amd64.tar.gz # 解压 tar -zxvf alist-linux-amd64.tar.gz # 解压后得到一个名为 alist 的可执行文件为其添加执行权限 chmod x alist现在你可以直接运行./alist server来启动程序。但这样启动的进程会在SSH断开后终止。因此我们需要配置一个系统服务来管理它。创建一个系统服务文件sudo vim /etc/systemd/system/alist.service写入以下内容注意修改ExecStart的路径为你实际存放alist二进制文件的位置[Unit] DescriptionAlist service Afternetwork.target [Service] Typesimple WorkingDirectory/opt ExecStart/opt/alist server Restarton-failure [Install] WantedBymulti-user.target然后启动并设置开机自启sudo systemctl daemon-reload sudo systemctl start alist sudo systemctl enable alist使用sudo systemctl status alist检查服务状态。同样访问http://你的服务器IP:5244即可。踩坑提示传统安装方式下Alist的默认数据目录是$HOME/.config/alist。如果你用root用户运行服务那么这个目录就是/root/.config/alist。在迁移或备份时别忘了这个隐藏目录。而Docker方式通过卷映射数据位置一目了然这是Docker的另一个优势。4. 初始配置与管理员设置无论通过哪种方式安装第一次访问Alist的Web界面默认端口5244你都会看到一个非常简洁的页面上面只有Alist的Logo和版本信息。此时你需要获取初始的随机管理员密码。4.1 获取初始密码这个密码是程序第一次运行时自动生成的。获取方式取决于你的安装方式Docker安装# 进入你的alist目录即docker-compose.yml所在目录 cd ~/alist # 查看容器日志密码会在启动时打印出来 docker-compose logs alist | grep password或者你可以直接进入容器内部查看数据文件docker exec -it alist ./alist admin这条命令会直接输出管理员账号默认admin和当前密码。传统安装 如果你是用systemd服务运行的查看日志sudo journalctl -u alist -f --no-pager | grep password或者直接切换到Alist二进制文件所在目录执行./alist admin你会看到类似password: xxxxxxxx的输出这个就是你的初始密码。4.2 登录与修改密码用账号admin和查到的密码登录管理后台。登录后第一件事就是立即修改这个随机密码在管理后台左侧找到“设置” - “账号设置” - “修改密码”。输入旧密码和新密码完成修改。这是一个至关重要的安全步骤切勿跳过。4.3 基础站点设置接下来配置你的Alist站点基本信息。在“设置” - “全局设置”中有几个关键项站点标题你的Alist网站名称比如“我的云盘库”。站点URL填写你访问Alist的完整地址例如http://your-server-ip:5244。这个设置会影响某些功能如密码重置链接的生成。视频预览建议开启这样可以直接在网页上播放视频。音频预览同上开启后可在线播放音频。文本预览对于代码、日志等文本文件开启后可以直接在网页查看。隐藏文件可以设置隐藏以点.开头的文件通常是系统或配置文件。这些设置可以根据你的喜好调整之后随时可以回来修改。5. 核心功能配置挂载你的存储Alist的核心魅力在于聚合存储。下面我们以最热门的阿里云盘和本地存储为例详细讲解挂载过程。其他存储如OneDrive、Google Drive、123云盘等的配置逻辑大同小异核心都是获取对应的访问令牌Token或密钥。5.1 挂载阿里云盘解决“令牌”与“速度”难题热搜词里“alist怎么获取阿里云盘令牌”和“下载速度慢怎么解决”是两大高频问题我们重点攻克。第一步获取刷新令牌Refresh Token这是挂载阿里云盘最关键的凭证。Alist已不再推荐使用旧的刷新令牌获取方式。目前最稳定可靠的方法是使用浏览器的开发者工具。在电脑浏览器上登录阿里云盘网页版https://www.aliyundrive.com。按F12打开开发者工具切换到Application应用或存储标签页。在左侧Storage存储下找到Local Storage本地存储点击https://www.aliyundrive.com。在右侧的键值对列表中找到token这一项。点击token其对应的Value是一个很长的JSON字符串。复制整个value的值。在这个JSON字符串中找到refresh_token字段其后面引号内的字符串通常以eyJ...开头就是你需要的东西。重要提示这个refresh_token非常敏感等同于你的账号密码。切勿泄露给他人也不要粘贴到任何不信任的网站。它用于Alist后台自动刷新访问令牌保证长期可用。第二步在Alist中添加存储登录Alist管理后台在左侧菜单点击“存储”。点击页面右上角的“添加”按钮。在“驱动”下拉列表中选择“阿里云盘 Open”。填写配置信息挂载路径这是你访问这个云盘时在Alist中的路径例如/阿里云盘。建议用英文或拼音避免奇怪的问题。排序数字越小越靠前。刷新令牌将上一步获取的refresh_token粘贴到这里。根文件夹ID默认为root表示挂载整个云盘。如果你想只挂载某个特定文件夹可以在阿里云盘网页版进入该文件夹地址栏URL中的folder/后面那一串字符就是文件夹ID。下载方式这是影响下载速度的关键设置。有三个选项proxy代理文件流经过你的Alist服务器中转。如果你的服务器带宽小这将成为速度瓶颈也是很多人感觉“下载速度慢”的原因。urlURLAlist会尝试返回一个阿里云盘的原始下载链接给浏览器由浏览器直接下载。这是推荐选项速度最快不消耗服务器流量。但某些情况下如视频预览可能 fallback 到代理。aria2调用配置的Aria2下载工具。强烈建议选择url。其他选项如“Web代理”、“缓存过期时间”等可以保持默认。点击“添加”按钮。稍等几秒如果状态显示为“已就绪”一个绿色的勾说明挂载成功。你可以点击“主页”查看应该能看到你新挂载的“阿里云盘”目录了。为什么url模式更快因为proxy模式下文件数据需要先从阿里云盘服务器下载到你的Alist服务器再从你的Alist服务器传给你的电脑。这受到你服务器上行带宽的限制。而url模式是给你的浏览器一个阿里云盘的临时直链让你的电脑直接和阿里云盘的服务器通信通常能跑满你的家庭宽带下行速度。5.2 挂载本地存储服务器磁盘有时你可能想分享服务器本地的文件或者将Alist作为一个小型文件服务器。挂载本地存储非常简单。在“存储”页面点击“添加”驱动选择“本地存储”。填写配置挂载路径例如/本地文件。根文件夹路径填写服务器上的一个绝对路径例如/home/user/my_files。请确保运行Alist的用户Docker容器用户或systemd服务用户对这个目录有读取权限。点击“添加”。这样服务器上/home/user/my_files目录下的所有文件就能通过Alist的Web界面访问和下载了。5.3 添加其他存储Alist支持数十种存储服务添加流程类似选择驱动 - 获取对应平台的凭证通常是OAuth2授权或API密钥 - 填写配置。例如123云盘需要获取刷新令牌获取方式与阿里云盘类似。OneDrive/Google Drive通常需要创建应用获取客户端ID和密钥并通过Alist提供的OAuth链接进行授权。SFTP/FTP需要服务器地址、端口、用户名、密码。每添加一个存储你的Alist就变成一个更强大的统一文件门户。6. 进阶配置与性能优化基础功能跑通后我们可以进行一些优化让Alist更好用、更安全、更高效。6.1 配置反向代理与HTTPS提升安全性与访问便利直接通过IP:端口访问既不安全也不方便。我们可以使用Nginx或Caddy等Web服务器为Alist配置反向代理并绑定域名、启用HTTPS。这里以Nginx为例假设你已有一个域名alist.yourdomain.com并解析到了服务器IP。安装Nginxsudo apt install nginx -y为Alist创建一个Nginx配置文件sudo vim /etc/nginx/sites-available/alist写入以下配置。关键点在于proxy_pass指向Alist的实际地址http://127.0.0.1:5244以及proxy_set_header部分的设置这能确保Alist能获取到真实的客户端IP和协议。server { listen 80; server_name alist.yourdomain.com; # 改为你的域名 location / { proxy_pass http://127.0.0.1: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; proxy_set_header REMOTE-HOST $remote_addr; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_connect_timeout 60s; proxy_send_timeout 60s; proxy_read_timeout 60s; # 如果Alist部署在Docker容器内且容器名就是alist也可以直接用 proxy_pass http://alist:5244; } }创建符号链接启用配置并测试Nginx配置sudo ln -s /etc/nginx/sites-available/alist /etc/nginx/sites-enabled/ sudo nginx -t # 测试配置语法如果测试通过重载Nginxsudo systemctl reload nginx现在你应该可以通过http://alist.yourdomain.com访问Alist了。要启用HTTPS可以使用Let‘s Encrypt的免费证书通过certbot工具自动化完成。安装certbot后执行sudo certbot --nginx并按照提示操作即可。6.2 性能调优与问题排查1. 下载速度慢这是最常见的问题90%的原因出在“下载方式”上。症状通过Alist下载文件速度远低于直接使用网盘客户端或IDM等工具。排查立刻去检查该存储的配置将“下载方式”从proxy改为url。原理如上文所述proxy模式受限于你的服务器带宽。url模式是直链。例外某些存储如某些对象的特定区域可能不支持直接输出原始下载链接此时只能使用proxy。如果服务器带宽是瓶颈可以考虑升级服务器带宽或使用支持url模式的其他存储。2. 视频播放卡顿原因视频文件较大proxy模式下服务器带宽不足或者浏览器直接播放时码率过高。解决确保存储的“下载方式”为url让视频流直连。在Alist的“全局设置”中可以开启“视频缓冲大小”设置适当调大如设置为20MB。使用支持自适应码率的播放器前端如Alist自带的播放器或通过WebDAV挂载后使用本地播放器如PotPlayer、Infuse。3. 内存或CPU占用过高原因Alist本身很轻量但如果在处理大量文件列表尤其是包含大量图片的目录且开启了缩略图生成时可能会占用较多资源。解决在“全局设置”中可以调整“缓存过期时间”适当缩短。对于不需要预览的存储可以在该存储的配置中关闭“Web代理”和“缩略图”生成。如果使用Docker可以为容器设置资源限制在docker-compose.yml中添加mem_limit,cpus等参数。4. 更新Alist版本保持更新可以获取新功能和修复。更新方法很简单Docker方式cd ~/alist # 进入你的docker-compose.yml目录 docker-compose pull # 拉取最新镜像 docker-compose up -d # 重新创建容器传统安装 去GitHub Releases页面下载新版二进制文件替换旧的然后重启systemd服务sudo systemctl stop alist # 备份旧版本后替换为新版 alist 二进制文件 sudo systemctl start alist7. 实战心得与高阶技巧经过长时间的使用和折腾我总结了一些能让Alist更好用的技巧这些在官方文档里可能不会写得这么直白。1. 关于目录结构规划不要把所有网盘都挂在根目录/下。想象一下如果你挂了5个网盘根目录就会显得杂乱。我建议采用功能或用户维度来组织/video- 专门挂载存放电影的阿里云盘或115网盘。/work- 挂载OneDrive或Google Drive存放工作文档。/backup- 挂载本地存储或另一个云盘作为备份区。 这样访问起来目的更明确管理也更清晰。2. 善用“索引”功能Alist支持为存储路径建立索引在存储编辑页面可以设置。索引后Alist会预先读取该目录下的文件列表并缓存起来下次访问时无需再向云盘API请求列表加载速度会快很多。非常适合用于存放大量小文件且不常变动的目录比如软件库、电子书文件夹。但注意如果源文件经常变动索引可能会过期。3. WebDAV的妙用Alist支持WebDAV协议这打开了无数可能性。你可以在Alist设置中启用WebDAV默认端口5245可在docker-compose.yml中映射或通过./alist server --port 5245指定。在电脑上可以用RaiDrive、NetDrive等工具将Alist的WebDAV地址挂载为一个本地磁盘像操作本地文件夹一样操作云端文件。在手机/平板使用nPlayer、Infuse、Solid Explorer等支持WebDAV的App直接播放Alist里的视频、音乐无需下载。在笔记软件中如Obsidian可以将库直接建在WebDAV挂载的盘上实现多设备同步。4. 权限管理与访客账户除了管理员你可以创建普通用户账号并为其分配特定的存储访问权限。例如创建一个“访客”账号只允许其访问/public这个存储路径下的内容。这样你就可以安全地分享部分文件给朋友而不用担心他们看到你的私人文件。5. 备份你的配置你的所有存储配置、用户信息都保存在Alist的数据目录中Docker方式下是./data目录传统安装是$HOME/.config/alist/data.db。定期备份这个目录或这个数据库文件。在升级或迁移服务器时只需恢复这个数据文件所有的配置就都回来了。我习惯在每次添加重要存储后手动备份一次。6. 结合Aria2实现离线下载Alist支持将Aria2作为下载器。你可以在服务器上安装并配置Aria2 RPC服务然后在Alist的“设置”-“Aria2”中填写RPC地址和密钥。之后在文件列表页面文件操作菜单里会出现“离线下载”选项可以将文件下载任务推送到Aria2由Aria2在后台下载到服务器指定目录再通过Alist的本地存储挂载出来分享。这适合用来做种或下载一些直链资源。部署和配置Alist的过程就像搭建一个属于你自己的数字文件枢纽。从最初的端口访问到绑定域名启用HTTPS再到精细地配置每一个存储的权限和参数每一步都让你对数据的掌控力更强。遇到下载速度慢、视频卡顿这些问题时别急着放弃十有八九是某个配置开关没找对。多翻翻Alist的文档多在社区里看看别人的讨论你总能找到解决方案。最重要的是开始动手去做在服务器上敲下第一条命令远比在脑子里想一百遍更有用。