feat: unify proxy config and centralize runtime logging

utils/network_proxy.py

@@ -0,0 +1,53 @@
+"""统一网络代理配置工具。"""
+
+import os
+from typing import Optional
+
+
+def get_proxy_url() -> Optional[str]:
+    """从环境变量读取代理地址，统一兼容不同变量名。"""
+    use_proxy = os.getenv("USE_PROXY", "false").lower() == "true"
+    if not use_proxy:
+        return None
+
+    return (
+        os.getenv("SOCKS5_PROXY")
+        or os.getenv("ALL_PROXY")
+        or os.getenv("HTTPS_PROXY")
+        or os.getenv("HTTP_PROXY")
+    )
+
+
+def get_send_msg_proxy_url() -> Optional[str]:
+    """读取 send_msg 独立代理，未配置时回退到全局代理。"""
+    send_msg_proxy = os.getenv("SEND_MSG_PROXY")
+    if send_msg_proxy:
+        return send_msg_proxy
+
+    send_msg_proxy_port = os.getenv("SEND_MSG_PROXY_PORT")
+    if send_msg_proxy_port:
+        return f"socks5://127.0.0.1:{send_msg_proxy_port}"
+
+    return get_proxy_url()
+
+
+def apply_global_proxy_from_env() -> Optional[str]:
+    """将代理写入全局环境变量，确保 requests/httpx/curl 等默认走同一代理。"""
+    proxy_url = get_proxy_url()
+    if not proxy_url:
+        return None
+
+    os.environ["HTTP_PROXY"] = proxy_url
+    os.environ["HTTPS_PROXY"] = proxy_url
+    os.environ["ALL_PROXY"] = proxy_url
+    os.environ["http_proxy"] = proxy_url
+    os.environ["https_proxy"] = proxy_url
+    os.environ["all_proxy"] = proxy_url
+
+    # 保留本地直连，避免影响本机服务调用。
+    if not os.getenv("NO_PROXY"):
+        os.environ["NO_PROXY"] = "127.0.0.1,localhost"
+    if not os.getenv("no_proxy"):
+        os.environ["no_proxy"] = os.environ["NO_PROXY"]
+
+    return proxy_url

utils/project_logger.py

@@ -0,0 +1,40 @@
+"""项目统一日志工具。"""
+
+import logging
+import os
+from logging.handlers import RotatingFileHandler
+
+
+def get_project_logger(name: str) -> logging.Logger:
+    """返回统一配置的日志实例，避免重复添加处理器。"""
+    logger = logging.getLogger(name)
+    if logger.handlers:
+        return logger
+
+    os.makedirs("logs", exist_ok=True)
+
+    logger.setLevel(logging.INFO)
+    logger.propagate = False
+
+    formatter = logging.Formatter(
+        "%(asctime)s | %(name)s | %(levelname)s | %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+
+    file_handler = RotatingFileHandler(
+        "logs/project.log",
+        maxBytes=10 * 1024 * 1024,
+        backupCount=5,
+        encoding="utf-8",
+    )
+    file_handler.setFormatter(formatter)
+    file_handler.setLevel(logging.INFO)
+
+    console_handler = logging.StreamHandler()
+    console_handler.setFormatter(formatter)
+    console_handler.setLevel(logging.INFO)
+
+    logger.addHandler(file_handler)
+    logger.addHandler(console_handler)
+
+    return logger

utils/send_msg.py

@@ -1,4 +1,10 @@
 import requests
+from utils.network_proxy import apply_global_proxy_from_env, get_send_msg_proxy_url
+from utils.project_logger import get_project_logger
+
+
+apply_global_proxy_from_env()
+logger = get_project_logger("send_msg")
 
 class LarkNotifier:
     """飞书消息发送工具类"""
@@ -12,6 +18,16 @@ class LarkNotifier:
         # 使用 Session 可以复用底层 TCP 连接，提升发送效率
         self.session = requests.Session()
 
+        proxy_url = get_send_msg_proxy_url()
+        if proxy_url:
+            self.session.proxies.update({
+                "http": proxy_url,
+                "https": proxy_url,
+            })
+            logger.info("send_msg 使用独立代理: %s", proxy_url)
+        else:
+            logger.info("send_msg 未启用代理")
+
     def send_alert(self, title: str, content: str):
         """
         发送通用文本告警
@@ -29,10 +45,10 @@ class LarkNotifier:
             # 使用 data=payload 发送 Form Data
             response = self.session.post(self.url, data=payload, timeout=5)
             response.raise_for_status()
-            print(f"告警发送成功: {title}")
+            logger.info("告警发送成功: %s", title)
         except Exception as e:
             # 告警系统自身的错误只记录日志，绝不抛出异常影响主程序
-            print(f"发送飞书告警失败: {e}")
+            logger.error("发送飞书告警失败: %s", e)
 
 # 实例化一个全局单例供其他模块直接导入使用
-lark_notifier = LarkNotifier()
+lark_notifier = LarkNotifier()