pingping: JSONL storage only; SQLite build moved to fogping

Author: githubflyideas

.github/FUNDING.yml

@@ -1,2 +1,3 @@
 github: githubflyideas
+# 爱发电开通后取消注释:
 # custom: ["https://afdian.com/a/githubflyideas"]

.goreleaser.yaml

@@ -1,6 +1,6 @@
-# GoReleaser — linux/amd64 only. SQLite (mattn/go-sqlite3) needs CGO, which rules out
-# cross-compiling to darwin and arm64 from the release runner. scp-and-run stays the
-# primary path; the Homebrew tap is gone with the macOS builds.
+# GoReleaser — cross-platform tarballs. No apt/deb, no rpm, no brew tap (dropped:
+# not worth the token upkeep for a secondary channel — scp-and-run is the primary path).
+# Zero-dependency single binary.
 version: 2
 
 project_name: pingping
@@ -14,25 +14,22 @@ builds:
     main: .
     binary: pingping
     env:
-      - CGO_ENABLED=1
+      - CGO_ENABLED=0
     flags:
       - -trimpath
     ldflags:
-      # Static link: CGO otherwise ties the binary to the builder glibc, so one built
-      # on Ubuntu 24 refuses to start on anything older. Static keeps "copy it over
-      # and run it" true, which is the whole point of this project.
-      - -s -w -X main.version={{ .Version }} -linkmode external -extldflags -static
-    goos: [linux]
-    goarch: [amd64]
-
-# Tarballs for the "scp and run" crowd. No clean.sh: storage is SQLite now and
-# retention is handled in-process by --days.
+      - -s -w -X main.version={{ .Version }}
+    goos: [linux, darwin]
+    goarch: [amd64, arm64]
+
+# Tarballs for the "scp and run" crowd — unchanged experience, plus LICENSE and clean.sh.
 archives:
   - id: tar
     formats: [tar.gz]
     name_template: "{{ .ProjectName }}-v{{ .Version }}-{{ .Os }}-{{ .Arch }}"
     files:
       - LICENSE
+      - clean.sh
 
 checksum:
   name_template: "SHA256SUMS"
@@ -45,9 +42,4 @@ release:
   header: |
     ## Install
 
-    ```bash
-    tar xzf pingping-*-linux-amd64.tar.gz && ./pingping
-    ```
-    Storage is SQLite; history is kept for 40 days by default (`--days=300` for longer).
-    linux/amd64 only in this release — SQLite needs CGO, so the other platforms are
-    not cross-compiled here.
+    scp a tarball below, extract, `./pingping`. Zero dependencies.

README.md

@@ -1,33 +1,29 @@
-A smokeping-like network tool
------One binary file-----
-Just scp and run
+🌐 [English](#english) · [中文](#中文) · [Español](#español) · [Français](#français) · [Português](#português) · [Deutsch](#deutsch) · [Русский](#русский) · [日本語](#日本語) · [한국어](#한국어) · [Bahasa Indonesia](#bahasa-indonesia) · [Tiếng Việt](#tiếng-việt) · [العربية](#العربية) · [हिन्दी](#हिन्दी) · [বাংলা](#বাংলা) · [اردو](#اردو) · [Türkçe](#türkçe) · [ไทย](#ไทย)
 
+![window: a 40-minute congestion event — smoke spreads, bursts marked ◆](docs/hero8.png)
+![window: a 40-minute congestion event — smoke spreads, bursts marked ◆](docs/hero9.png)
 
-```bash
-mkdir /home/pingping -p &&cd /home/pingping
 
+A smokeping-like network tool.One binary file,
+Just scp and run
+
+```bash
+cd /home
 wget https://github.com/githubflyideas/pingping/releases/download/v2.11.2/pingping-v2.11.2-linux-amd64.tar.gz
-tar -zxvf pingping-v2.11.2-linux-amd64.tar.gz
-./pingping user=admin passwd=admin
 
-or v3.2.0
+tar -zxvf pingping-v2.11.2-linux-amd64.tar.gz
 
-wget https://github.com/githubflyideas/pingping/releases/download/v3.2.0/pingping-v3.2.0-linux-amd64.tar.gz
-tar -zxvf pingping-v3.2.0-linux-amd64.tar.gz
+cd pingping-v2.11.2-linux-amd64
 ./pingping user=admin passwd=admin
 ```
-Open http://localhost:8517 and watch your first puff of network smoke　　
-
-*v2.x:Storage is JSON  ;    history is kept for 300 days by default   
-*v3.x:Storage is SQLite; history is kept for 40  days by default (--days=300 for longer)
+Open http://localhost:8517 and watch your first puff of network smoke.
 
 -----------------------------------------------------------
 Add target host 
 ```
  echo "1.2.3.4 myhost pace=fast"    >> targets/ping.list
  echo "10.0.0.5:443 ads-api"        >> targets/tcp.list
 ```
- 
 Data cleanup
 Retention is fixed at 300 days. To purge earlier by hand, the bundled `clean.sh` is all you need
 (data is plain per-day JSONL, so cleanup is just find+delete):
@@ -37,12 +33,6 @@ Retention is fixed at 300 days. To purge earlier by hand, the bundled `clean.sh`
 ```
 Latest [Releases](https://github.com/githubflyideas/pingping/releases)   
 
-🌐 [English](#english) · [中文](#中文) · [Español](#español) · [Français](#français) · [Português](#português) · [Deutsch](#deutsch) · [Русский](#русский) · [日本語](#日本語) · [한국어](#한국어) · [Bahasa Indonesia](#bahasa-indonesia) · [Tiếng Việt](#tiếng-việt) · [العربية](#العربية) · [हिन्दी](#हिन्दी) · [বাংলা](#বাংলা) · [اردو](#اردو) · [Türkçe](#türkçe) · [ไทย](#ไทย)
-![window: a 40-minute congestion event — smoke spreads, bursts marked ◆](docs/hero15.png)
-![window: a 40-minute congestion event — smoke spreads, bursts marked ◆](docs/hero17.png)
-![window: a 40-minute congestion event — smoke spreads, bursts marked ◆](docs/hero16.png)
-
-
 ## English
 
 PingPing is a lightweight network latency and link quality visualization tool.
@@ -361,7 +351,7 @@ Friendly Links smokeping--- https://github.com/oetiker/SmokePing
 
 pingping  is a minimalist smokeping-like network oscilloscope: probes go in, JSONL text files sit on disk (300-day retention). It features a built-in, read-only Web UI with native auth—no external databases, Nginx, or Caddy required. Just scp and run.
 
-If you need alerting, multi-platform notifications, hot reload, or tiered storage, that lives in the sibling project fogping.
+pingping stays on plain JSONL and stays cgo-free. If you want SQLite storage with indexed queries and in-process rollup/retention, that is the sibling project [fogping](https://github.com/githubflyideas/fogping).
 
 ## License
 

clean.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+# clean.sh [N] — delete pingping probe data older than N days (default 30).
+# Data files are plain per-day JSONL under ./data/<target>/YYYY-MM-DD.jsonl,
+# so cleanup is just find+delete. Run from the pingping directory.
+days="${1:-30}"
+find ./data -type f -name '20*.jsonl' -mtime +"$days" -print -delete

config.go

@@ -1,7 +1,7 @@
 package main
 
 import (
-	"fmt"
+		"fmt"
 	"net"
 	"os"
 	"path/filepath"
@@ -29,8 +29,8 @@ func defaultConfig() *Config {
 		DataDir:       "./data",
 		TargetsDir:    "./targets",
 		Probe:         ProbeCfg{IntervalSec: 60, Packets: 20, GapMs: 50, TimeoutMs: 1000},
-		HotDays:       2,  // raw samples: enough for the sub-day windows
-		RetentionDays: 40, // hourly rollups; --days overrides
+		HotDays:       30,
+		RetentionDays: 300,
 	}
 }
 
@@ -99,6 +99,7 @@ func validateTargets(cfg *Config) error {
 	return nil
 }
 
+
 // loadTargetLists reads targets/ping.list and tcp.list.
 // line format: host[:port]  [name...]  [pace=fast|slow] [interval=sec]
 func loadTargetLists(dir string) ([]TargetCfg, error) {
@@ -168,3 +169,4 @@ func parseListLine(line, typ string) (TargetCfg, error) {
 	}
 	return t, nil
 }
+

docs/advance.readme.md

@@ -0,0 +1,44 @@
+systemd
+
+# /etc/systemd/system/pingping.service
+[Unit]
+Description=pingping link quality oscilloscope
+After=network-online.target
+
+[Service]
+ExecStart=/opt/pingping/pingping -c /opt/pingping/pingping.jsonc
+WorkingDirectory=/opt/pingping
+Restart=always
+RestartSec=5
+#2way #not root user
+# 1) sysctl net.ipv4.ping_group_range="0 2147483647"
+# 2) AmbientCapabilities=CAP_NET_RAW
+User=pingping
+AmbientCapabilities=CAP_NET_RAW
+
+[Install]
+WantedBy=multi-user.target
+useradd -r -s /sbin/nologin pingping
+mkdir -p /opt/pingping && cp pingping /opt/pingping/ && chown -R pingping: /opt/pingping
+systemctl enable --now pingping
+
+------------------------ssl behind caddy------
+
+Caddy( auto HTTPS + basic auth):
+
+ping.example.com {
+    basic_auth {
+        yong $2a$14$...   # caddy hash-password 
+    }
+    reverse_proxy 127.0.0.1:8517
+}
+Nginx:
+
+server {
+    listen 443 ssl;
+    server_name ping.example.com;
+    auth_basic "pingping";
+    auth_basic_user_file /etc/nginx/htpasswd;   # htpasswd -c generation
+    
+    location / { proxy_pass http://127.0.0.1:8517; }
+}