feat: 零配置开箱(自动生成演示配置探测 baidu)+ 多平台打包发布流水线

Author: githubflyideas

.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: release
+on:
+  push:
+    tags: ['v*']
+permissions:
+  contents: write
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+      - name: test
+        run: go test ./...
+      - name: build & package
+        run: |
+          set -e
+          for target in linux/amd64 linux/arm64 darwin/amd64 darwin/arm64; do
+            GOOS=${target%/*}; GOARCH=${target#*/}
+            dir="pingping-${GITHUB_REF_NAME}-${GOOS}-${GOARCH}"
+            mkdir -p "$dir"
+            CGO_ENABLED=0 GOOS=$GOOS GOARCH=$GOARCH \
+              go build -trimpath -ldflags "-s -w -X main.version=${GITHUB_REF_NAME}" \
+              -o "$dir/pingping" .
+            cp README.md LICENSE config.example.jsonc "$dir/"
+            tar czf "$dir.tar.gz" "$dir"
+          done
+          sha256sum pingping-*.tar.gz > SHA256SUMS
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            pingping-*.tar.gz
+            SHA256SUMS
+          body: |
+            ## 开箱即用
+            ```bash
+            tar xzf pingping-*.tar.gz && cd pingping-*/
+            ./pingping
+            ```
+            首次运行自动生成演示配置(探测 www.baidu.com),打开 http://localhost:8517 即见烟雾图。
+            Linux 静态编译,所有发行版通用;非 root 运行若提示无法创建 ICMP socket,执行
+            `sudo setcap cap_net_raw+ep ./pingping` 或放开 `net.ipv4.ping_group_range`。

README.md

@@ -25,17 +25,16 @@ A single-binary network link quality oscilloscope — modern Smokeping semantics
 
 ## 快速开始
 
+从 [Releases](https://github.com/githubflyideas/pingping/releases) 下载对应平台的包(Linux 静态编译,所有发行版通用;另有 macOS 双架构):
+
 ```bash
-# 1. 构建(或从 Releases 下载)
-go build -o pingping .
+tar xzf pingping-v*-linux-amd64.tar.gz && cd pingping-*/
+./pingping
+```
 
-# 2. 配置
-cp config.example.jsonc pingping.jsonc && vi pingping.jsonc   # 填 targets 和飞书 webhook
+首次运行自动生成演示配置(探测 www.baidu.com),按提示打开 http://localhost:8517,几分钟后第一缕烟雾成形。之后编辑 `pingping.jsonc` 换成你自己的目标和飞书 webhook,重启生效。
 
-# 3. 运行
-./pingping -c pingping.jsonc
-# 浏览器打开 http://<host>:8517 看烟雾图
-```
+也可以源码构建:`go build -o pingping .`(无任何第三方依赖)。
 
 无 root 环境需要放开 unprivileged ICMP(多数发行版默认已放开):
 

main.go

@@ -14,6 +14,31 @@ import (
 
 var version = "dev"
 
+// demoConfig 是首次运行自动生成的演示配置。fast 档让第一屏的烟雾几分钟内成形。
+const demoConfig = `{
+  // pingping 演示配置 —— 首次运行自动生成,按需修改后重启生效
+  // 完整字段说明见仓库内 config.example.jsonc
+  "listen": "0.0.0.0:8517",
+  "targets": [
+    { "name": "演示 · 百度", "type": "icmp", "host": "www.baidu.com", "pace": "fast" }
+  ]
+  // 飞书推送:去掉下面的注释,填入你的群机器人 webhook
+  //,"webhooks": [
+  //  { "name": "运维群", "url": "https://open.feishu.cn/open-apis/bot/v2/hook/xxxx" }
+  //]
+}
+`
+
+// portOf 从监听地址提取给人看的端口后缀。
+func portOf(listen string) string {
+	for i := len(listen) - 1; i >= 0; i-- {
+		if listen[i] == ':' {
+			return listen[i:]
+		}
+	}
+	return ":8517"
+}
+
 func main() {
 	cfgPath := flag.String("c", "pingping.jsonc", "配置文件路径 (JSONC)")
 	showVer := flag.Bool("version", false, "打印版本")
@@ -26,7 +51,17 @@ func main() {
 
 	cfg, err := LoadConfig(*cfgPath)
 	if err != nil {
-		log.Fatalf("配置加载失败: %v", err)
+		// 零配置开箱:找不到配置文件时自动生成演示配置(探测 www.baidu.com),
+		// 下载解压、执行、开浏览器,三十秒看到第一缕烟。
+		if os.IsNotExist(err) {
+			if werr := os.WriteFile(*cfgPath, []byte(demoConfig), 0o644); werr == nil {
+				log.Printf("未找到配置文件,已生成演示配置 %s(探测 www.baidu.com),按需修改后重启生效", *cfgPath)
+				cfg, err = LoadConfig(*cfgPath)
+			}
+		}
+		if err != nil {
+			log.Fatalf("配置加载失败: %v", err)
+		}
 	}
 
 	store, err := NewStore(cfg.DataDir, cfg.Targets)
@@ -53,6 +88,7 @@ func main() {
 
 	log.Printf("pingping %s 启动 · %d 个目标 · 监听 %s · 数据目录 %s",
 		version, len(cfg.Targets), cfg.Listen, cfg.DataDir)
+	log.Printf("➜  打开浏览器访问 http://localhost%s 查看烟雾图", portOf(cfg.Listen))
 
 	sig := make(chan os.Signal, 1)
 	signal.Notify(sig, syscall.SIGINT, syscall.SIGTERM)

probe.go

@@ -140,14 +140,14 @@ func collect(fd int, raw bool, id int, nonce [4]byte, sendAt []time.Time, got []
 		if remain <= 0 {
 			return
 		}
-		tvUsec := remain.Microseconds()
-		if tvUsec > 50000 {
-			tvUsec = 50000 // 50ms 一跳,保证按时退出
+		wait := remain
+		if wait > 50*time.Millisecond {
+			wait = 50 * time.Millisecond // 50ms 一跳,保证按时退出
 		}
-		if tvUsec < 1000 {
-			tvUsec = 1000
+		if wait < time.Millisecond {
+			wait = time.Millisecond
 		}
-		tv := syscall.Timeval{Sec: 0, Usec: tvUsec}
+		tv := syscall.NsecToTimeval(wait.Nanoseconds()) // 可移植:linux/darwin 的 Timeval 字段类型不同
 		syscall.SetsockoptTimeval(fd, syscall.SOL_SOCKET, syscall.SO_RCVTIMEO, &tv)
 		n, _, err := syscall.Recvfrom(fd, buf, 0)
 		now := time.Now()