#!/usr/bin/env python3 # -*- coding: utf-8 -*- """ Linux LED Manager Panel A tiny dependency-free web panel for /sys/class/leds on Debian/OpenWrt/Linux. """ from __future__ import annotations import argparse import html import json import os import re import sys import time import urllib.parse from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer from pathlib import Path from typing import Dict, List, Optional, Tuple LED_ROOT = Path(os.environ.get("LED_ROOT", "/sys/class/leds")) CONFIG_PATH = Path(os.environ.get("LED_CONFIG", "/etc/led-manager/config.json")) NAME_RE = re.compile(r"^[A-Za-z0-9_.:+@=-]+$") CSS = r""" :root { color-scheme: dark; --bg:#0b1020; --card:#121a2f; --muted:#8ea0c0; --text:#e8eefc; --line:#263551; --accent:#5eead4; --danger:#fb7185; --warn:#fbbf24; } * { box-sizing: border-box; } body { margin:0; font-family: -apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Arial,sans-serif; background: radial-gradient(circle at top left,#172554 0,#0b1020 34rem); color:var(--text); } .container { max-width: 1180px; margin: 0 auto; padding: 24px; } .header { display:flex; justify-content:space-between; gap:16px; align-items:flex-start; margin-bottom:20px; } h1 { margin:0 0 6px; font-size:28px; } .sub { color:var(--muted); font-size:14px; } .grid { display:grid; grid-template-columns: repeat(auto-fill,minmax(310px,1fr)); gap:16px; } .card { background: rgba(18,26,47,.92); border:1px solid var(--line); border-radius:18px; padding:16px; box-shadow: 0 10px 30px rgba(0,0,0,.25); } .name { font-weight:700; font-size:18px; display:flex; align-items:center; gap:8px; word-break:break-all; } .dot { width:12px; height:12px; border-radius:50%; background:#64748b; box-shadow:0 0 12px currentColor; } .meta { margin-top:8px; color:var(--muted); font-size:13px; line-height:1.5; } .row { display:flex; gap:8px; flex-wrap:wrap; align-items:center; margin-top:12px; } button, select, input[type=number], input[type=text] { border:1px solid var(--line); background:#0f172a; color:var(--text); border-radius:10px; padding:9px 10px; font-size:14px; } button { cursor:pointer; transition:.15s; } button:hover { border-color:var(--accent); transform: translateY(-1px); } button.primary { background:#0f766e; border-color:#14b8a6; } button.off { background:#3f1d2a; border-color:#7f1d1d; } button.warn { background:#422006; border-color:#92400e; } input[type=range] { width:100%; accent-color: var(--accent); } .range-line { display:grid; grid-template-columns: 1fr 64px; gap:10px; align-items:center; margin-top:14px; } .badge { color:#0b1020; background:var(--accent); padding:2px 7px; border-radius:999px; font-size:12px; font-weight:700; } .err { background:#450a0a; border:1px solid #7f1d1d; color:#fecaca; padding:12px; border-radius:12px; margin-bottom:16px; } .toast { position:fixed; right:16px; bottom:16px; max-width:520px; padding:12px 14px; border-radius:12px; background:#052e2b; border:1px solid #14b8a6; display:none; } .small { font-size:12px; color:var(--muted); } a { color:var(--accent); } @media (max-width: 640px) { .container{padding:14px;} .header{display:block;} } """ JS = r""" async function api(path, body) { const opt = body ? {method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify(body)} : {}; const r = await fetch(path, opt); const data = await r.json(); if (!r.ok || data.ok === false) throw new Error(data.error || ('HTTP '+r.status)); return data; } function toast(msg, bad=false){ const t=document.getElementById('toast'); t.textContent=msg; t.style.display='block'; t.style.background=bad?'#450a0a':'#052e2b'; t.style.borderColor=bad?'#fb7185':'#14b8a6'; setTimeout(()=>t.style.display='none',2600); } async function setBrightness(name, value){ try{ const r=await api('/api/brightness',{name,value:Number(value)}); toast(name+' brightness='+(r.brightness ?? value)+(r.warning?';'+r.warning:''), !!r.warning); setTimeout(load,300);}catch(e){toast(e.message,true);} } async function setTrigger(name, trigger){ try{ const r=await api('/api/trigger',{name,trigger}); toast(name+' trigger='+(r.active_trigger || trigger)); setTimeout(load,300);}catch(e){toast(e.message,true);} } async function setDelay(name, field, value){ try{ await api('/api/delay',{name,field,value:Number(value)}); toast(name+' '+field+'='+value); setTimeout(load,300);}catch(e){toast(e.message,true);} } async function identify(name){ try{ await api('/api/identify',{name}); toast('Blink '+name); setTimeout(load,3200);}catch(e){toast(e.message,true);} } async function saveLed(name){ try{ await api('/api/save',{name}); toast('已保存 '+name+',重启后自动恢复'); setTimeout(load,300);}catch(e){toast(e.message,true);} } async function deleteSaved(name){ try{ await api('/api/delete-saved',{name}); toast('已取消持久化 '+name); setTimeout(load,300);}catch(e){toast(e.message,true);} } async function applySaved(){ try{ const r=await api('/api/apply-saved',{}); toast('已应用持久化配置:'+(r.applied||0)+' 个'); setTimeout(load,300);}catch(e){toast(e.message,true);} } function colorOf(n,b){ const s=n.toLowerCase(); if(Number(b)<=0) return '#475569'; if(s.includes('red')) return '#ef4444'; if(s.includes('green')) return '#22c55e'; if(s.includes('blue')) return '#3b82f6'; if(s.includes('wlan')) return '#22c55e'; if(s.includes('wan')) return '#3b82f6'; if(s.includes('power')) return '#ef4444'; if(s.includes('sim')) return '#f59e0b'; return '#5eead4'; } function esc(s){ return String(s).replace(/[&<>'"]/g, c=>({'&':'&','<':'<','>':'>',"'":''','"':'"'}[c])); } function attr(s){ return esc(s); } function card(led){ const pct = led.max_brightness>0 ? Math.round(led.brightness*100/led.max_brightness) : 0; const triggers = led.triggers || []; const n = attr(led.name); const triggerSelect = triggers.length ? `` : '无 trigger 文件'; const delay = (led.delay_on !== null || led.delay_off !== null) ? `
timer:
` : ''; return `
${esc(led.name)} ${led.writable?'可写':'只读/权限不足'} ${led.saved?'已持久化':''}
brightness: ${led.brightness} / ${led.max_brightness} (${pct}%)
trigger: ${esc(led.active_trigger || '-')}
path: ${esc(led.path)}
trigger${triggerSelect}
${delay}
`; } async function load(){ try { const data = await api('/api/leds'); document.getElementById('root').innerHTML = data.leds.map(card).join('') || '
没有发现 LED:/sys/class/leds 为空
'; document.getElementById('count').textContent=data.leds.length; } catch(e){ document.getElementById('root').innerHTML='
'+esc(e.message)+'
'; } } window.addEventListener('load', ()=>{ load(); setInterval(load, 5000); }); """ def safe_name(name: str) -> str: name = urllib.parse.unquote(name) if not NAME_RE.match(name) or "/" in name or ".." in name: raise ValueError("invalid led name") return name def led_path(name: str) -> Path: name = safe_name(name) # /sys/class/leds entries are usually symlinks to /sys/devices/... # Do NOT require the resolved target to stay under LED_ROOT, otherwise every real sysfs LED POST is rejected. # safe_name() forbids slash and '..', so joining one basename under LED_ROOT is enough here. p = LED_ROOT / name if not p.exists(): raise ValueError("led not found") if not (p / "brightness").exists(): raise ValueError("not a led sysfs entry") return p def read_text(path: Path) -> Optional[str]: try: return path.read_text().strip() except Exception: return None def write_text(path: Path, value: str) -> None: with path.open("w") as f: f.write(str(value)) f.flush() def active_trigger_name(raw: Optional[str]) -> Optional[str]: _, active = parse_triggers(raw) return active def set_trigger(p: Path, trigger: str) -> bool: trigger_file = p / "trigger" if not trigger_file.exists(): return False raw = read_text(trigger_file) triggers, active = parse_triggers(raw) names = {str(t["name"]) for t in triggers} if names and trigger not in names: raise ValueError(f"trigger not supported: {trigger}") if active == trigger: return True write_text(trigger_file, trigger) # Verify because LED sysfs can accept write but keep previous trigger if unsupported/raced. new_active = active_trigger_name(read_text(trigger_file)) if new_active and new_active != trigger: raise ValueError(f"trigger write did not take effect: requested={trigger}, active={new_active}") return True def parse_triggers(raw: Optional[str]) -> Tuple[List[Dict[str, object]], Optional[str]]: if not raw: return [], None out = [] active = None for part in raw.split(): is_active = part.startswith("[") and part.endswith("]") name = part[1:-1] if is_active else part if is_active: active = name out.append({"name": name, "active": is_active}) return out, active def load_config() -> Dict[str, Dict[str, object]]: try: if not CONFIG_PATH.exists(): return {} data = json.loads(CONFIG_PATH.read_text()) if not isinstance(data, dict): return {} leds = data.get("leds", data) if not isinstance(leds, dict): return {} return {safe_name(str(k)): v for k, v in leds.items() if isinstance(v, dict)} except Exception: return {} def save_config(config: Dict[str, Dict[str, object]]) -> None: CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True) tmp = CONFIG_PATH.with_suffix(CONFIG_PATH.suffix + ".tmp") payload = {"version": 1, "leds": config} tmp.write_text(json.dumps(payload, ensure_ascii=False, indent=2) + "\n") os.replace(tmp, CONFIG_PATH) try: os.chmod(CONFIG_PATH, 0o644) except Exception: pass def current_led_config(name: str) -> Dict[str, object]: p = led_path(name) cfg: Dict[str, object] = {} active = active_trigger_name(read_text(p / "trigger")) if active: cfg["trigger"] = active b = read_text(p / "brightness") if b is not None: try: cfg["brightness"] = int(b) except ValueError: pass for field in ("delay_on", "delay_off"): v = read_text(p / field) if v is not None: try: cfg[field] = int(v) except ValueError: pass return cfg def apply_led_config(name: str, cfg: Dict[str, object]) -> Dict[str, object]: p = led_path(name) result: Dict[str, object] = {"name": name, "ok": True, "errors": []} # Apply trigger first so timer/netdev files appear before setting delay fields. if "trigger" in cfg: try: set_trigger(p, str(cfg["trigger"])) except Exception as e: result["ok"] = False result["errors"].append(f"trigger: {e}") for field in ("delay_on", "delay_off"): if field in cfg and (p / field).exists(): try: write_text(p / field, str(int(cfg[field]))) except Exception as e: result["ok"] = False result["errors"].append(f"{field}: {e}") if "brightness" in cfg: try: max_brightness = int(read_text(p / "max_brightness") or 1) value = max(0, min(max_brightness, int(cfg["brightness"]))) # If trigger is not explicitly set, try none for manual brightness. if "trigger" not in cfg and (p / "trigger").exists(): try: set_trigger(p, "none") except Exception: pass write_text(p / "brightness", str(value)) except Exception as e: result["ok"] = False result["errors"].append(f"brightness: {e}") return result def apply_saved_config() -> List[Dict[str, object]]: config = load_config() results = [] for name, cfg in config.items(): try: results.append(apply_led_config(name, cfg)) except Exception as e: results.append({"name": name, "ok": False, "errors": [str(e)]}) return results def list_leds() -> List[Dict[str, object]]: leds = [] saved_config = load_config() if not LED_ROOT.exists(): return leds for p in sorted(LED_ROOT.iterdir(), key=lambda x: x.name): if not p.is_dir(): continue name = p.name b = read_text(p / "brightness") mb = read_text(p / "max_brightness") tr_raw = read_text(p / "trigger") triggers, active = parse_triggers(tr_raw) delay_on = read_text(p / "delay_on") delay_off = read_text(p / "delay_off") try: brightness = int(b or 0) except ValueError: brightness = 0 try: max_brightness = int(mb or 1) except ValueError: max_brightness = 1 writable = os.access(p / "brightness", os.W_OK) leds.append({ "name": name, "path": str(p), "brightness": brightness, "max_brightness": max_brightness, "triggers": triggers, "active_trigger": active, "delay_on": int(delay_on) if delay_on and delay_on.isdigit() else None, "delay_off": int(delay_off) if delay_off and delay_off.isdigit() else None, "writable": writable, "saved": name in saved_config, }) return leds class Handler(BaseHTTPRequestHandler): server_version = "LedPanel/1.0" def log_message(self, fmt: str, *args): sys.stderr.write("%s - - [%s] %s\n" % (self.client_address[0], self.log_date_time_string(), fmt % args)) def send_json(self, obj: object, status: int = 200): data = json.dumps(obj, ensure_ascii=False).encode("utf-8") self.send_response(status) self.send_header("Content-Type", "application/json; charset=utf-8") self.send_header("Cache-Control", "no-store") self.send_header("Content-Length", str(len(data))) self.end_headers() self.wfile.write(data) def read_body(self) -> Dict[str, object]: length = int(self.headers.get("Content-Length", "0") or 0) if length > 4096: raise ValueError("body too large") raw = self.rfile.read(length).decode("utf-8") if length else "{}" return json.loads(raw or "{}") def do_GET(self): parsed = urllib.parse.urlparse(self.path) if parsed.path == "/": body = f"""LED Manager

LED Manager Panel

管理 {html.escape(str(LED_ROOT))} 下的 LED;配置保存到 {html.escape(str(CONFIG_PATH))};当前 - 个。页面每 5 秒自动刷新。
""" data = body.encode("utf-8") self.send_response(200) self.send_header("Content-Type", "text/html; charset=utf-8") self.send_header("Content-Length", str(len(data))) self.end_headers() self.wfile.write(data) elif parsed.path == "/api/leds": self.send_json({"ok": True, "leds": list_leds()}) else: self.send_json({"ok": False, "error": "not found"}, 404) def do_POST(self): parsed = urllib.parse.urlparse(self.path) try: data = self.read_body() name = None p = None if parsed.path not in ("/api/apply-saved",): name = safe_name(str(data.get("name", ""))) p = led_path(name) if parsed.path == "/api/brightness": max_brightness = int(read_text(p / "max_brightness") or 1) value = int(data.get("value", 0)) value = max(0, min(max_brightness, value)) # Manual brightness only takes effect when trigger is none. # Some device LEDs do not support none; in that case still write brightness and report the actual state. trigger_warning = None if (p / "trigger").exists(): try: set_trigger(p, "none") except Exception as e: trigger_warning = str(e) write_text(p / "brightness", str(value)) actual = read_text(p / "brightness") self.send_json({"ok": True, "brightness": actual, "warning": trigger_warning}) elif parsed.path == "/api/trigger": trigger = str(data.get("trigger", "")) if not NAME_RE.match(trigger): raise ValueError("invalid trigger") set_trigger(p, trigger) self.send_json({"ok": True, "active_trigger": active_trigger_name(read_text(p / "trigger"))}) elif parsed.path == "/api/delay": field = str(data.get("field", "")) if field not in ("delay_on", "delay_off"): raise ValueError("invalid delay field") value = max(0, int(data.get("value", 0))) write_text(p / field, str(value)) self.send_json({"ok": True}) elif parsed.path == "/api/save": config = load_config() config[name] = current_led_config(name) save_config(config) self.send_json({"ok": True, "config": config[name], "path": str(CONFIG_PATH)}) elif parsed.path == "/api/delete-saved": config = load_config() existed = name in config config.pop(name, None) save_config(config) self.send_json({"ok": True, "deleted": existed, "path": str(CONFIG_PATH)}) elif parsed.path == "/api/apply-saved": results = apply_saved_config() self.send_json({"ok": True, "applied": sum(1 for r in results if r.get("ok")), "results": results}) elif parsed.path == "/api/identify": old_trigger = read_text(p / "trigger") old_brightness = read_text(p / "brightness") try: if (p / "trigger").exists(): set_trigger(p, "timer") if (p / "delay_on").exists(): write_text(p / "delay_on", "200") if (p / "delay_off").exists(): write_text(p / "delay_off", "200") else: mb = int(read_text(p / "max_brightness") or 1) for _ in range(6): write_text(p / "brightness", str(mb)); time.sleep(0.2) write_text(p / "brightness", "0"); time.sleep(0.2) time.sleep(3) finally: if old_trigger and "[" in old_trigger: _, active = parse_triggers(old_trigger) if active: try: set_trigger(p, active) except Exception: pass if old_brightness is not None: try: write_text(p / "brightness", old_brightness) except Exception: pass self.send_json({"ok": True}) else: self.send_json({"ok": False, "error": "not found"}, 404) except PermissionError: self.send_json({"ok": False, "error": "权限不足:请用 root 运行,或给 /sys/class/leds 写权限"}, 403) except Exception as e: self.send_json({"ok": False, "error": str(e)}, 400) def main(): global LED_ROOT, CONFIG_PATH ap = argparse.ArgumentParser(description="Tiny web panel for /sys/class/leds") ap.add_argument("--host", default="0.0.0.0", help="listen host, default 0.0.0.0") ap.add_argument("--port", type=int, default=8088, help="listen port, default 8088") ap.add_argument("--led-root", default=str(LED_ROOT), help="LED sysfs root, default /sys/class/leds") ap.add_argument("--config", default=str(CONFIG_PATH), help="persistent config path, default /etc/led-manager/config.json") ap.add_argument("--no-apply", action="store_true", help="do not apply saved config on startup") args = ap.parse_args() LED_ROOT = Path(args.led_root) CONFIG_PATH = Path(args.config) if not args.no_apply: results = apply_saved_config() if results: print(f"Applied saved LED config: {results}", flush=True) httpd = ThreadingHTTPServer((args.host, args.port), Handler) print(f"LED Manager Panel listening on http://{args.host}:{args.port} ; LED_ROOT={LED_ROOT}; CONFIG_PATH={CONFIG_PATH}", flush=True) httpd.serve_forever() if __name__ == "__main__": main()