OpenList 交互式管理脚本

github地址:https://github.com/ypq123456789/openlist-manger

OpenList 交互式管理脚本

一个用于管理 OpenList 的交互式 Shell 脚本,支持 Linux、macOS、Windows (WSL) 和 Android Termux。

一键安装 / 更新

Linux / macOS / WSL

sudo curl -fsSL "https://raw.githubusercontent.com/ypq123456789/openlist-manger/refs/heads/main/openlist.sh" -o /usr/local/bin/openlist && sudo chmod +x /usr/local/bin/openlist && openlist

如遇 /usr/local/bin 不存在,可先执行:sudo mkdir -p /usr/local/bin

Android Termux

curl -fsSL "https://raw.githubusercontent.com/ypq123456789/openlist-manger/refs/heads/main/openlist.sh" -o $PREFIX/bin/openlist && chmod +x $PREFIX/bin/openlist && openlist

Windows 用户请在 WSL 环境下使用本脚本,原生 Windows 不支持 Bash 脚本。

日常使用

安装成功后,在任何路径下输入以下命令即可唤出管理菜单:

openlist

主要功能

  • 交互式菜单:通过简单的菜单选项完成所有操作。
  • 跨平台支持:自动检测并适配多种操作系统。
  • 服务管理:轻松安装、更新、卸载、启动、停止和重启 OpenList 服务。
  • 状态和日志:快速查看 OpenList 的运行状态和日志。
  • 数据迁移:支持从 Alist 一键迁移数据。
  • 简化的安装和更新:通过重新运行脚本即可完成安装和更新。

环境检测与推荐

  • 脚本启动后会自动检测:
    • Docker 是否已安装
    • OpenList Docker 容器是否已安装(只要有官方4个镜像的容器即视为已安装)
    • 域名绑定状态(主界面会自动检测并显示当前已绑定的域名,如未绑定则提示"未绑定域名")
  • 主菜单顶部会醒目推荐:
    • 二进制文件安装(适合大多数用户,兼容性好)
    • Docker 安装(适合有 Docker 环境的用户,隔离性强)

简介

此脚本通过一个清晰的交互式菜单,提供了对 OpenList 的全方位管理功能,从首次安装到后期的服务监控、数据迁移和密码管理,一切尽在掌握。无需记忆复杂的命令,只需运行脚本并根据菜单提示进行选择即可。

功能特性

  • 一键安装与部署:自动检测系统环境,下载并安装最新或指定版本的 OpenList。
  • 服务全周期管理:轻松启动、停止、重启 OpenList 服务,并实时查看服务状态。
  • 便捷的更新与卸载:安全地更新 OpenList 到新版本,或将其从系统中完全卸载。
  • 强大的日志系统:支持查看实时日志、历史日志、错误日志,并能快速定位初始密码。
  • 灵活的密码管理:支持随机生成密码或手动设置新的管理员密码。
  • 数据迁移:提供从 Alist 无缝迁移数据到 OpenList 的功能。
  • 系统兼容性:支持 x86_64 和 aarch64 架构,全面兼容主流 Linux 发行版(如 Ubuntu, Debian, CentOS)、macOS、Windows(WSL)、Android Termux,服务管理、数据迁移、密码重置等操作会自动适配不同平台。
  • 智能依赖检查:自动检查并提示安装 curl 和 tar 等必要依赖。
  • Docker 一键管理:支持通过 Docker 镜像一键安装、启动、进入容器、设置密码、重启、查看日志和状态,并可选择官方多种镜像标签。
  • 域名绑定与反向代理:支持一键检测/安装 Nginx,自动生成反代配置,提示域名A记录指向本机IP。
  • 定时自动更新:支持二进制服务和 Docker 两种模式,提供常用定时选项和自定义 crontab,支持一键取消和查看当前任务。
  • 脚本自动更新:脚本会自动检查并更新到最新版本,确保用户始终使用最新功能。

系统要求

  • 操作系统:支持 systemd 的主流 Linux 发行版 (如 Ubuntu, Debian, CentOS 等),并兼容 macOS、Windows(WSL)、Android Termux(部分功能如服务管理需手动操作)
  • 用户权限:需要 root 权限来执行安装和服务管理等操作。
  • 必要命令:curl 和 tar
  • 系统架构:x86_64 (amd64) 或 aarch64 (arm64)
  • Docker 相关功能需支持 Docker 环境(脚本可自动安装 Docker)。

脚本菜单详解

二进制文件服务模式

  • 1. 安装 OpenList:首次安装或覆盖安装 OpenList。脚本会自动处理下载、解压、创建服务等所有步骤。
  • 2. 更新 OpenList:将已安装的 OpenList 更新到最新版本或指定版本。
  • 3. 卸载 OpenList:从系统中彻底移除 OpenList,包括程序文件、数据和系统服务。
  • 4. 迁移 Alist 数据:将 Alist 的数据(数据库和配置)迁移到 OpenList,方便从 Alist 过渡。
  • 5. 启动服务:启动 openlist.service
  • 6. 停止服务:停止 openlist.service
  • 7. 重启服务:重启 openlist.service
  • 8. 查看状态:显示 OpenList 的运行状态、版本信息、文件路径和网络访问地址等。
  • 9. 查看日志:提供多种日志查看选项,包括实时日志、错误日志和查找初始密码。

Docker 管理

  • 10. Docker 一键安装/启动 OpenList
    • 支持选择官方镜像标签(betabeta-ffmpegbeta-aiobeta-aria2),也可自定义标签。
    • 自动检测并安装 Docker 环境。
    • 自动拉取镜像并启动容器。
  • 11. 进入 OpenList 容器:进入容器内执行命令(输入 exit 可返回脚本交互界面)。
  • 12. 容器内设置管理员密码:在容器内一键设置新密码。
  • 13. 重启 OpenList 容器:重启当前镜像对应的容器。
  • 14. 查看容器状态:列出所有基于 OpenList 官方4个镜像(betabeta-ffmpegbeta-aiobeta-aria2)的容器状态。
  • 15. 查看容器日志:实时查看容器日志(Ctrl+C 停止日志查看,按回车返回菜单)。

注意: Docker 相关操作会自动记忆上次选择的镜像标签,后续操作无需重复选择。

域名绑定/反向代理

  • 16. 域名绑定/反代设置:一键检测/安装 Nginx,输入域名自动生成反代配置,提示A记录指向本机IP。

定时自动更新

  • 17. 定时自动更新设置:支持二进制服务和 Docker 两种模式,提供每小时、每3小时、每天、每周和自定义定时任务,支持一键取消和查看当前任务。

退出

  • 0. 退出脚本:安全退出本管理脚本。

贡献与反馈

如果您发现任何 bug 或有功能建议,欢迎通过提交 Issue 来告诉我们!

THE END