1.项目
OpenList是一个基于 AList 二次开发的开源文件列表/管理系统,主要使用 Gin(Go 后端框架)和 SolidJS(前端框架)构建。它专注于提供 更可信、可持续 的云存储聚合方案,支持多种存储协议,并优化了安全性和社区生态。
1.1项目介绍
核心特点
- 多存储支持
- 聚合 20+ 云存储服务(阿里云盘、OneDrive、Google Drive、WebDAV 等)
- 支持本地存储、S3、FTP 等协议
- 可扩展的存储驱动系统
- 技术栈升级
- 后端:Gin 框架(高性能 Go Web 框架)
- 前端:SolidJS(类似 React 但更轻量高效)
- 数据库:支持 SQLite/PostgreSQL/MySQL
- AList 的优化分支
- 修复原版 AList 的潜在安全问题
- 增强代码可持续性维护
- 更透明的社区治理
- 核心功能
- 文件预览(文档/图片/视频/音频)
- 多用户权限管理
- WebDAV 协议支持
- 响应式设计(适配 PC/移动端)
与 AList 的主要区别
特性 | OpenList | AList |
---|---|---|
开发目标 | 可信、可持续的替代方案 | 原版项目 |
前端框架 | SolidJS | Vue3 |
社区治理 | 更开放的贡献机制 | 由原团队主导 |
安全更新 | 主动修复已知漏洞 | 依赖原团队响应速度 |
扩展性 | 优化插件系统(规划中) | 现有插件生态 |
1.2项目展示

2.相关地址
gitHub开源项目:https://github.com/OpenListTeam/OpenList
3.搭建环境
- 服务器:这里为了方便搭建项目使用的是莱卡云的境外香港云服务器。(国内用户连接建议使用国内的服务器(需备案域名或者IP+端口)延迟会更低)
- 莱卡云服务器促销活动性价比会更高。查看官网购买链接:https://www.lcayun.com
- 资源配置:2核2G 30G硬盘
由于国内服务器访问海外源较慢,这边为了方便演示直接使用海外服务器搭建。(最好是使用国内服务器搭建) - 服务器系统:Debian-12
- 【必需】安装Docker:安装好 Docker、Docker-compose
- 【非必需】域名一枚,可用于解析到服务器上使用域名访问

4.搭建视频
哔哩哔哩:
5.搭建方式
5.1 安装docker和docker-compose
安装教程:服务器上安装docker和docker-compose教程
5.2 创建OpenList的docker文件
#在opt目录下创建OpenList文件夹
mkdir /opt/OpenList
#打开OpenList文件
cd /opt/OpenList
#编辑docker-compose.yml文件
vi docker-compose.yml
5.3 安装OpenList镜像
services:
openlist:
image: openlistteam/openlist:latest
container_name: openlist
restart: always
ports:
- 5244:5244
volumes:
- ./data:/opt/openlist/data
- ./share:/opt/openlist/share
填完按esc键 输入 :wq 保存退出
5.4 运行OpenList的docker镜像
我们先启动docker
# 启动docker
docker compose up -d
# 重启docker
docker compose stop
docker compose start
# 升级docker
docker compose down
docker compose pull
docker compose up -d
访问IP:5244端口就可以有界面出现了。

查看管理员信息信息
低于v3.25.0版本
docker exec -it openlist ./openlist admin

高于v3.25.0版本 3.25.0以上版本将密码改成加密方式存储的hash值,无法直接反算出密码,如果忘记了密码只能通过重新 随机生成 或者 手动设置
随机生成一个密码
docker exec -it openlist ./openlist admin random

使用用户名跟密码就可以登录了
7.结尾
通过以上步骤OpenList就已经搭建好了,更多操作可以看一下官方社区