1.项目

OpenList是一个基于 AList 二次开发的开源文件列表/管理系统，主要使用 Gin（Go 后端框架）和 SolidJS（前端框架）构建。它专注于提供 更可信、可持续 的云存储聚合方案，支持多种存储协议，并优化了安全性和社区生态。

1.1项目介绍

核心特点

1. 多存储支持
   • 聚合 20+ 云存储服务（阿里云盘、OneDrive、Google Drive、WebDAV 等）
   • 支持本地存储、S3、FTP 等协议
   • 可扩展的存储驱动系统
2. 技术栈升级
   • 后端：Gin 框架（高性能 Go Web 框架）
   • 前端：SolidJS（类似 React 但更轻量高效）
   • 数据库：支持 SQLite/PostgreSQL/MySQL
3. AList 的优化分支
   • 修复原版 AList 的潜在安全问题
   • 增强代码可持续性维护
   • 更透明的社区治理
4. 核心功能
   • 文件预览（文档/图片/视频/音频）
   • 多用户权限管理
   • WebDAV 协议支持
   • 响应式设计（适配 PC/移动端）

与 AList 的主要区别

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.搭建视频

哔哩哔哩：https://www.bilibili.com/video/BV1WJ3xzREYm/

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就已经搭建好了，更多操作可以看一下官方社区