Skip to content

Commit 22e1fa0

Browse files
authored
Update README.md
1 parent ce31f54 commit 22e1fa0

1 file changed

Lines changed: 78 additions & 1 deletion

File tree

README.md

Lines changed: 78 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,79 @@
11
# luci-app-cloud-control
2-
这是一个通过巴法云让小爱远程控制电脑开关机的openwrt插件
2+
3+
## 项目简介
4+
5+
cloud_control 是基于 OpenWrt 路由器的云端远程主机电源管理守护进程。它通过配置文件管理云端通信参数,实现远程开机(Wake-on-LAN)、关机(SSH/云端API通知)等功能,适用于需要远程控制家庭、办公等场景下主机电源的环境。
6+
7+
## 功能特性
8+
9+
- 通过巴法云( [bemfa.com](https://www.bemfa.com/))发布/接收电源管理指令
10+
- 支持局域网内主机远程开机(Wake-on-LAN)
11+
- 支持通过 SSH 远程关机
12+
- 支持云端 API 状态上报
13+
- 配置热加载,支持运行中动态刷新参数
14+
- 兼容 OpenWrt Luci 服务管理,支持前端一键启停
15+
16+
## 安装与使用
17+
18+
### 1. 编译
19+
20+
请确保你的 OpenWrt 路由器已安装好编译环境及依赖(如 libuci、libcurl 等),然后在源码根目录下执行:
21+
22+
```sh
23+
gcc -o /usr/bin/cloud_control cloud_control.c -luci
24+
```
25+
26+
### 2. 配置
27+
28+
编辑 `/etc/config/cloud_control`,示例内容如下:
29+
30+
```conf
31+
config main
32+
option enabled '1'
33+
option client_id '你的云控UID'(注册个巴法云账户,创建一个主题,默认PC001,将上面的密钥复制下来)
34+
option ip '192.168.1.50'
35+
option user '主机用户名'
36+
option password '主机密码'
37+
option nic 'br-lan'
38+
option mac 'XX:XX:XX:XX:XX:XX'
39+
option topic '你的主题'
40+
```
41+
42+
- `enabled`:是否启用服务(1为启用,0为关闭)
43+
- 其余字段请根据实际环境填写
44+
45+
### 3. 启动与管理
46+
47+
通过 OpenWrt 的 `/etc/init.d/cloud_control` 管理服务:
48+
49+
```sh
50+
/etc/init.d/cloud_control start # 启动服务
51+
/etc/init.d/cloud_control stop # 停止服务
52+
/etc/init.d/cloud_control restart # 重启服务
53+
```
54+
55+
也可通过 Luci 前端启用/禁用服务。
56+
57+
### 4. 日志查看
58+
59+
程序日志默认写入 `/var/log/cloud_control.log`。可通过以下命令查看运行状态:
60+
61+
```sh
62+
tail -f /var/log/cloud_control.log
63+
```
64+
65+
### 5. 常见问题
66+
67+
- **服务无法常驻/一闪而过?**
68+
- 请确认编译版本已包含守护进程化(daemonize)逻辑,且配置文件参数填写正确。
69+
- **Luci 启用服务无效?**
70+
- 请确保 `/etc/init.d/cloud_control` 可执行,且 cloud_control 可被 root 用户启动。
71+
72+
## 贡献与支持
73+
74+
欢迎提交 issue 或 pull request 共同完善本项目。如有问题可通过 [bemfa.com](https://www.bemfa.com/) 或相关技术论坛交流。
75+
76+
---
77+
78+
**作者:** sudo-bai
79+
**许可证:** MIT

0 commit comments

Comments
 (0)