"""内置管理接口(HTTP)。 存在的唯一目的是解决「服务器没有桌面,丰享登录必须人工过验证码」这个矛盾: 本机登录后把 Cookie POST 过来,容器内立刻热生效,不用重启、不用 SSH 拷文件。 接口: GET /healthz 健康检查(Docker HEALTHCHECK 用,免鉴权,只返回运行指标) GET /api/status 运行状态(同上,别名) POST /api/cookies 更新 Cookie(需鉴权) POST /api/test-push 发一条测试消息(需鉴权) 鉴权:请求头 X-Auth-Token 或 Authorization: Bearer ,也支持 ?token=。 安全默认:未配置 token 时只接受来自 127.0.0.1 的写请求。 """ from __future__ import annotations import json import logging import threading from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer from typing import Any, Dict from urllib.parse import parse_qs, urlparse from .config import Config log = logging.getLogger("fengxiang.admin") MAX_BODY = 64 * 1024 class _Handler(BaseHTTPRequestHandler): server_version = "fengxiang-admin/1.0" monitor = None # 由 AdminServer 注入 cfg = None # -------- 工具方法 -------- def log_message(self, fmt: str, *args: Any) -> None: log.debug("%s - %s", self.address_string(), fmt % args) def _json(self, code: int, payload: Dict[str, Any]) -> None: body = json.dumps(payload, ensure_ascii=False).encode("utf-8") self.send_response(code) self.send_header("Content-Type", "application/json; charset=utf-8") self.send_header("Content-Length", str(len(body))) self.end_headers() self.wfile.write(body) def _auth_ok(self, query: Dict[str, list]) -> bool: token = self.cfg.admin.token if not token: # 未配置 token:仅允许本机回环写入 return self.client_address[0] in ("127.0.0.1", "::1") supplied = ( self.headers.get("X-Auth-Token") or (self.headers.get("Authorization") or "").replace("Bearer ", "").strip() or (query.get("token") or [""])[0] ) return supplied == token def _read_json(self) -> Dict[str, Any]: length = int(self.headers.get("Content-Length") or 0) if length <= 0 or length > MAX_BODY: raise ValueError("请求体为空或过大") raw = self.rfile.read(length) data = json.loads(raw.decode("utf-8")) if not isinstance(data, dict): raise ValueError("请求体必须是 JSON 对象") return data # -------- 路由 -------- def do_GET(self) -> None: # noqa: N802 path = urlparse(self.path).path if path in ("/healthz", "/api/status", "/api/health"): self._json(200, self.monitor.status()) return if path == "/": self._json(200, { "service": "fengxiang-monitor admin", "endpoints": ["GET /healthz", "GET /api/status", "POST /api/cookies", "POST /api/test-push"], }) return self._json(404, {"error": "not found"}) def do_POST(self) -> None: # noqa: N802 parsed = urlparse(self.path) path = parsed.path query = parse_qs(parsed.query) if not self._auth_ok(query): self._json(401, {"error": "unauthorized"}) return if path == "/api/cookies": try: payload = self._read_json() except (ValueError, json.JSONDecodeError) as exc: self._json(400, {"error": f"参数错误: {exc}"}) return cookies = payload.get("cookies", payload) if not isinstance(cookies, dict) or not cookies: self._json(400, {"error": "cookies 必须是非空对象"}) return try: ok = self.monitor.update_cookies({str(k): str(v) for k, v in cookies.items()}) except Exception as exc: # noqa: BLE001 log.exception("写入 Cookie 失败") self._json(500, {"error": str(exc)}) return if ok: self._json(200, {"ok": True, "count": len(cookies), "status": self.monitor.status()}) else: self._json(422, {"ok": False, "error": "Cookie 校验未通过,可能已失效"}) return if path == "/api/test-push": try: payload = self._read_json() except (ValueError, json.JSONDecodeError): payload = {} text = payload.get("text") or "【丰享监控】测试消息,请忽略。" result = self.monitor.dispatcher.notify(text) self._json(200, {"result": result}) return self._json(404, {"error": "not found"}) class AdminServer: def __init__(self, cfg: Config, monitor) -> None: self.cfg = cfg self.monitor = monitor handler = type("BoundHandler", (_Handler,), {"monitor": monitor, "cfg": cfg}) self.httpd = ThreadingHTTPServer((cfg.admin.host, cfg.admin.port), handler) self.httpd.daemon_threads = True self._thread = threading.Thread(target=self.httpd.serve_forever, name="admin-http", daemon=True) def start(self) -> None: self._thread.start() log.info("管理接口已启动 http://%s:%d (健康检查 /healthz)", self.cfg.admin.host, self.cfg.admin.port) if not self.cfg.admin.token: log.warning("未设置 admin.token,写接口仅允许本机回环访问") def stop(self) -> None: try: self.httpd.shutdown() self.httpd.server_close() except Exception: # noqa: BLE001 pass