OpenList 全面介绍与使用指南

基于 Gin & SolidJS 开发的开源文件列表程序，作为 AList 社区维护分支，专注多存储整合与隐私安全

官方文档

核心优势

  • 🗂️ 多存储整合
    支持本地存储、阿里云盘、OneDrive、Google Drive 等，兼容 WebDAV 协议，统一管理所有文件

  • 🔒 隐私与安全
    代码完全开源可审计，支持部署到个人服务器/NAS，搭配保险箱加密，数据不经过第三方

  • ⚡ 轻量化体验
    基于 Gin 后端与 SolidJS 前端构建，程序体积小、启动快，适配 Windows/macOS/Linux 多系统

  • ✅ 功能完整性
    包含多格式预览、批量操作、密码共享、离线下载、IPA 安装等功能，覆盖全场景使用需求

安装部署指南

根据自身技术背景选择安装方式，新手推荐「一键脚本」或「桌面版」，进阶用户可选择「Docker 部署」或「源码运行」

安装方式适用人群操作步骤优势
🛠️ 一键脚本新手/小白用户1. 复制官方脚本到终端
2. 按提示输入配置
3. 等待安装完成		无需手动配置依赖，5分钟快速部署
💻 桌面版个人电脑用户1. 官网下载对应系统安装包
2. 双击安装并启动
3. 浏览器访问本地地址		图形化操作，开箱即用，适合本地管理
🐳 Docker 部署服务器/NAS 用户1. 确保已安装 Docker
2. 执行镜像拉取命令
3. 配置端口与挂载目录		环境隔离，避免依赖冲突，启停灵活
⚙️ 手动安装进阶/开发用户1. 下载源码并安装依赖
2. 配置 config.yaml 文件
3. 编译并启动服务		可自定义功能，精细控制运行参数

基础使用流程

存储源添加（核心步骤）

  1. 🔑 登录管理后台
    安装完成后，浏览器访问部署地址（默认：http://localhost:5244），输入初始账号密码登录

  2. ⚙️ 进入存储配置
    点击左侧菜单栏「Storage Setup」→「Add Storage」，选择需添加的存储类型（如「阿里云盘」「本地存储」）

  3. 📝 填写配置信息

    • 通用项：自定义存储名称（如「我的阿里云盘」）、设置访问根路径
    • 专属项：云端存储需填写 Token/授权码，WebDAV 需填写服务器地址+账号密码

  4. 💾 保存并验证
    点击「Save」后，返回文件列表页面，若能看到存储源文件，说明添加成功

常用功能操作

  • 👁️ 文件预览
    点击文件即可预览视频、音频、图片、PDF 等格式，支持在线播放与缩放

  • 🔗 文件共享
    选中文件/文件夹 → 点击「Share」→ 设置有效期与密码 → 生成共享链接，他人无需注册即可访问

高级功能

  • ⬇️ 离线下载
    进入「Offline Download」→ 粘贴种子链接或磁力链 → 选择存储目录 → 启动下载

  • 🔒 保险箱加密
    创建加密文件夹 → 设置密码 → 将敏感文件移入，需输入密码才能访问

问题排查与支持

若使用中遇到问题，优先通过以下渠道解决：

页脚

基于 Gin & SolidJS 开发 | 开源文件列表程序
官方文档：https://doc.oplist.org/guide
© 2024 OpenList 社区. 本指南仅供学习使用，版权归原作者所有.