适合谁：手里散落着百度网盘、阿里云盘、夸克、OneDrive 或对象存储，受够了在不同客户端之间来回切换，想要一个全网资源统一网页、支持 WebDAV 本地盘挂载与 4K 影音免下载串流的极客玩家。

支持系统：Debian 11/12/13、Ubuntu 20.04/22.04/24.04 LTS（基于 Docker 纯净容器化运行，小内存 VPS 均可流畅跑起）。

耗时预期：约 15 ~ 20 分钟（跟着一步步敲完，轻松拥有属于你的“全网私有云盘枢纽”）。

做完你将得到：一个现代化的 AList 网盘聚合系统；学会挂载国内外各大网盘、开启 302 直链免服务器带宽极速下载；将网盘通过 WebDAV 挂进电脑当本地硬盘，手机电视用 Infuse / PotPlayer 秒播原画！

⚠️ 全程唯一保命铁律：
在添加网盘存储时，下载代理模式优先选择「302 重定向」！ 开启后所有下载流量直接由网盘官方 CDN 承载，不仅速度拉满，而且完全不消耗你服务器的宝贵带宽与流量。

🧭 核心概念：什么是“网盘聚合”？（大白话解密）

很多新手以为搭建 AList 是要租一个几十 TB 的大服务器，其实完全不是！

TEXT 
┌─────────────────────────────────────────────────────────────┐
│ 🔑 核心真相：AList 本身不存任何文件！                         │
│    - 它是一个极度轻量的「超级路由器 / 万能聚合总指挥」；       │
│    - 无论你有 10TB 阿里、2TB 百度还是 5TB Google Drive；       │
│    - 全部通过 API 统一汇聚到同一个网页仪表盘中；             │
│    - 只需要 100MB 内存的小 VPS，就能撬动全网上百 TB 的云端资源！│
└─────────────────────────────────────────────────────────────┘

📋 开始前的准备清单（缺一项都别往下走）

  • 一台云服务器（VPS）：已安装官方 Docker 与 Compose 引擎；
  • 一个已解析的域名：例如将 pan.example.com 的 A 记录指向你的服务器 IP；
  • 至少一个网盘账号：阿里云盘、夸克网盘、百度网盘、OneDrive 或 WebDAV 服务。

第 1 步：一键生成 AList 极简 Docker Compose 配置

我们将数据与配置牢牢挂载在宿主机，防止容器升级时配置丢失。

💻 【你本地的电脑】 打开终端连入服务器，进入 🖥️ 【服务器窗口】。

整段复制并执行以下自包含防呆部署脚本（绝不需要手动碰 vim）：

BASH 
# 1. 创建 AList 专属数据目录
mkdir -p /opt/alist && cd /opt/alist

# 2. 写入干净纯净的 Compose 编排清单
cat << 'EOF' > /opt/my-alist/docker-compose.yaml
version: '3.3'
services:
  alist:
    image: 'xhofe/alist:latest'
    container_name: alist
    restart: unless-stopped
    volumes:
      # 数据持久化目录（存储元数据与配置）
      - /opt/alist/data:/opt/alist/data
    ports:
      # 绑定本地 5244 端口，准备供 Nginx 反向代理接入
      - '127.0.0.1:5244:5244'
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022
EOF

# 兼容软链接
mkdir -p /opt/my-alist
ln -sf /opt/my-alist/docker-compose.yaml /opt/alist/docker-compose.yaml 2>/dev/null || true

# 3. 检查编排文件
ls -lh /opt/alist/docker-compose.yaml
  • ✅ 成功标志：终端显示 /opt/alist/docker-compose.yaml 已成功生成。
  • 💡 安全设计：端口绑定为 127.0.0.1:5244，仅内网可通，外部流量稍后由 Nginx 统一加密代理，黑客无法通过非标端口直接撞库。

第 2 步：一行命令启动并获取专属初始密码

启动容器只需要敲一个命令：

🖥️ 【服务器窗口】 执行一键后台启动：

BASH 
cd /opt/alist
docker compose up -d

启动后，AList 官方安全机制会在首次运行时自动随机生成一个强密码。

我们直接运行官方命令一秒强制重置为一个好记的强密码：

BASH 
# 将末尾的 MySuperPassword2026 换成你自己的强密码！
docker exec -it alist ./alist admin set MySuperPassword2026
  • ✅ 成功标志：终端屏幕直接打印出：
    TEXT 
    Successfully update password:
username: admin
password: 你的新密码

⚠️ 关键动作：立刻把用户名 admin 和刚才设定的密码保存在你本地的便签中！

第 3 步：配置 Nginx 大文件专用反向代理

AList 涉及到 GB 级的大文件下载与流媒体串流传输，Nginx 反代配置必须关闭缓冲区限制，并放行大文件！

🖥️ 【服务器窗口】 先定义你的域名变量：

BASH 
MY_DOMAIN="pan.example.com"

接着，整段执行专门针对 AList 调优的专用网关脚本：

BASH 
cat << EOF > /etc/nginx/sites-available/${MY_DOMAIN}.conf
server {
    listen 80;
    listen [::]:80;
    server_name ${MY_DOMAIN};

    # 关键调优：放行极大文件上传（0 代表完全不限制文件体积）
    client_max_body_size 0;

    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_buffering 缓冲区！
        # 防止大文件视频串流或下载时，Nginx 在本地磁盘堆积海量临时缓存
        proxy_buffering off;
        proxy_request_buffering off;

        # 超时时间调大，保证超大文件传输不断连
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}
EOF

# 激活配置并平滑重载
ln -sf /etc/nginx/sites-available/${MY_DOMAIN}.conf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
  • ✅ 成功标志：终端打印出 test is successful，网关平滑生效！

第 4 步：登录 AList 后台并添加你的第一个网盘

💻 【你本地的浏览器】 打开你的域名（例如 http://pan.example.com）：

  1. 点击网页底部的 「管理」 按钮；
  2. 输入账号 admin 与刚才设置的密码，成功进入 AList 管理大盘；
  3. 点击左侧菜单 「存储」➔「添加」：
    • 驱动：选择你想挂载的网盘（例如：阿里云盘 OpenAPI、夸克网盘、百度网盘 或 本地存储）；
    • 挂载路径：填在前端展示的文件夹名字（例如 /阿里云盘）；
    • 网页 Web 代理 / 302 重定向：⚠️ 重点避坑！优先选择「302 重定向」（直链走网盘官方 CDN，不消耗你 VPS 一丁点流量！）；
    • 按照界面右侧的官方提示，填入网盘的 Token 或扫码授权；
  4. 点击最下方的 「添加」！
  • ✅ 成功标志：存储列表中该网盘状态显示为绿色的 work，回到首页即可看到文件夹，点进去所有文件一览无余，双击视频秒级原画开播！

🎁 进阶杀手锏：用 WebDAV 把网盘挂成电脑本地硬盘

AList 原生自带强大的 WebDAV 服务器，你可以把聚合后的全网资源直接挂载进 Windows 的“此电脑”或 Mac 的 Finder 中，像操作本地 C 盘、D 盘一样拖拽文件：

  • WebDAV 地址：https://你的域名/dav/
  • 用户名 / 密码：你的 AList 管理员账号密码（或在后台单独创建子用户）；
  • 在客户端中挂载：
    • 🖥️ Windows 用户：推荐使用免费神盾工具 RaiDrive，添加 WebDAV 驱动器，盘符选 Z:，直接在资源管理器里无缝拖拽！
    • 📱 电视盒子 / 手机影音：在 Infuse、Kodi 或 PotPlayer 里添加 WebDAV 资源库，海报墙全自动刮削，蓝光 4K 秒开看大片！

🚑 翻车急救站（新手挂载常见翻车速查）

异常现场真实根因对应一秒救命招式
忘记管理员密码，进不去后台随机密码未保存服务器敲 docker exec -it alist ./alist admin set 新密码，秒级生效。
大文件下载速度极慢，把 VPS 带宽跑满误把存储策略选成了“本地代理 (Proxy)”进入存储设置，将 Web 代理方式切回 「302 重定向」，流量立刻直连网盘官方极速 CDN！
上传超过 100MB 文件报错或被掐断套了 Cloudflare 免费版触发了 100MB 单文件限制在 Cloudflare 控制台把网盘二级域名的代理小云朵切为灰云（仅 DNS 解析），即可突破体积限制。
阿里云盘或夸克提示 Token 过期授权 Refresh Token 失效重新获取最新 Token 粘贴进存储配置保存，AList 会自动恢复连接。

🎓 毕业全维度自检清单

核对以下 5 项指标，全部通过即代表你的 AList 私有云盘枢纽已达生产级标准：

  • 域名安全访问：浏览器访问专属域名能正常打开，地址栏显示安全小绿锁；
  • 管理权限自主可控：能够自如重置管理密码并进入后台配置存储策略；
  • 302 直链提速就位：下载测试文件速度拉满，VPS 出口流量不被消耗；
  • 大文件传输不崩溃：Nginx 反代配置了 proxy_buffering off;，长时间播放大视频无缓冲中断；
  • 跨端串流闭环：在手机或电脑播放器中通过 WebDAV 连通 AList，实现无需下载即点即播！