mirror of
https://github.com/kiddin9/op-packages.git
synced 2026-11-04 14:33:56 +08:00
70 lines
3.6 KiB
Markdown
70 lines
3.6 KiB
Markdown
[简体中文](README.md) | [English](README.en.md)
|
||
|
||
# luci-app-forcedata
|
||
|
||
OpenWrt / iStoreOS 平台的「原力云（Forcedata）」边缘计算客户端 LuCI 管理插件。
|
||
|
||
|
||
|
||
|
||
|
||
## 📖 项目介绍
|
||
|
||
原力云是一个边缘计算 / 共享带宽平台：在自家设备上运行它的客户端，在线共享闲置带宽，每月可获取一定的现金回报。本插件把整套部署流程搬进 LuCI：安装后自动下载并拉起 forcecloud 客户端，分钟级保活与自更新，并在路由器管理页提供运行状态与扫码绑定入口。
|
||
|
||
适合已经刷了 OpenWrt / iStoreOS 的软路由、盒子玩家，不敲命令行即可挂机跑原力云。插件基于 iStore 应用框架（`luci-lib-taskd` + istorec 管理脚本）开发，与 iStoreOS 上其他应用的使用方式一致。
|
||
|
||
## ✨ 功能特性
|
||
|
||
- LuCI 图形界面：菜单位置「服务 → Forcedata（原力云）」，实时展示服务运行状态
|
||
- 首次使用自动生成 18 位数字 UID，保存在 `/etc/config/forcedata`（请勿修改，否则影响部署）
|
||
- 一键安装 / 升级 forcecloud 客户端，自动区分 x86_64 / aarch64 架构，下载包做 MD5 校验
|
||
- 通过 crontab 每分钟自检：进程掉线自动拉起，根分区使用率 100% 时自动跳过更新
|
||
- 客户端异常重启、同一主机重复启动探针时，通过钉钉机器人推送报警
|
||
- 状态页可生成绑定二维码，用「原力云」微信小程序扫码绑定设备
|
||
- 管理脚本支持 install / upgrade / rm / start / stop / restart / status 子命令
|
||
|
||
## 🛠 技术栈
|
||
|
||
- LuCI（Lua）+ iStore/taskd 应用框架，依赖 `luci-lib-taskd`，包架构 all
|
||
- busybox ash Shell 管理脚本
|
||
- 页面二维码基于 qrcode.min.js 生成
|
||
|
||
## 🚀 快速开始
|
||
|
||
1. 编译安装：把本仓库放进 OpenWrt/LeDE 源码的 `package/` 目录，`make menuconfig` 选中 `LuCI → Applications → luci-app-forcedata`，编译出 ipk 后安装到路由器；
|
||
2. 首次安装时 uci-defaults 会自动注册每分钟执行一次的 crontab 保活任务；
|
||
3. 登录 LuCI 进入「服务 → Forcedata」，确认 UID 后等待状态变为 Running；
|
||
4. 点击「Running, click to show QR」生成二维码，用「原力云」微信小程序扫码绑定设备，详见[官方教程](https://docs.qq.com/doc/DZXNFWWtKbHN4UHFD)。
|
||
|
||
也可以在 SSH 里手动管理：
|
||
|
||
```sh
|
||
sh /usr/libexec/istorec/forcedata.sh install # 安装 / 拉起客户端
|
||
sh /usr/libexec/istorec/forcedata.sh status # 查看运行状态
|
||
sh /usr/libexec/istorec/forcedata.sh rm # 停止进程并清理 /usr/local/forcecloud
|
||
```
|
||
|
||
## 📁 目录结构
|
||
|
||
```
|
||
luci-app-forcedata/
|
||
├── luasrc/ # LuCI 控制器、CBI 配置页、状态视图
|
||
├── po/zh-cn/ # 简体中文语言包
|
||
├── root/
|
||
│ ├── etc/config/forcedata # UCI 配置（uid）
|
||
│ ├── etc/uci-defaults/luci-app-forcedata # 首次安装注册 crontab
|
||
│ ├── usr/libexec/istorec/forcedata.sh # 安装 / 保活 / 更新脚本
|
||
│ └── www/luci-static/forcedata/ # 二维码 JS 与小程序码图片
|
||
└── Makefile
|
||
```
|
||
|
||
## 🔗 相关链接
|
||
|
||
- [原力云官网](http://www.forcedata.cn)
|
||
- [小程序扫码绑定教程](https://docs.qq.com/doc/DZXNFWWtKbHN4UHFD)
|
||
|
||
## 📄 License
|
||
|
||
本仓库未附带 LICENSE 文件（Makefile 中标注维护者为 forcedata），仅供学习研究。
|