一、项目简介

OpenList 是一个开源的文件列表与网盘聚合管理系统，可以把各种存储（本地、云盘、对象存储等）统一成一个 Web 文件管理界面。

项目地址：
https://github.com/OpenListTeam/OpenList

---

✨ 核心功能

OpenList 的主要能力包括：

• 📁 多存储统一管理（本地 / WebDAV / 云盘）
• 🌐 Web 文件浏览器
• 🔗 支持分享链接生成
• 📦 可扩展插件生态
• 🔐 支持账号登录与权限控制
• ⚡ 高性能 Go 语言后端
• 🐳 Docker 一键部署

---

二、OpenList 架构说明

OpenList 本质是一个：

“云盘 + 文件管理器 + WebDAV 服务”

运行结构如下：

浏览器（Web UI）
      ↓
OpenList 后端服务（Go）
      ↓
存储驱动层（本地 / 云盘 / WebDAV）
      ↓
文件系统 / 云存储

---

三、环境要求

安装前请确保：

• Docker 已安装（推荐 20+）
• Docker Compose（推荐）
• Linux / Windows / macOS / NAS
• 端口：5244（默认）

---

四、Docker 一键安装（推荐）

1. 创建数据目录

mkdir -p /etc/openlist

---

2. 运行 OpenList 容器

docker run -d \
  --name openlist \
  -p 5244:5244 \
  -v /etc/openlist:/opt/openlist/data \
  -e PUID=0 \
  -e PGID=0 \
  -e UMASK=022 \
  --restart unless-stopped \
  openlistteam/openlist:latest

---

3. 访问 Web 界面

浏览器打开：

http://localhost:5244

服务器访问：

http://你的IP:5244

---

五、Docker Compose 部署（推荐生产）

创建 docker-compose.yml：

version: "3.3"

services:
  openlist:
    image: openlistteam/openlist:latest
    container_name: openlist
    ports:
      - "5244:5244"
    volumes:
      - ./data:/opt/openlist/data
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022
    restart: unless-stopped

启动：

docker compose up -d

---

六、首次登录与管理员密码

1. 查看管理员密码

运行：

docker logs openlist

你会看到类似：

initial password is: xxxxxxxx

---

2. 登录系统

打开：

http://IP:5244

使用：

• 用户名：admin
• 密码：日志中生成

---

3. 修改密码

进入容器执行：

docker exec -it openlist ./openlist admin set NEW_PASSWORD

---

七、常见功能使用

1. 添加存储（核心功能）

支持：

• 本地磁盘
• WebDAV
• S3 / 对象存储
• 各类云盘插件

---

2. 文件管理

OpenList 可以：

• 在线浏览文件
• 上传 / 下载
• 生成分享链接
• WebDAV 挂载

---

3. WebDAV 访问

可挂载到：

• Windows 资源管理器
• macOS Finder
• 手机文件管理器

地址：

http://IP:5244/dav

---

八、端口与安全建议

1. 修改端口

-p 8080:5244

---

2. Nginx 反代（推荐）

用于：

• 域名访问
• HTTPS
• 防止端口暴露

---

3. 安全建议

• 修改默认密码
• 不暴露公网端口（或加防火墙）
• 使用 HTTPS
• 限制访问 IP（生产环境）

---

九、更新 OpenList

Docker 更新方式

docker pull openlistteam/openlist:latest
docker stop openlist
docker rm openlist
docker run -d ...（重新运行）

---

Compose 更新方式

docker compose pull
docker compose down
docker compose up -d

---

十、常见问题（FAQ）

Q1：打不开网页？

检查：

• Docker 是否运行
• 5244 端口是否开放
• 防火墙是否阻挡

---

Q2：密码忘了怎么办？

进入容器：

docker exec -it openlist ./openlist admin random

---

Q3：无法挂载云盘？

可能原因：

• token 失效
• 插件未启用
• 网络访问限制

---

十一、适用场景

OpenList 适合：

• 私有网盘系统
• 家庭 NAS 文件管理
• 云盘聚合工具
• Web 文件服务器
• WebDAV 服务搭建

---

十二、总结

OpenList 的核心价值：

🔥 把“各种存储”统一成一个 Web 文件系统

通过 Docker，你可以：

• 5分钟搭建私有网盘系统
• 统一管理多个存储
• 支持 Web + WebDAV + API