应用介绍
OpenList 是一款开源的网盘聚合与文件服务平台,定位为 AList 的替代方案,提供便捷的多存储挂载、统一目录浏览、在线预览与外链分享能力。它支持多种主流网盘与对象存储(本地、WebDAV、S3、阿里/夸克/百度等)的整合,具备用户权限、令牌访问、直链代理、任务队列与插件生态等特色,非常适合在 NAS 上搭建统一的私有文件中心。
主要特点:
- 多存储挂载与统一目录树,跨盘检索与快速跳转
- 在线预览图片、音视频、文档等资源,移动端友好
- 令牌与外链分享、可配置的直链代理与带宽控制
- Docker 部署简便,数据目录与缓存可分离
- 社区活跃,镜像支持多变体(lite/aio/aria2/ffmpeg)

安装说明
前提依赖
- 已安装 Docker 与 Docker Compose
- 预留持久化数据目录,例如 /data/openlist/data
- 如需公网访问与 HTTPS,建议配合反向代理(Nginx Proxy Manager、Traefik、Caddy)
安装配置
以下示例使用官方镜像 openlistteam/openlist,默认 Web 端口 5244,可根据需要选择 -lite/-aria2/-ffmpeg 等变体。
version: "3.8"
services:
openlist:
image: openlistteam/openlist:latest
container_name: openlist
ports:
- "5244:5244"
environment:
- TZ=Asia/Shanghai
- UMASK=022
# 如需指定运行用户,可设置 PUID/PGID 或使用 user: "1000:1000"
volumes:
- /data/openlist/data:/opt/openlist/data
# 可选:共享目录,用于跨容器/主机交换文件
- /data/openlist/share:/opt/openlist/share
restart: unless-stopped
# 可选:指定用户运行,避免宿主机权限问题
# user: "1000:1000"
注意事项:
- 首次启动将初始化配置目录,若遇到权限报错,建议用宿主机普通用户运行(user/PUID/PGID)或修正目录属主
- 生产环境建议搭配反向代理与证书,限制公网直连下载
- 根据需要使用
openlistteam/openlist:latest-aria2实现后台下载或latest-ffmpeg进行转码预处理
使用说明
- 启动:在 docker-compose.yml 所在目录执行
docker-compose up -d - 首次访问:浏览器打开
http://NAS_IP:5244,根据引导设置管理员账户与存储挂载 - 存储挂载:在“设置-存储”中创建 WebDAV/S3/各类网盘挂载,合理配置并测试连接
- 直链与分享:按需开启令牌访问,设置外链策略与带宽限制,避免公网滥用
- 备份策略:定期备份
/opt/openlist/data;如启用 share 目录,建议独立归档