OpenList Magisk 模块将 OpenList 文件服务器集成到 Android 系统中,通过 Magisk 或 KernelSU 以系统化方式运行,支持 ARM 和 ARM64 架构。
- 双框架支持:同时兼容 Magisk 和 KernelSU
- 灵活安装选项:支持三种安装位置
- data/adb/openlist
- 模块目录/bin
- system/bin
- 数据目录可选:支持两种数据存储位置
- /data/adb/openlist/
- /storage/emulated/0/Android/openlist/
- 密码定制:提供初始密码设置选项
- 动态服务管理:通过 Magisk/KernelSU 的"动作"按钮一键控制服务
- 智能网络适配:自动识别 WiFi 和移动网络 IP
- 日志支持:详细的运行日志记录
- Android 设备(支持 ARM 或 ARM64 架构)
- Magisk v20.4 或更高版本,或 KernelSU
- Root 权限
本模块同时支持 Magisk 和 KernelSU 两大Android Root框架:
- 支持 Magisk v20.4 及以上版本
- 完全兼容 Magisk 模块系统
- 支持 Magisk 动作按钮控制
- 支持 Magisk 更新机制
- 支持 KernelSU 最新版本
- 完全兼容 KernelSU 模块系统
- 支持 KernelSU 动作按钮控制
- 支持 KernelSU 更新机制
- 自动检测运行环境(Magisk/KernelSU)
- 统一的路径配置和处理
- 兼容的卸载机制
- 完整的日志记录系统
-
下载模块
- 从 GitHub Releases 下载最新版本
-
安装配置
- 打开 Magisk 管理器 或 KernelSU 管理器
- 选择"从本地安装"
- 进入安装配置界面:
- 选择二进制文件安装位置
- 选择数据目录存储位置
- 选择是否修改默认密码为 admin
-
完成安装
- 等待安装完成
- 重启设备
- 系统启动后自动运行
- 通过 Magisk/KernelSU "动作"按钮控制服务
- 服务状态显示在 module.prop:
- 运行中:显示访问地址和数据目录
- 已停止:显示启动提示
- Web 界面访问:
http://<设备IP>:5244 - 初始密码:查看数据目录下的
初始密码.txt
- 默认数据目录:
/data/adb/openlist/ - 日志文件位置:与数据目录相同
- 密码文件:
初始密码.txt
-
无法访问服务
- 检查网络连接
- 检查服务状态:
pgrep -f openlist - 查看日志文件
- 手动重启服务:
su -c /data/adb/modules/openlist/service.sh
-
IP 地址获取失败
- 确认 WiFi 或移动网络已连接
- 检查网络接口状态
- 查看模块日志
-
服务无法启动
- 检查二进制文件权限
- 确认数据目录可写
- 查看详细日志
- 停止服务:
su -c pkill -f openlist - 启动服务:
su -c /data/adb/modules/openlist/service.sh - 查看日志:
cat /data/adb/modules/openlist/service.log
- 支持通过 Magisk/KernelSU 更新检查
- 更新不会清除现有数据
- 可在安装时重新选择配置选项
- 在安装时选择新的数据目录
- 手动将现有数据迁移到新目录
- 更新 config.json 中的相关路径
- 欢迎提交 Issue 和 Pull Request
- 问题反馈:GitHub Issues
本项目基于 MIT 许可证 发布。