归档 215

893 字

4 分钟

2026 必看！除了 Alist，这款开源 OpenList 聚合程序更适合你的 NAS

2026-02-11

部署教程

nas

alist

一、OpenList 是什么？#

OpenList 是一个开源的网盘聚合程序（原 Alist 分支项目之一），支持将：

本地存储
WebDAV
阿里云盘
OneDrive
Google Drive
S3
FTP
123云盘等

统一挂载为一个网页文件列表，支持：

在线预览
视频播放
外链分享
WebDAV 挂载
API 调用

适合：

家庭 NAS
云盘聚合
影视资源站
个人网盘目录

二、部署方式选择#

推荐使用：

方式	推荐指数	适合人群
Docker 部署	⭐⭐⭐⭐⭐	所有人

可以参考用 Proxmox VE 管理多台 Docker 主机。 | Docker Compose | ⭐⭐⭐⭐⭐ | 服务器 | | 二进制运行 | ⭐⭐⭐ | 极简环境 | | 宝塔部署 | ⭐⭐ | 小白 |

本教程以 Docker 部署 为主。

三、Docker 部署 OpenList#

创建数据目录#

1
mkdir -p /opt/openlist
2
cd /opt/openlist

拉取镜像#

1
docker pull openlistteam/openlist:latest

运行容器#

1
docker run -d \
2
  --name openlist \
3
  -p 5244:5244 \
4
  -v /opt/openlist:/opt/openlist/data \
5
  --restart=always \
6
  openlistteam/openlist:latest

说明：

5244 是默认端口
数据目录必须映射，否则重启会丢失配置
—restart=always 防止服务器重启后服务丢失

访问后台#

浏览器打开：

1
http://服务器IP:5244

首次登录默认：

用户名：admin
密码：查看日志获取

查看密码：

1
docker logs openlist

你会看到：

1
initial password is: xxxxxxxx

登录后立即修改密码。

四、添加存储#

进入后台：管理 → 存储 → 添加

常见示例：

本地存储#

类型：Local
挂载路径：/
本地路径：/mnt

⚠️ 记得 Docker 要映射该目录：

1
-v /mnt:/mnt

WebDAV#

URL
用户名
密码

适合挂载群晖、Nextcloud、InfiniCLOUD 等。

阿里云盘#

需要：

刷新令牌（refresh_token）

获取方式：

使用第三方工具获取 refresh_token。

五、使用 Docker Compose（推荐）#

创建 docker-compose.yml：

1
version: '3.3'
2
services:
3
  openlist:
4
    image: openlistteam/openlist:latest
5
    container_name: openlist
6
    ports:
7
      - "5244:5244"
8
    volumes:
9
      - ./data:/opt/openlist/data
10
    restart: always

启动：

1
docker compose up -d

优点：

更方便升级
结构清晰
便于多容器管理

六、反向代理 + 域名 + HTTPS#

可以参考用 Nginx Proxy Manager 统一管理。

使用 Nginx#

安装 Nginx 后添加配置：

1
server {
2
    listen 80;
3
    server_name yourdomain.com;
4

5
    location / {
6
        proxy_pass http://127.0.0.1:5244;
7
        proxy_set_header Host $host;
8
        proxy_set_header X-Real-IP $remote_addr;
9
    }
10
}

重启：

1
systemctl restart nginx

配置 HTTPS（推荐）#

使用 Certbot：

1
certbot --nginx -d yourdomain.com

即可自动生成 HTTPS。

七、Cloudflare Tunnel（无需公网IP）#

如果没有公网IP，可以：

使用 Cloudflare Tunnel
绑定到 5244
通过域名访问

优点：

不暴露真实IP
无需端口转发
免费

八、开启 WebDAV 功能#

后台：设置 → WebDAV → 启用

地址：

1
http://IP:5244/dav

可以挂载到：

Windows 网络驱动器
Kodi
VLC
Infuse

九、安全优化建议#

修改默认端口#

不要暴露 5244

改为：

1
-p 127.0.0.1:5244:5244

然后走反向代理。

启用登录验证#

后台：设置 → 安全 → 启用鉴权

禁止匿名访问#

关闭：

公开访问
目录列表

防火墙限制#

只允许 80/443：

1
ufw allow 80
2
ufw allow 443

十、升级 OpenList#

Docker 升级#

1
docker pull openlistteam/openlist:latest
2
docker stop openlist
3
docker rm openlist

重新 run 或 docker compose up -d

数据不会丢失（因为映射了目录）。

十一、常见问题#

启动后打不开？#

检查：

1
docker ps
2
docker logs openlist

是否端口被占用？

视频无法播放？#

可能原因：

存储不支持直链
需要开启签名
反向代理没设置 Range 头

Nginx 添加：

1
proxy_set_header Range $http_range;
2
proxy_set_header If-Range $http_if_range;

数据丢失？#

没有映射 data 目录。

必须：

1
-v ./data:/opt/openlist/data

CPU 占用高？#

关闭缩略图
关闭视频转码
检查是否被爬虫扫描

十二、进阶玩法#

配合 rclone
挂载 115
做影视站
API 接入
做直链中转

音乐