少女祈祷中...

文章背景图

【NAS教程】docker部署开源网盘聚合工具openlist

2025-07-10
11
-
- 分钟
image-fuvr.avif

一、什么是 OpenList

OpenList 是一款开源的网盘聚合管理工具,由 AList 原贡献者在 AList 项目被收购后发起的分叉项目,旨在规避商业化后可能出现的闭源或信任风险。该项目支持 Windows、macOS、Linux、Android、iOS 多平台运行,集中管理阿里云盘、123 云盘、OneDrive、本地存储等多种网盘服务,提供文件预览、WebDAV 协议访问、暗黑模式切换、路径密码保护等功能。相较于原版 AList,OpenList 重构了开源 API 系统,移除了潜在风险代码,开发流程由社区驱动并保持透明。

GitHub 项目地址:OpenListTeam/OpenList

二、OpenList 的功能特性

2.1 多网盘管理与存储支持

  • 支持阿里云盘、123 云盘、OneDrive、Google Drive、夸克网盘、天翼云盘等 20 余种主流网盘,同时兼容本地存储及 FTP/SFTP 服务。

  • 所有存储均可通过 WebDAV 协议挂载,方便与第三方工具(播放器、文档编辑器等)集成。

  • 支持多线程下载、离线下载、跨网盘文件互拷及批量操作。

2.2 安全与隐私保护

  • 可为指定文件夹设置独立密码或身份验证,限制未授权访问。

  • 重构开源 API 系统,移除了原 AList 中疑似风险代码,确保代码透明。

2.3 用户体验

  • Web 端支持暗黑模式切换,原生客户端覆盖 Windows、macOS、Linux、Android、iOS。

  • 支持主题切换、多语言(含简体中文)。

  • 视频、音频、Office 文档、图片等格式支持在线预览,无需下载。

  • 文件打包下载由浏览器端直接完成,无需服务器端压缩。

  • 桌面客户端集成实时日志查看、服务监控和随机密码生成功能。

2.4 部署与扩展

  • 支持 Docker 一键部署、手动配置及源码编译。

  • 可整合 CloudSaver 等资源搜索工具和网盘播放器,构建私人云存储中心。

  • 提供 API 扩展接口,支持自定义插件开发。

2.5 社区与维护

  • 采用 AGPL-3.0 协议,代码托管于 GitHub,社区持续审查更新。

  • 支持从 Alist 备份配置无缝导入,降低迁移成本。

三、安装教程(推荐使用 Docker Compose 部署)

3.1 在 docker 目录下创建 openlist 文件夹,并在其中创建 data 和 openlist-local 子目录

image-cIrO.avif

3.2 在绿联 NAS 中打开 Docker,点击"项目"→“创建”,粘贴以下配置文件,注意修改文件夹路径

version: '3.3'
services:
  openlist:
    image: openlistteam/openlist:latest         # 稳定版:latest;开发版:beta
    container_name: openlist                     # 容器名称
    volumes:
      - /volume3/docker/openlist/data:/opt/openlist/data     # 配置文件存放路径,请根据实际修改
      - /volume3/docker/openlist/openlist-local:/mnt          # 本地存储挂载路径,请根据实际修改
    ports:
      - 5244:5244                                # 映射主机的 5244 端口到容器内的 5244 端口,端口冲突请修改
    environment:
      - PUID=0                                   # 根据实际用户 ID 修改
      - PGID=0                                   # 根据实际用户组 ID 修改
      - UMASK=022                                # 文件权限掩码
      - TZ=Asia/Shanghai                         # 时区设置
    restart: always                              # 容器自动重启
    network_mode: bridge                         # 容器网络桥接

注意:镜像标签 latest 对应稳定版,如需使用开发版请改为 beta。配置文件中的注释为说明用途,实际使用时建议删除中文注释以避免 YAML 解析问题。

3.3 项目名称填写 openlist,存放路径选择刚创建的 openlist 文件夹,点击立即部署,等待镜像拉取完成

如果镜像拉取失败,请参考其他绿联镜像加速教程。

image-OakZ.avif

3.4 镜像拉取成功后,在浏览器输入 NAS 地址加端口号(如http://192.168.5.2:5244),进入登录页面

image-vrxH.avif

3.5 在容器日志中查看初始账号和密码,登录成功即部署完成

  • 默认账号:admin

  • 初始密码:OpenList 不设固定默认密码,部署完成后会在日志中生成一个随机密码,需要从容器日志中获取。

image-phuL.avif

四、设置和使用教程

4.1 点击"管理",首先修改默认登录账号和密码

image-golI.avif

4.2 挂载网盘(以天翼云盘为例)

点击"存储"→“添加”,驱动选择"天翼云盘客户端"。

其他网盘挂载教程请参考官方文档:OpenList 文档

image-hsdf.avif

4.3 挂载路径选择个人文件夹,填写网盘用户名和密码,类型选择个人云;非会员需打开家庭转移开关

image-luAM.avif

4.4 点击保存,状态显示 work 即表示挂载成功,返回主页即可查看网盘文件

image-NUdO.avif
image-YxJX.avif

五、绿联 NAS 通过 WebDAV 挂载 OpenList 网盘

5.1 打开文件管理,点击"+“,选择"连接网络文件夹”

image-VBFX.avif

5.2 按下图设置:填写 OpenList 的地址和端口,以及 OpenList 的账号密码(注意不是网盘账号密码)

image-PdyP.avif

5.3 连接成功后,通过文件管理即可直接访问网盘文件

image-JHHB.avif

六、总结

本文介绍了在绿联 NAS 上通过 Docker Compose 部署 OpenList 的完整流程,涵盖安装、初始配置、网盘挂载以及通过 WebDAV 协议接入 NAS 文件管理的操作步骤。

OpenList 作为 AList 的社区分叉版本,继承了原项目的多网盘聚合管理能力,并在此基础上重构了 API 系统、移除了可疑代码。项目采用 AGPL-3.0 协议,代码完全开放,由社区维护迭代。对于 NAS 用户和需要统一管理多个网盘的个人或团队,OpenList 提供了一个直接可用的方案。

如果你有任何问题或建议,欢迎在评论区留言交流。感谢阅读!

AI

【NAS教程】docker部署开源网盘聚合工具openlist

本文链接: 【NAS教程】docker部署开源网盘聚合工具openlist

本文包含 AI 辅助内容 ,使用 ChatGPT 参与 资料整理,排版辅助 ,已由作者审核。

本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

评论交流

文章目录