OpenList
基于 Gin 和 SolidJS 构建的文件列表程序,支持数十种存储后端、文件预览与 WebDAV 协议。
OpenList 是一款支持多种存储后端的文件列表与 WebDAV 程序,基于 Gin(Go 框架)和 SolidJS 构建。它可以将各类云存储、本地存储统一管理,提供文件预览、在线播放、上传下载等功能。
OpenList 基于开源项目 Alist(AGPL-3.0),本站实例托管于
openalist.linzs.cn。
📖 官方文档 • 💻 GitHub • 🚀 在线实例
✨ 核心功能
📁 支持 30+ 种存储后端
接入几乎所有主流存储服务:
| 类型 | 支持的存储 |
|---|---|
| 国内云盘 | 阿里云盘、天翼云盘、123云盘、139云盘、蓝奏云、夸克网盘、UC网盘、迅雷云盘 |
| 国际云盘 | OneDrive / SharePoint、Google Drive、Dropbox、Mega.nz、Terabox |
| 对象存储 | S3、又拍云存储、Azure Blob Storage |
| 协议类 | FTP / SFTP、WebDAV、SMB |
| 其他 | 百度网盘、PikPak、Seafile、Cloudreve、115 等 |
👁️ 文件预览
- 文档:PDF、Markdown、纯文本、代码高亮
- Office:docx、pptx、xlsx(在线预览)
- 图片:画廊模式浏览
- 视频/音频:在线播放,支持歌词和字幕
- README.md:自动渲染显示
🔧 文件管理
- 上传下载:支持 Web 上传(可允许访客上传)
- 文件操作:新建目录、重命名、移动、复制、删除
- 打包下载:文件夹一键打包下载
- 离线下载:支持离线下载任务
- 跨存储复制:两个不同存储之间复制文件
- 永久链接:生成文件的永久直链和直接下载链接
🌐 其他特性
- WebDAV 协议:可作为 WebDAV 服务器挂载到本地
- S3 协议:兼容 S3 协议客户端
- 暗黑模式:支持亮色/暗色主题切换
- 多用户管理:支持多用户、权限控制
- 密码保护:受保护路由,支持密码验证
- 分享链接:生成分享链接
- 国际化(I18n):多语言界面
- 多线程下载加速:单线程/多线程切换
- Cloudflare Workers 代理:可配合 CF Workers 加速
🚀 安装方式
方式一:Docker 部署(推荐)
docker run -d \
--name openlist \
-p 5244:5244 \
-p 5246:5246 \
-v /etc/openlist:/opt/openlist/data \
--restart unless-stopped \
openlistteam/openlist:latest方式二:Docker Compose
version: "3"
services:
openlist:
image: openlistteam/openlist:latest
container_name: openlist
ports:
- "5244:5244"
- "5246:5246"
volumes:
- ./data:/opt/openlist/data
restart: unless-stopped方式三:1Panel 应用商店
在 1Panel 面板 → 应用商店 → 搜索 OpenList → 一键安装,自动配置端口和数据目录。
方式四:二进制手动部署
从 GitHub Releases 下载对应平台的可执行文件:
# Linux amd64
wget https://github.com/alist-org/alist/releases/latest/download/alist-linux-amd64.tar.gz
tar xzf alist-linux-amd64.tar.gz
./alist server
📖 快速使用
1. 启动服务
Docker 部署后,访问 http://你的IP:5244。
2. 管理员登录
首次启动会自动生成管理员密码,查看方式:
# Docker 部署
docker logs openlist 2>&1 | grep "password"
# 手动部署
./alist admin3. 添加存储
进入管理后台 → 存储 → 添加存储 → 选择存储类型(如阿里云盘、OneDrive 等)→ 填写配置信息 → 保存。
4. 日常使用
- 浏览文件:在首页浏览各存储挂载目录
- 预览文件:点击文件在线预览
- 下载分享:右键文件复制直链或生成分享链接
- WebDAV 挂载:使用
http://你的IP:5244/dav挂载到本地
5. 搜索文件
管理后台 → 设置 → 搜索 → 开启搜索并点击 构建索引,即可在首页搜索文件。
⚙️ 配置说明
OpenList 主要配置项(data/config.json):
| 配置项 | 说明 |
|---|---|
site_url | 站点 URL(建议设置为实际域名) |
scheme.http_port | HTTP 端口(默认 5244) |
database.type | 数据库类型(sqlite3 / mysql / postgres) |
bleve_dir | 全文搜索索引存储目录 |
meilisearch | Meilisearch 搜索引擎配置 |
max_concurrency | 最大并发数 |
jwt_secret | JWT 密钥 |
📄 许可证
OpenList / Alist 采用 AGPL-3.0 开源许可证。
免责声明:本程序为免费开源项目,旨在分享和方便文件管理。通过调用官方 SDK/接口实现,不破坏官方接口行为。仅做 302 重定向/流量转发,不拦截、存储、篡改任何用户数据。使用时请遵守相关法律法规。