feat: --localhost flag for reverse-proxy auth, split config files, Google demo target

- --localhost binds 127.0.0.1 only; auth/TLS delegated to Caddy/Nginx/Apache (DEPLOY.md examples)
- optional split configs: webhooks.jsonc (replaces section), alerts.jsonc (partial override over defaults)
- shipped examples: webhooks.example.jsonc, alerts.example.jsonc, targets/*.list.example
- zero-config demo target: www.baidu.com -> www.google.com

Author: githubflyideas

DEPLOY.md

@@ -42,3 +42,36 @@ systemctl enable --now pingping
 # crontab,配合 healthchecks.io 或内网等价物
 */5 * * * * curl -fsS http://127.0.0.1:8517/api/targets >/dev/null && curl -fsS https://hc-ping.com/<uuid> >/dev/null
 ```
+
+## 反向代理认证(--localhost)
+
+不想让 pingping 自己管密码?加 `--localhost` 参数只绑定 127.0.0.1,认证和 TLS 交给前端反代:
+
+```bash
+./pingping --localhost -c pingping.jsonc
+```
+
+Caddy(自动 HTTPS + basic auth):
+
+```
+ping.example.com {
+    basic_auth {
+        yong $2a$14$...   # caddy hash-password 生成
+    }
+    reverse_proxy 127.0.0.1:8517
+}
+```
+
+Nginx:
+
+```nginx
+server {
+    listen 443 ssl;
+    server_name ping.example.com;
+    auth_basic "pingping";
+    auth_basic_user_file /etc/nginx/htpasswd;   # htpasswd -c 生成
+    location / { proxy_pass http://127.0.0.1:8517; }
+}
+```
+
+此时可不设 `web_password`(反代已挡在前面),或两层都开当双保险。

alerts.example.jsonc

@@ -0,0 +1,12 @@
+{
+  // 告警单独配置文件 —— 复制为 alerts.jsonc(与 pingping.jsonc 同目录)后生效,
+  // 只需写想改的字段,未写的保持内置默认;目标级 sensitivity 三档在此基础上缩放。
+  "alerts": {
+    "cooldown_min": 30,      // 同一告警重复推送冷却
+    "recover_min": 15,       // 持续正常多久才发恢复
+    "degrade_ratio": 1.5,    // P99 超基线倍数判劣化
+    "degrade_min_ms": 10,    // 且绝对增量下限,防低延迟链路误报
+    "burst_z": 3.5,          // 丢包突发 robust z-score 阈值
+    "burst_alert_n": 3       // 30 分钟内突发 N 次升级为告警
+  }
+}

config.example.jsonc

@@ -1,5 +1,7 @@
 {
-  // pingping 配置示例 —— 复制为 pingping.jsonc 后修改
+  // pingping 主配置示例 —— 复制为 pingping.jsonc 后修改
+  // 配置可拆分(可选):webhooks → webhooks.jsonc,告警阈值 → alerts.jsonc(与本文件同目录,
+  // 存在即优先);探测目标推荐放 targets/ping.list、tcp.list(见 targets/*.example)
   // 支持 // 和 /* */ 注释。所有字段都有合理默认值,最小配置只需 targets + webhooks。
 
   "listen": "0.0.0.0:8517",     // Web 监听地址

config.go

@@ -171,6 +171,29 @@ func LoadConfig(path string) (*Config, error) {
 	if err := json.Unmarshal(stripJSONC(raw), cfg); err != nil {
 		return nil, fmt.Errorf("解析 %s: %w", path, err)
 	}
+	// 拆分配置:主配置同目录下的 webhooks.jsonc / alerts.jsonc 若存在则优先。
+	// webhooks.jsonc 整体替换 webhooks;alerts.jsonc 在默认值之上做局部覆盖。
+	confDir := filepath.Dir(path)
+	if raw, err := os.ReadFile(filepath.Join(confDir, "webhooks.jsonc")); err == nil {
+		var w struct {
+			Webhooks []WebhookCfg `json:"webhooks"`
+		}
+		if err := json.Unmarshal(stripJSONC(raw), &w); err != nil {
+			return nil, fmt.Errorf("解析 webhooks.jsonc: %w", err)
+		}
+		cfg.Webhooks = w.Webhooks
+	}
+	if raw, err := os.ReadFile(filepath.Join(confDir, "alerts.jsonc")); err == nil {
+		tmp := cfg.Alerts
+		var a struct {
+			Alerts *AlertCfg `json:"alerts"`
+		}
+		a.Alerts = &tmp
+		if err := json.Unmarshal(stripJSONC(raw), &a); err != nil {
+			return nil, fmt.Errorf("解析 alerts.jsonc: %w", err)
+		}
+		cfg.Alerts = tmp
+	}
 	if cfg.TargetsDir == "" {
 		cfg.TargetsDir = "./targets"
 	}

main.go

@@ -30,7 +30,7 @@ const demoConfig = `{
 const demoPingList = `# 一行一个 ICMP 探测目标,# 是注释,改完重启生效
 # 格式:host  [名称]  [pace=fast|slow] [sensitivity=strict|relaxed] [interval=秒] [alerts=false] [自定义k=v]
 # 例:59.43.247.1  香港CN2  pace=fast sensitivity=strict 机房=GZ1 负责人=张三
-www.baidu.com 演示·百度 pace=fast
+www.google.com Demo·Google pace=fast
 `
 
 // portOf 从监听地址提取给人看的端口后缀。
@@ -44,8 +44,9 @@ func portOf(listen string) string {
 }
 
 func main() {
-	cfgPath := flag.String("c", "pingping.jsonc", "配置文件路径 (JSONC)")
-	showVer := flag.Bool("version", false, "打印版本")
+	cfgPath := flag.String("c", "pingping.jsonc", "config file path (JSONC)")
+	localOnly := flag.Bool("localhost", false, "bind 127.0.0.1 only — put Caddy/Nginx/Apache in front for auth/TLS")
+	showVer := flag.Bool("version", false, "print version")
 	flag.Parse()
 
 	if *showVer {
@@ -55,15 +56,15 @@ func main() {
 
 	cfg, err := LoadConfig(*cfgPath)
 	if err != nil {
-		// 零配置开箱:找不到配置文件时自动生成演示配置(探测 www.baidu.com),
+		// 零配置开箱:找不到配置文件时自动生成演示配置(探测 www.google.com),
 		// 下载解压、执行、开浏览器,三十秒看到第一缕烟。
 		if os.IsNotExist(err) {
 			if werr := os.WriteFile(*cfgPath, []byte(demoConfig), 0o644); werr == nil {
 				os.MkdirAll("targets", 0o755)
 				if _, serr := os.Stat("targets/ping.list"); os.IsNotExist(serr) {
 					os.WriteFile("targets/ping.list", []byte(demoPingList), 0o644)
 				}
-				log.Printf("未找到配置文件,已生成演示配置 %s + targets/ping.list(探测 www.baidu.com)", *cfgPath)
+				log.Printf("未找到配置文件,已生成演示配置 %s + targets/ping.list(探测 www.google.com)", *cfgPath)
 				log.Printf("加监控就一行:echo \"1.2.3.4 广州电信\" >> targets/ping.list,重启生效")
 				cfg, err = LoadConfig(*cfgPath)
 			}
@@ -73,6 +74,10 @@ func main() {
 		}
 	}
 
+	if *localOnly {
+		cfg.Listen = "127.0.0.1" + portOf(cfg.Listen)
+	}
+
 	store, err := NewStore(cfg.DataDir, cfg.Targets)
 	if err != nil {
 		log.Fatalf("存储初始化失败: %v", err)

notify_test.go

@@ -1,6 +1,7 @@
 package main
 
 import (
+	"os"
 	"strings"
 	"testing"
 )
@@ -71,3 +72,21 @@ func TestParseListLine(t *testing.T) {
 		t.Fatal("tcp 缺端口应报错")
 	}
 }
+
+func TestSplitConfigFiles(t *testing.T) {
+	dir := t.TempDir()
+	os.WriteFile(dir+"/pingping.jsonc", []byte(`{"targets":[{"name":"t","host":"127.0.0.1"}],
+		"webhooks":[{"name":"inline","url":"http://x/1"}]}`), 0o644)
+	os.WriteFile(dir+"/webhooks.jsonc", []byte(`{"webhooks":[{"name":"split","url":"http://x/2","format":"json"}]}`), 0o644)
+	os.WriteFile(dir+"/alerts.jsonc", []byte(`{"alerts":{"cooldown_min":99}}`), 0o644)
+	cfg, err := LoadConfig(dir + "/pingping.jsonc")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(cfg.Webhooks) != 1 || cfg.Webhooks[0].Name != "split" || cfg.Webhooks[0].Format != "json" {
+		t.Fatalf("webhooks.jsonc 应整体替换: %+v", cfg.Webhooks)
+	}
+	if cfg.Alerts.CooldownMin != 99 || cfg.Alerts.DegradeRatio != 1.5 {
+		t.Fatalf("alerts.jsonc 应局部覆盖且保留默认: %+v", cfg.Alerts)
+	}
+}

targets/ping.list.example

@@ -0,0 +1,5 @@
+# ICMP targets — one per line, restart to apply. Copy to ping.list.
+# format: host  [name]  [pace=fast|slow] [sensitivity=strict|relaxed] [interval=sec] [alerts=false] [custom k=v]
+www.google.com   Demo·Google       pace=fast
+59.43.247.1      HK-CN2            pace=fast sensitivity=strict dc=GZ1 owner=zhang
+203.0.113.10     Branch-Office     pace=slow alerts=false

targets/tcp.list.example

@@ -0,0 +1,3 @@
+# TCP targets — host:port per line, restart to apply. Copy to tcp.list.
+10.0.0.5:443     API-Gateway       interval=30
+203.0.113.20:22  Backup-SSH        pace=slow

webhooks.example.jsonc

@@ -0,0 +1,13 @@
+{
+  // Webhook 单独配置文件 —— 复制为 webhooks.jsonc(与 pingping.jsonc 同目录)后生效,
+  // 存在时整体替代主配置中的 webhooks 段。
+  // secret: 飞书"签名校验"密钥;kinds: alert recovery heartbeat daily manual(不填全收)
+  // format: "feishu"(默认,交互卡片)| "json"(裸 JSON 事件,任意系统可接)
+  "webhooks": [
+    { "name": "Ops",      "url": "https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx",
+      "secret": "", "kinds": ["alert", "recovery", "heartbeat"] },
+    { "name": "Managers", "url": "https://open.feishu.cn/open-apis/bot/v2/hook/yyyyyyyy",
+      "kinds": ["daily"] },
+    { "name": "Platform", "url": "https://your-platform/hook", "format": "json" }
+  ]
+}