OpenList（Alist 开源分支）：聚合网盘

OpenList 是 Alist 的社区开源分支，一款支持多种存储服务的文件列表程序。可把阿里云盘、OneDrive、Google Drive、115 等云存储聚合到一个 Web 界面，用于对外分享大文件或搭建轻量私人网盘。

为什么不是 Alist 原 Alist 项目于 2024 年 12 月被某公司收购，社区出于安全考虑创建了 OpenList 这一开源分支（AGPL-3.0，GitHub 仓库 OpenListTeam/OpenList）。本文配置以 OpenList 为准；如从旧 Alist 迁移，仅需替换镜像、沿用原 data 目录。

Docker Compose 部署

推荐通过 Docker Compose 部署 OpenList，详情参见 Docker Compose 部署教程。配置示例：

services:
  openlist:
    image: openlistteam/openlist:latest
    container_name: openlist
    restart: always
    volumes:
      - /volume1/docker/openlist/data:/opt/openlist/data
    ports:
      - 9044:5244
    user: "1026:100"
    environment:
      - UMASK=022
      - TZ=Asia/Shanghai

镜像可选 tag：latest（稳定）/ beta（开发）/ latest-lite（≤100 MB 轻量）；若需缩略图或离线下载，可用带后缀镜像，如 latest-ffmpeg、latest-aria2、latest-aio。 v4.1.0 之后建议显式指定 user: "UID:GID"，确保容器内用户可写入映射目录。

部署完成后，浏览器访问 http://<你的服务器 IP 或域名>:9044 进入 Web 界面。

重置管理员密码

OpenList 首次启动会随机生成初始密码，日志里可看到。如错过或需要重置：

# 重新随机生成密码
docker exec -it openlist ./openlist admin random

# 手动设置密码为 NEW_PASSWORD（替换为你要用的）
docker exec -it openlist ./openlist admin set NEW_PASSWORD

添加存储

登录后，点击左侧菜单「存储」新增挂载。几个关键字段：

• 驱动：网盘类型。例如阿里云盘请选 阿里云盘 Open。
• 挂载路径：作为 OpenList 里的目录名，自由命名。例如分享应用就填 /apps。
• 缓存过期时间：默认 30 分钟；需要长期稳定挂载可改为 0。
• 根文件夹 ID：仅分享网盘中某个子目录时填；分享整个网盘填 root。
• 刷新令牌：网盘登录凭据，按 OpenList 官方文档 的对应驱动章节获取。

元信息：给文件夹加密码与访问控制

「元信息」页面为指定路径配置访客侧的访问规则（仅对访客生效，不影响管理员）：

• 密码：访问该路径需要的密码，常用于半公开分享。
• 写入：允许访客新建目录、上传文件。
• 隐藏：正则表达式匹配要对访客隐藏的条目，一行一条。
• 说明：进入该路径时显示的 README，支持 Markdown 内容或指向 Markdown 文件的链接。

合理利用元信息可以有效防止网盘因恶意访问 / 分享而被冻结账号。