对于经常需要管理多平台存储、本地文件、网盘资源的用户来说，OpenList绝对是一款高效易用的开源文件列表管理工具。它作为AList的社区友好分支，保留了核心易用性，同时优化了兼容性与安全性，支持本地磁盘、各类网盘、WebDAV、对象存储等数十种存储源挂载，一键搭建私有文件管理平台，跨设备访问、在线预览、离线下载功能一应俱全。
本篇教程全程从零起步，严格按照前期准备→环境配置→核心搭建→存储挂载四步走，新手也能跟着操作无压力，命令直接复制即可运行，同时附上常见问题排查，避免踩坑。

一、前期准备

1.1 部署OpenList需要准备网盘

部分网盘需要VIP才会有速度

1.2 硬件与系统要求

OpenList轻量化部署，对硬件要求极低，普通云服务器、本地虚拟机、NAS均可运行：

配置底线：1核CPU、512MB内存、1GB以上空闲磁盘（仅运行程序，存储文件另算）
推荐系统：CentOS 7+/Ubuntu 18.04+/Debian 10+（Linux服务器首选，兼容性最佳）
网络要求：开放对应端口（默认5244），公网部署需配置安全组/防火墙

1.3 部署前必备工具

为了方便可以装一些可视化面板

二、环境配置

OpenList支持Docker部署、二进制直装两种核心方式，Docker部署推荐新手首选，环境隔离、一键启动、后续维护升级更简单；二进制部署适合不想安装Docker、追求极致轻量化的用户。

2.1 Docker环境部署

Docker Compose

安装好 Docker 后，容器编排创建模板 docker-compose.yml 文件。

然后在ocker-compose.yml 文件里放入以下代码（v4.1.0 以后版本）

# docker-compose.yml
services:
  openlist:
    image: 'openlistteam/openlist:latest'
    container_name: openlist
    user: '0:0' # Please replace `0:0` with the actual user ID and group ID you want to use to run OpenList.
    volumes:
      - './data:/opt/openlist/data'
    ports:
      - '5244:5244'
    environment:
      - UMASK=022
    restart: unless-stopped

然后点击容器

创建容器→(手动创建、命令创建、容器编排)选择第三个容器编排→选择容器编排模板→填写容器名字写好备注→最后点击创建→等待创建完成

三、启动OpenList服务，登录后台

3.1 查看管理员信息

首次运行

docker logs openlist

你将在日志中看到密码。

Successfully created the admin user and the initial password is: xYZabHGf

非首次运行

您可以重新生成或手动设置密码。

# 重新随机生成密码
docker exec -it openlist ./openlist admin random

# 手动设置密码为 `NEW_PASSWORD`（替换为您要设置的密码）
docker exec -it openlist ./openlist admin set NEW_PASSWORD

（注意容器的名字）

3.2 登录OpenList管理后台

服务启动成功后，打开浏览器访问：http://服务器IP:5244

默认管理员账号：

用户名：admin
密码：admin

也可以选择

容器→反向代理→填写域名→配置证书→保存

四、存储挂载：对接各类存储，实现统一管理

4.1 挂载主流网盘（我挂载的是天翼云盘）

操作很简单在后台选择天翼云盘TV→填写挂载路径→写好备注→选择302(这个很重要)→点击添加（等待出现几行报错）→返回主页→点击添加存储→使用天翼APP扫描二维码即可

五、后续优化与维护及升级备份

后台有备份方案

关于升级

在面板直接升级即可

或者使用一下命令升级

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower openlist --cleanup --run-once

如果您的容器名不是 openlist，请替换为实际的名称。

# 查看容器（查找 OpenList 容器的 ID）
docker ps -a

# 停止运行中的 OpenList 容器实例，否则无法删除（此时 OpenList 容器的 ID 为 d429749a6e69，每次安装时不同）
docker stop ID

# 删除 OpenList 容器（只要不手动删除数据，数据仍然保留）
docker rm ID

# 拉取 OpenList 的最新镜像
docker pull openlistteam/openlist:latest

{{userData.name}}已认证

OpenList的搭建与挂载网盘