一、项目介绍

OpenList 是一个有韧性、长期治理、社区驱动的 AList 分支，旨在防御基于信任的开源攻击，保持完整的代码开放性和修改透明性。

核心特性

  • ✅ 支持几乎所有主流网盘存储，包括：
    • 国内网盘：阿里云盘、天翼云盘、123 云盘、百度网盘、夸克网盘、迅雷网盘、蓝奏云、UC 网盘、和彩云等
    • 海外网盘：OneDrive/Sharepoint、GoogleDrive、PikPak、Google 相册、Mega.nz、Dropbox、ProtonDrive、YandexDisk 等
    • 对象存储/协议：S3、又拍云、WebDAV、FTP/SFTP、SMB、Azure Blob Storage 等
    • 其他：本地存储、Seafile、Teambition、115、Cloudreve、多吉云、GitHub 等
  • ✅ 开箱即用，部署方便
  • ✅ 丰富的预览功能：PDF、markdown、代码、纯文本、图片画廊、音视频（支持歌词字幕）、Office 文档（docx/pptx/xlsx）
  • ✅ 实用功能：文件永久链接、打包下载、离线下载、跨存储复制文件、单文件多线程下载加速、黑暗模式、国际化、WebDAV、访客上传

项目地址

  • GitHub: https://github.com/OpenListTeam/OpenList
  • 官方文档：
    • 国内站点：https://doc.oplist.org.cn
    • 海外站点：https://doc.oplist.org
  • 演示站：
    • 国内：https://demo.oplist.org.cn
    • 海外：https://demo.oplist.org

免责声明

OpenList 是免费开源软件（AGPL-3.0 许可证），旨在通过网盘便捷分享文件，主要用于 Go 语言学习。使用本软件请遵守相关法律法规，严禁滥用。用户需自行承担使用风险。

二、常见部署方法

方法一：Docker 一键部署（推荐）

这是最简单的部署方式，适合所有已安装 Docker 的服务器。

1
2
3
4
5
6

docker run -d \
  --name openlist \
  --restart unless-stopped \
  -p 5244:5244 \
  -v /opt/openlist/data:/opt/openlist/data \
  openlistteam/openlist:latest

参数说明：

  • -d: 后台运行容器
  • --restart unless-stopped: 开机自启，除非手动停止
  • -p 5244:5244: 将容器的 5244 端口映射到主机
  • -v /opt/openlist/data:/opt/openlist/data: 数据目录持久化存储

启动后访问：

  • 访问地址：http://你的服务器 IP:5244
  • 默认用户名：admin
  • 默认密码：查看容器日志获取：docker logs openlist

方法二：Docker Compose 部署

更灵活的配置方式，创建 docker-compose.yml 文件：

1
2
3
4
5
6
7
8
9

version: '3'
services:
  openlist:
    image: openlistteam/openlist:latest
    restart: always
    ports:
      - "5244:5244"
    volumes:
      - ./data:/opt/openlist/data

然后执行：

1

docker-compose up -d

方法三：Linux 一键脚本部署

适用于使用 systemd 的 Linux 系统，需要 root 权限：

1

curl -fsSL https://res.oplist.org/script/v4.sh > install-openlist-v4.sh && sudo bash install-openlist-v4.sh

根据提示输入 1 即可自动完成安装。安装完成后会输出访问地址、账号和初始密码。

Debian/Ubuntu 还可以通过 APT 仓库安装：

1
2
3
4
5
6
7
8

# 添加 GPG 密钥
curl -fsSL https://res.oplist.org/debian/openlist.key | sudo gpg --dearmor -o /usr/share/keyrings/openlist-archive-keyring.gpg

# 添加仓库
echo "deb [signed-by=/usr/share/keyrings/openlist-archive-keyring.gpg] https://res.oplist.org/debian/ stable main" | sudo tee /etc/apt/sources.list.d/openlist.list

# 安装
sudo apt update && sudo apt install openlist

方法四：二进制手动部署

  1. 从 Releases 下载对应系统架构的压缩包
  2. 解压并安装：
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 解压
tar -zxvf openlist-linux-musl-amd64.tar.gz

# 移动到系统目录
sudo mv openlist /usr/bin/

# 添加执行权限
sudo chmod +x /usr/bin/openlist

# 创建数据目录
sudo mkdir -p /etc/openlist
  1. 创建 systemd 服务 /etc/systemd/system/openlist.service：
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

[Unit]
Description=OpenList
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/etc/openlist
ExecStart=/usr/bin/openlist server
Restart=on-failure

[Install]
WantedBy=multi-user.target
  1. 启动并设置开机自启：
1
2
3

sudo systemctl daemon-reload
sudo systemctl enable openlist
sudo systemctl start openlist

方法五：Sealos 一键部署（无需自己服务器）

适合没有服务器的用户：

  1. 登录 Sealos 账号
  2. 在桌面点击「应用商店」
  3. 搜索「Openlist」，点击进入详情页
  4. 填写基础配置，点击「部署应用」
  5. 等待部署完成后即可访问

三、初始配置

  1. 访问你的 OpenList 地址
  2. 使用初始账号密码登录
  3. 第一件事建议：修改默认密码
  4. 点击「添加存储」，选择你要挂载的网盘，按照提示填写配置即可使用

四、常见问题

Q: 默认密码在哪里找？
A: Docker 部署：docker logs openlist；脚本部署：安装完成后会直接显示在终端。

Q: 默认端口可以改吗？
A: 可以，部署时修改端口映射（例如 -p 8080:5244），或者在配置文件中修改。

Q: OpenList 和原版 AList 是什么关系？
A: OpenList 是 AList 的社区维护分支，由于原项目出现信任危机，社区分叉出 OpenList 继续开发维护，保持开源开放。