用海外云服务器搭建 OpenList（原 Alist）网盘聚合完整教程：统一 WebDAV 挂载阿里云盘/百度网盘/OneDrive（2026最新版）

Meta Description: 2026 最新 OpenList（原 Alist）网盘聚合搭建教程：海外云服务器配合 Docker 部署、挂载阿里云盘/百度网盘/OneDrive、Nginx 反代加 HTTPS、WebDAV 与 rclone 本地挂载，并附配置价格表与 10 条常见问题解答。

关键词：OpenList 搭建教程、Alist 网盘聚合、OpenList Docker 部署、挂载阿里云盘到服务器、WebDAV 挂载网盘、海外云服务器搭建网盘、OpenList Nginx 反向代理、rclone 挂载 WebDAV、OpenList 和 Alist 的区别、自建聚合网盘

前言

想在海外云服务器上用一条命令就把阿里云盘、百度网盘、115、OneDrive、Google Drive、PikPak 甚至本机磁盘目录，全部挂到同一个网页界面和同一个 WebDAV 地址下，OpenList（原 Alist）是当下最省事的方案：它本身并不存储文件，只做「多家网盘 → 统一协议」的聚合与中转，一条 Docker 命令即可启动，再配一个 Nginx 反代加 HTTPS 域名，就得到一个完整的私有网盘网关。本文给出一份可直接复制执行的完整教程，覆盖服务器选型、Docker Compose 部署、挂载第一个网盘、Nginx + Let's Encrypt 反向代理、WebDAV/rclone 把网盘挂成本地磁盘，最后附一份配置价格对比表和 10 条常见问题解答。

🚀 需要一台海外云服务器来跑 OpenList？通过 5.chengzicloud.cloud 购买阿里云国际版 / 腾讯云国际版 / AWS，享专属折扣。

一、先搞清楚：OpenList 到底是什么，和 Alist 什么关系

OpenList 是一个用 Go 写的高性能文件列表/网盘聚合程序，它的前身就是大名鼎鼎的 Alist。它的定位不是「网盘」，而是「网盘之上的统一入口」：你把自己在各家网盘里的账号挂进去，它把不同厂商千奇百怪的 API 抽象成同一套文件接口，对外同时暴露网页界面、WebDAV 和直链，于是你在任何设备上只需要记一个地址、一套账号，就能访问全部网盘。

这一节先回答「该装哪个」，再划清它和站内其他自建方案的边界。

1.1 为什么是 OpenList 而不是继续用 Alist（2025 年那场信任事件的来龙去脉）

Alist 原项目由独立开发者维护（仓库 alist-org/alist，AGPL-3.0 协议）。2025 年 6 月前后，项目发生所有权与治理层面的变更，社区随之产生信任担忧：官方迁移文档明确写道，原作者的 API 服务可能已被第三方接管，存在信息泄露或账号被封禁的风险，并据此建议用户迁移。为对冲这一风险，社区核心贡献者另起炉灶，建立了由社区长期治理的 OpenList 项目（2025 年 6 月 11 日建库，仓库 OpenListTeam/OpenList），其在 README 中自我定位为「a resilient, long-term governance, community-driven fork of AList — built to defend open source against trust-based attacks」（一个面向长期治理、由社区驱动、用于抵御基于信任的攻击的 Alist 分叉）。

对打算新部署的人来说，结论很简单：

注意版本线差异：OpenList 走的是 v4，Alist 走的是 v3，两者数据目录结构不同。存量 Alist 用户想迁移，要走 OpenList 官方提供的「Migrate from AList V3」迁移文档，而不是直接把数据目录覆盖过去。本文全部以 OpenList v4 为准编写。

1.2 边界表：它跟站内这些自建方案各管什么

本站已经写过不少自建服务，先看这张表，避免把 OpenList 当成 Nextcloud 的重复品：

一句话划界：本文只讲「怎么把多家网盘聚合成一个入口并挂到本地」，不重复讲私有网盘同步、也不重复讲对象存储本身的搭建。

1.3 它能做什么、做不到什么（先看官方边界，再决定要不要装）

能做的：官方文档当前列出约 70 个存储驱动条目，既包含阿里云盘 Open、百度网盘、115、123 云盘、天翼云盘、OneDrive、Google Drive、Dropbox、Mega、PikPak 这类网盘，也包含 local 本地目录、WebDAV、S3、FTP、SMB、GitHub Releases 等通用驱动；对外统一提供网页界面、WebDAV 和直链下载。

做不到的（这几条官方口径请务必记住）：

1. 它不存储文件。 文件始终在原来的网盘上，OpenList 只做索引与中转。所以「OpenList 容量」等于「你所有网盘容量之和」，但它自己的服务器磁盘只存一点点元数据。
2. 它依赖各家网盘的开放 API 与令牌，厂商一旦调整接口或风控，对应驱动可能失效——这不是 OpenList 的 bug，而是这类聚合工具的固有风险。
3. 它不做多人协作、版本历史、在线编辑，这些是 Nextcloud / ONLYOFFICE 的活。
4. 直连还是中转，取决于驱动：部分网盘支持直链，部分只能由服务器中转，中转会消耗服务器流量并受限速影响。

二、部署前准备：服务器、系统与依赖

2.1 服务器配置怎么选（先算瓶颈在哪）

OpenList 自身极轻量——Go 静态编译、常驻内存通常只有几十 MB，它几乎不占 CPU。真正决定配置的是三件事：① 是否经常做「中转下载」，那会吃带宽和月流量；② 是否需要为「离线下载 / 临时缓存」准备本地磁盘；③ 是否用带 ffmpeg 的镜像做转码。按需求对号入座：

地域选择：如果主要挂国内网盘（阿里云盘、百度网盘），香港 / 新加坡节点直连延迟低、且不需要备案；如果主要面向欧美用户访问，则选美西或欧洲节点。

2.2 系统与依赖：先摘掉 glibc 这颗雷

官方推荐的系统是 Ubuntu 22.04 / 24.04 LTS。CentOS 7 已于 2024 年 6 月停止维护，不建议再用于新部署。原生二进制安装前先自查 glibc 版本：

ldd --version | head -1   # 原生装二进制前必查
cat /etc/os-release | head -2
free -h; df -h /

OpenList 官方 Linux 二进制对 glibc 有下限要求，CentOS 7 的 2.17 偏低，容易报 GLIBC_2.xx not found。遇到这个报错不要硬折腾，直接走 Docker 路线（本文默认就是 Docker），容器内自带运行库，与宿主发行版的 glibc 无关。

安装 Docker 官方版：

curl -fsSL https://get.docker.com | sh
systemctl enable --now docker
docker --version

2.3 放行端口与基本加固

OpenList 默认监听 5244。测试阶段可临时放行：

ufw allow 5244/tcp   # 仅测试用, 上线后应关闭

正式上线后建议关掉 5244 的公网直连，只保留 Nginx 的 80/443（见第六节），否则你的网盘入口会在公网上裸奔。更多端口与账号加固细节可参考站内《网站安全加固》一文，思路完全一致。

三、方法一：Docker Compose 部署 OpenList（推荐）

第1步：创建数据目录

mkdir -p /opt/openlist && cd /opt/openlist
mkdir -p data temp

data 存程序配置与元数据（务必备份），temp 用于临时文件与离线下载（建议放 SSD）。

第2步：编写 docker-compose.yml

services:
  openlist:
    image: openlistteam/openlist:latest
    container_name: openlist
    restart: unless-stopped
    ports:
      - "5244:5244"
    volumes:
      - ./data:/opt/openlist/data
      - ./temp:/opt/openlist/temp
    environment:
      - TZ=Asia/Shanghai
      - UMASK=022
    user: "0:0"

三点说明：

1. 镜像名是 openlistteam/openlist，不要再用旧的 alist 镜像。官方还提供带扩展工具的变体：latest-aria2（含 aria2 离线下载）、latest-ffmpeg（含转码）、latest-aio（全都要）。
2. 持久化只认 /opt/openlist/data：配置、用户、存储列表全在里面，迁移时打包这个目录即可。
3. user: "0:0" 是按容器内 root 运行。OpenList 自 v4.1.0 起默认以 openlist（UID 1001 / GID 1001）用户运行，若你希望它写入宿主机 ./data 时不报权限错误，要么保留这行用 root 跑，要么改成 chown -R 1001:1001 /opt/openlist/data（更安全的做法）。

第3步：启动并查看初始密码

docker compose up -d
docker compose logs openlist | head -40

首次启动时日志会打印一行类似 Successfully created the admin user and the initial password is: xxxxxx 的输出，这就是初始密码。如果一时没抓到，别慌，第 4.3 节有重设命令。

第4步：登录后台

浏览器访问 http://你的服务器IP:5244，用户名 admin，密码用上一步拿到的初始值。能看到文件列表界面，说明容器已经跑通，接下来只需要挂载网盘。

四、方法二：一键脚本安装（原生二进制 + systemd）

不想用 Docker，或者你的机器是 OpenRC（Alpine）而非 systemd，可以用官方一键脚本。前置条件（官方原文）：使用 systemd 或 OpenRC 的 Linux、具备 Root 权限、已安装 curl 与 tar。

第1步：下载并运行安装脚本

curl -fsSL https://res.oplist.org/script/v4.sh > install-openlist-v4.sh
sudo bash install-openlist-v4.sh

国内网络若拉取慢，可把 URL 换成镜像分支：https://res.oplist.org.cn/script/v4.sh。脚本会弹出一个中文菜单，基础功能有「1、安装 / 2、更新 / 3、卸载」，服务管理有「4、查看状态 / 5、密码管理 / 6、启动 / 7、停止 / 8、重启」，配置管理有「9、备份配置 / 10、恢复配置」，另外还有 Docker 管理、定时更新、系统状态等高级项。输入 1 即可完成安装。

第2步：用面板管理命令维护

安装完成后即可使用管理命令，openlist 与 openlist-manager 是同一个东西：

openlist-manager

出现的仍是同一个菜单，日常升级直接选「2、更新 OpenList」即可。若脚本提示「不支持你的架构」，多半是它的 CPU 架构识别没覆盖到，把 arch 和 uname -m 的输出提交到官方 issue 即可（这是官方文档明确给出的解释）。

第3步：关于手动二进制部署

如果你偏好完全手动，也可以从官方下载页取对应架构的压缩包，解压后得到 openlist 主程序，再自行编写 systemd unit。这种方式的坑集中在两点：一是前面提到的 glibc 下限，二是 OpenList 读取的是「当前工作目录」下的 data 配置——./openlist admin 和管理面板必须在同一个目录运行，否则会读到不同的数据（这条是官方 FAQ 的原话）。不确定的话，用第三节的 Docker 方式最省心。

五、初始化：设置管理员密码与挂载第一个网盘

5.1 设置或重置管理员密码

Docker 部署执行：

docker exec -it openlist ./openlist admin set 你的新密码
docker exec -it openlist ./openlist admin random   # 或者让它随机生成一个

脚本 / 原生部署则在程序所在目录执行 ./openlist admin set 你的新密码。官方 FAQ 特别提醒：如果拿到的密码总是不对，先检查你运行 ./openlist admin 的目录和启动 OpenList 的目录是否一致——它默认只读当前目录下的配置。

5.2 添加第一个网盘（以阿里云盘 Open 为例）

登录后台 → 左侧「存储」→ 右上角「添加存储」，然后：

1. 驱动选择「阿里云盘(Oauth2)」；
2. 挂载路径填一个短名字，例如 aliyun-drive（它决定你在文件列表里看到的目录名）；
3. 根文件夹 ID默认为 root（展示全部内容）；若只想展示某个文件夹，打开阿里云盘官网进入该文件夹，取 URL 末段那串字符即可，例如 https://www.alipan.com/drive/folder/5fe01e18...b5bf7940 的 file_id 就是 5fe01e18...b5bf7940；
4. 刷新令牌按驱动文档「准备接入」一节获取后粘贴；
5. 普通人用官方提供的 OAuth 客户端即可：勾选「Use online api」，「客户端 ID」和「应用密钥」留空，「Api url address」填 https://api.oplist.org/alicloud/renewapi（若走公益/自建服务器则填对应地址）。若你申请了自己的 AppId/AppSecret，则不要勾选 Use online api，改填自己的 ClientID / Secret，并清空 Api url；
6. 其他可选项（秒传、移除方式、云盘类型、Livp 下载格式、内部上传）按需设置，默认即可；
7. 点「添加」完成。

百度网盘、115、123 云盘、OneDrive、Google Drive 等的添加流程完全同构：选驱动 → 填挂载路径 → 粘贴该驱动的令牌/密钥 → 保存。每个驱动都有独立的官方文档页（共约 70 个条目），字段含义以对应页面为准。

5.3 更简单的起步：先挂一个「本机存储」验证链路

如果你只是想先跑通，可直接添加 local 驱动：挂载路径填 server-files，根文件夹路径填 /opt/files（先在宿主机 mkdir -p /opt/files 并放几个文件）。这样不依赖任何第三方网盘 API，能把「界面 → 目录 → 下载」整条链路验证一遍，再逐个接入真实网盘。

5.4 让 WebDAV 能用：别忘了配用户权限

OpenList 的 WebDAV 默认挂在 /dav 路径下，但一个用户默认可能没有任何目录权限，表现为连上就 401/403 或看不到目录。修正位置：后台「用户」→ 编辑 admin（或新建专用账号）→ 设置「基础路径」（如 /）并勾选「WebDAV 读取」「WebDAV 写入」。最小权限原则：给 WebDAV 单独建一个只能读某几个挂载路径的账号，别直接用 admin。

🚀 需要海外云服务器来部署 OpenList？通过 5.chengzicloud.cloud 购买阿里云国际版 / 腾讯云国际版 / AWS，享专属折扣。

六、绑定域名：Nginx 反向代理 + Let's Encrypt HTTPS

裸 IP + 5244 端口只适合测试，正式使用一定要套上域名和 HTTPS：一是 WebDAV 与播放器大量使用 Basic 认证，明文传输等于把密码写在明信片上；二是浏览器对非 HTTPS 站点会有各种限制。

第1步：准备域名解析

把 pan.example.com 的 A 记录指向你的服务器 IP。若走 Cloudflare 代理，记得下载证书那段要先切到「仅 DNS」（灰云），签发完再开小黄云。

第2步：先签证书

apt install -y certbot python3-certbot-nginx
certbot certonly --nginx -d pan.example.com

第3步：写入 Nginx 站点配置

server {
    listen 80;
    server_name pan.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    http2 on;
    server_name pan.example.com;

    ssl_certificate     /etc/letsencrypt/live/pan.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/pan.example.com/privkey.pem;

    client_max_body_size 0;
    proxy_max_temp_file_size 0;
    proxy_buffering off;

    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_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}

三个关键点，全部来自官方文档：

1. client_max_body_size 0：否则上传大文件会被 Nginx 413 拦下。
2. proxy_max_temp_file_size 0 与 proxy_buffering off：Nginx 默认会先把远程文件缓存到本机磁盘再回传，对网盘这种「大文件流式播放」场景会导致播放失败甚至打满磁盘。如果你用宝塔面板，还要额外删掉它默认注入的 location ~ .\.(gif|jpg|png|swf)$、location ~ .\.(js|css)?$ 这类静态资源缓存规则（宝塔的默认配置会强行给这些后缀加缓存），否则视频/图片类文件名会被当成静态资源缓存下来。
3. Host 变量的选择：$host 不含端口，用非 80/443 端口时要用 $host:$server_port；官方明确不推荐 $http_host（Host 头缺失时为空）。

改完 nginx -t && systemctl reload nginx。

第4步：上线前加固

• 关掉 5244 的公网直连：ufw delete allow 5244/tcp，只保留 80/443；
• 给 OpenList 后台账号换成强密码并开启 2FA（后台「设置 → 其他」里有两步验证）；
• WebDAV 单独建最小权限账号，不要直接用 admin（见 5.4）。

七、把网盘挂成「本地磁盘」：WebDAV + rclone

这才是网盘聚合真正好用的地方：任何支持 WebDAV 的客户端，都能把聚合后的网盘当成一块磁盘。

7.1 WebDAV 连接参数（官方口径）

权限要点：只读要在用户权限里开启「WebDAV 读取」；要写入必须同时开启「WebDAV 管理」以及其计划执行操作所需的具体文件系统权限（重命名、删除、复制、创建目录或上传等）——只开「WebDAV 管理」是不够的。另有一条官方已知限制：复制时暂不支持重命名。

7.2 用 rclone 挂载（Linux / Windows 通用）

安装 rclone 后创建配置，--dav-user / --dav-pass 直接写在命令里：

curl https://rclone.org/install.sh | sudo bash

rclone config create openlist webdav \
  url=https://pan.example.com/dav vendor=other \
  user=webdav-user pass=$(rclone obscure '你的密码')

rclone lsd openlist:

对拷到本地目录：

sudo apt install -y fuse3
mkdir -p /mnt/openlist
rclone mount openlist: /mnt/openlist --vfs-cache-mode writes --daemon

--vfs-cache-mode writes 能显著提升写入兼容性（否则很多程序直接写会失败）。要让非 root 用户也能读，需要在 /etc/fuse.conf 里打开 user_allow_other，并给 mount 加 --allow-other。

7.3 开机自动挂载（systemd）

[Unit]
Description=Mount OpenList WebDAV
After=network-online.target

[Service]
Type=notify
ExecStart=/usr/bin/rclone mount openlist: /mnt/openlist --config /root/.config/rclone/rclone.conf --vfs-cache-mode writes --allow-other
ExecStop=/bin/fusermount -u /mnt/openlist
Restart=on-failure

[Install]
WantedBy=multi-user.target

systemctl daemon-reload
systemctl enable --now rclone-openlist
df -h | grep openlist

Windows 端推荐 RaiDrive 或 Mountain Duck 挂成盘符；Android 端可用 Solid Explorer / MiXplorer；媒体播放器（PotPlayer、Kodi）可直接填 WebDAV 地址在线播放。

八、进阶玩法：让 OpenList 更像一台「私有云」

基础部署跑通后，官方还提供了一批开箱能力，按需开启即可，无需额外装软件：

几点实操提醒：

• 离线下载必须用带 aria2 的镜像（latest-aria2 或 latest-aio），普通 latest 镜像里没有 aria2，开了也用不了。
• 目录列表默认有约 30 分钟缓存（可在存储设置里改），所以刚上传的文件可能不立刻出现；要马上看到，在目录右下角点一下刷新按钮即可。
• STRM 玩法的本质：把网盘文件变成「播放指针」交给 Jellyfin / Emby，播放时媒体流仍从网盘直链拉取，服务器不落盘，因此小机器也能撑起网盘影音库。
• 配置与元数据全在 /opt/openlist/data，用后台自带的「备份配置」导出，或直接打包该目录，两种方式都可以；备份周期建议与站内《服务器备份与容灾》一文保持一致。
• 若把 OpenList 暴露给团队使用，记得先在「用户」里按人建账号、按目录授最小权限，而不是所有人共用 admin。

九、海外云服务器配置推荐与价格对比

OpenList 本身很省资源，选机器时真正要权衡的是带宽和流量（决定中转下载与在线播放是否顺畅）与磁盘（决定能否做离线下载和缓存）。下表是常见海外云厂商的公开报价区间，配置按「OpenList 网盘聚合」场景标注。

\* Lightsail 低档的 2 vCPU 为突发型（burstable），长期满载时会回落到基准性能；DigitalOcean、阿里云、腾讯云的国际版价格因机房、活动、计费方式差异较大，表中给的是常见公开区间，下单前请以官网实时价为准。

声明：本文价格数据采集于 2026 年 10 月，仅为公开官网参考区间，实际以各家官网实时价格为准，金额单位均为美元（USD）。

针对 OpenList 的选型建议：

• 只挂网盘、看网页、偶尔下载：任何 1 核 1G 的香港/新加坡小鸡都能跑，重点是选流量大的（≥1TB/月）。
• 多设备 WebDAV 网关 + 中转下载：2 核 2G、带宽 30Mbps 以上、流量 3TB 起，性价比最高。
• 离线下载 / 大文件缓存：至少 2 核 4G + 80GB SSD，并且尽量选本地 SSD 而非网络盘，否则离线下载的磁盘 IO 会拖垮体验。

🚀 需要海外云服务器来部署 OpenList？通过 5.chengzicloud.cloud 购买阿里云国际版 / 腾讯云国际版 / AWS，享专属折扣。

推荐方案

综合成本与体验，给两套可以直接照抄的组合：

方案 A：轻量聚合（预算优先）

• 香港/新加坡节点，1 核 1G、25GB SSD、1TB 月流量；
• Docker Compose 单容器部署 OpenList（第三节），挂阿里云盘 + 百度网盘；
• Nginx + Let's Encrypt 提供 HTTPS；
• 只做浏览与直链播放，不做离线下载。适合个人自用、3～5 人小团队。

方案 B：WebDAV 网关 + 离线下载（体验优先）

• 2 核 2G～4G、60～80GB SSD、3TB 以上月流量；
• 镜像换成 openlistteam/openlist:latest-aria2，启用离线下载；
• WebDAV 建独立最小权限账号，rclone 挂到 NAS / 服务器 / 本地电脑（第七节）；
• 后台开 2FA，5244 端口不对外暴露，只走 443。

部署后的日常维护：定期备份 /opt/openlist/data 目录（配置与元数据全在这里）；关注官方仓库的更新以跟进网盘 API 变更；Outlook/OneDrive 这类驱动需要留意令牌失效。备份思路与站内《服务器备份与容灾》一文一致。