零基础搭建开源网盘 OpenList（Alist 替代方案）

🚀 零基础搭建开源网盘 OpenList（Alist 替代方案）

以下是我为你整理和重新编辑后的《OpenList 安装与故障处理教程》，逻辑更清晰、排版更美观，并附带实际操作示例，适合用于发布或收藏：

适用于 Linux amd64 / arm64 系统，支持多平台网盘挂载

📚 官方文档地址：https://docs.openlist.team

📦 一、安装 OpenList

✅ Beta 测试版安装命令

1
curl -fsSL "https://docs.openlist.team/beta.sh" | bash -s install

🔄 更新命令

1
curl -fsSL "https://docs.openlist.team/beta.sh" | bash -s update

❌ 卸载命令

1
curl -fsSL "https://docs.openlist.team/beta.sh" | bash -s uninstall

📁 二、自定义安装路径（可选）

默认路径为 /opt/openlist，若需自定义路径，请使用以下命令：
注意：路径必须是绝对路径。

示例：安装到 /root 目录

1
2
3
4
5
6
7
8
# 安装
curl -fsSL "https://docs.openlist.team/v3.sh" -o v3.sh && bash v3.sh install /root

# 更新
curl -fsSL "https://docs.openlist.team/v3.sh" -o v3.sh && bash v3.sh update /root

# 卸载
curl -fsSL "https://docs.openlist.team/v3.sh" -o v3.sh && bash v3.sh uninstall /root

🖥️ 三、服务管理命令

1
2
3
4
systemctl start openlist     # 启动
systemctl stop openlist      # 停止
systemctl restart openlist   # 重启
systemctl status openlist    # 查看状态

🔑 四、获取管理员密码

进入 OpenList 安装目录后执行：

🧾 旧版（v3.25.0 以下）

1
./openlist admin

🔐 新版（v3.25.0 及以上，密码加密存储）

1
2
3
4
5
# 生成一个随机密码
./openlist admin random

# 手动设置密码（将 NEW_PASSWORD 替换成你自己的密码）
./openlist admin set NEW_PASSWORD

🧯 五、常见问题：页面提示“获取设置失败：请稍后，正在加载存储…”

✅ 原因：

某些挂载的网盘接口失效或异常，阻塞服务启动。

💡 解决方案：

  1. 进入 OpenList 安装目录

  2. 列出所有挂载的存储

1
./openlist storage list

输出示例：

1
2
3
4
5
6
┌────────────────────────────────────────────────────────────┐
│ ID    Driver      Mount Path              Enabled          │
│────────────────────────────────────────────────────────────│
│ 1     S3          /R2                     true             │
│ 2     UrlTree     /233                    true             │
└────────────────────────────────────────────────────────────┘

  1. 确定是哪个挂载出错（可使用 ↑ ↓ 键翻页）

  2. 停用异常的挂载路径（示例：禁用 /233）

1
./openlist storage disable /233
  1. 重启 OpenList 服务
1
systemctl restart openlist

即可恢复正常访问。

📘 推荐操作小结

操作 命令示例
安装（默认路径） `curl -fsSL “https://docs.openlist.team/beta.sh“ bash -s install`
自定义路径安装 bash v3.sh install /your/path
启动服务 systemctl start openlist
停止服务 systemctl stop openlist
获取密码 ./openlist admin random 或 set NEW_PASSWORD
挂载异常修复 ./openlist storage disable /挂载路径 后重启服务