204 lines
4.8 KiB
Markdown
204 lines
4.8 KiB
Markdown
# LED Manager Panel
|
||
|
||
一个无第三方依赖的 Linux LED Web 管理面板，用 Python 标准库直接管理：
|
||
|
||
```text
|
||
/sys/class/leds/
|
||
```
|
||
|
||
适合 Debian、OpenWrt、Raspberry Pi OS、4G 路由器等 Linux 设备。
|
||
|
||
你的设备示例：
|
||
|
||
```text
|
||
blue:wan green:wlan mmc0:: red:power sim:en sim:en2 sim:sel sim:sel2
|
||
```
|
||
|
||
## 功能
|
||
|
||
- 默认只列出实际可控的红 / 绿 / 蓝 LED（`red:*`、`green:*`、`blue:*`），隐藏 SIM/mmc 等不可控条目
|
||
- 查看 brightness / max_brightness / 当前 trigger
|
||
- 打开 / 关闭单个 LED
|
||
- 页面顶部一键关闭全部 LED
|
||
- 调整亮度
|
||
- 切换 trigger，例如 `none`、`timer`、`netdev`、`mmc0` 等，具体取决于内核暴露的能力
|
||
- 设置 `timer` trigger 的 `delay_on` / `delay_off`
|
||
- “识别 3 秒”闪烁指定 LED
|
||
- 无数据库、无 Node、无 pip 依赖
|
||
|
||
## 持久化配置 / 开机恢复
|
||
|
||
这是 Debian 版本的一键脚本：安装后会创建 systemd 服务并开机启动：
|
||
|
||
```text
|
||
led-manager.service
|
||
```
|
||
|
||
面板里每个 LED 卡片都有：
|
||
|
||
```text
|
||
保存持久化
|
||
取消持久化
|
||
```
|
||
|
||
点击“保存持久化”后，当前 LED 的 `trigger`、`brightness`、`delay_on`、`delay_off` 会保存到：
|
||
|
||
```text
|
||
/etc/led-manager/config.json
|
||
```
|
||
|
||
系统重启后，`led-manager.service` 会自动启动，并在启动时读取该配置恢复 LED 状态。
|
||
|
||
为加快开机启动，systemd 服务不再等待 `network-online.target`，只依赖本地文件系统就启动；内网地址可用后浏览器再访问即可。
|
||
|
||
## LED 过滤
|
||
|
||
默认只显示/控制红绿蓝三类实际可控灯：
|
||
|
||
```text
|
||
red,green,blue
|
||
```
|
||
|
||
如果以后要临时显示全部 `/sys/class/leds` 条目，可以这样重装/更新：
|
||
|
||
```bash
|
||
COLORS= sh -c "$(curl -fsSL https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh)"
|
||
```
|
||
|
||
也可以指定颜色前缀，例如只显示红蓝：
|
||
|
||
```bash
|
||
COLORS=red,blue sh -c "$(curl -fsSL https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh)"
|
||
```
|
||
|
||
## 更新已有安装
|
||
|
||
```bash
|
||
curl -fsSL https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh | sh
|
||
```
|
||
|
||
如果已经在浏览器打开旧页面，更新后请强制刷新一次页面，避免浏览器缓存旧 JS：
|
||
|
||
```text
|
||
Ctrl+F5 / Cmd+Shift+R
|
||
```
|
||
|
||
## 一键安装
|
||
|
||
```bash
|
||
curl -fsSL https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh | sh
|
||
```
|
||
|
||
如果设备没有 `curl`，用 `wget`：
|
||
|
||
```bash
|
||
wget -qO- https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh | sh
|
||
```
|
||
|
||
默认端口 `8088`，安装后浏览器打开：
|
||
|
||
```text
|
||
http://设备IP:8088/
|
||
```
|
||
|
||
自定义端口：
|
||
|
||
```bash
|
||
PORT=8090 sh -c "$(curl -fsSL https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh)"
|
||
```
|
||
|
||
## 手动运行
|
||
|
||
把 `led_panel.py` 上传到设备，例如：
|
||
|
||
```bash
|
||
scp led_panel.py root@4G-wifi:/root/led_panel.py
|
||
```
|
||
|
||
在设备上运行：
|
||
|
||
```bash
|
||
chmod +x /root/led_panel.py
|
||
python3 /root/led_panel.py --host 0.0.0.0 --port 8088
|
||
```
|
||
|
||
如果设备没有 Python3：
|
||
|
||
```bash
|
||
# Debian/Ubuntu
|
||
apt update && apt install -y python3
|
||
|
||
# OpenWrt
|
||
opkg update && opkg install python3
|
||
```
|
||
|
||
## Debian systemd 安装
|
||
|
||
```bash
|
||
mkdir -p /opt/led-manager
|
||
cp led_panel.py /opt/led-manager/led_panel.py
|
||
chmod +x /opt/led-manager/led_panel.py
|
||
cp led-manager.service /etc/systemd/system/led-manager.service
|
||
systemctl daemon-reload
|
||
systemctl enable --now led-manager
|
||
systemctl status led-manager
|
||
```
|
||
|
||
默认端口：`8088`。
|
||
|
||
## OpenWrt procd 安装
|
||
|
||
```bash
|
||
mkdir -p /opt/led-manager
|
||
cp led_panel.py /opt/led-manager/led_panel.py
|
||
chmod +x /opt/led-manager/led_panel.py
|
||
cp led-manager.openwrt.init /etc/init.d/led-manager
|
||
chmod +x /etc/init.d/led-manager
|
||
/etc/init.d/led-manager enable
|
||
/etc/init.d/led-manager start
|
||
/etc/init.d/led-manager status
|
||
```
|
||
|
||
## 安全说明
|
||
|
||
这个面板会写 `/sys/class/leds/*`，建议只在内网使用，不要直接暴露公网。
|
||
|
||
如需公网访问，请放到反代后面加认证，或者只监听 `127.0.0.1`：
|
||
|
||
```bash
|
||
python3 /root/led_panel.py --host 127.0.0.1 --port 8088
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
### 1. 按钮提示权限不足
|
||
|
||
需要 root 运行，因为 `/sys/class/leds/*/brightness` 通常只有 root 可写。
|
||
|
||
### 2. 某些 LED 不能调亮度
|
||
|
||
有些 LED 只有 `0/1` 两档，`max_brightness` 会是 `1`。
|
||
|
||
### 3. 切换 trigger 后亮度不能手动控制
|
||
|
||
Linux LED 子系统里，手动亮度通常要先切回：
|
||
|
||
```bash
|
||
echo none > /sys/class/leds/<led-name>/trigger
|
||
```
|
||
|
||
面板在手动设置亮度时会自动尝试切到 `none`。
|
||
|
||
### 4. netdev trigger 怎么绑定网卡？
|
||
|
||
如果某个 LED 支持 `netdev` trigger，切到 netdev 后可能会出现这些文件：
|
||
|
||
```text
|
||
device_name
|
||
link
|
||
tx
|
||
rx
|
||
```
|
||
|
||
当前版本先做通用亮度/trigger/timer 管理；如果你要把 `blue:wan` 绑定到具体网卡，我可以继续加 netdev 绑定配置。
|