Skip to content

Release v1.3.69

Choose a tag to compare

@github-actions github-actions released this 06 Nov 04:58
· 19 commits to main since this release

Release v1.3.69

v1.3.69 follows a review of the server, the web app and the agent (now 1.3.68). It closes security holes, keeps the server honest when its disk fills or its clock steps, and adds a switch for averaged resource charts.

Security

  • Web: an SVG logo or icon could run script. The sanitizer compared tag names with their prefix, so <s:script> (an SVG or XHTML namespace prefix) was kept; it ran in Chromium and WebKit, and on /admin it could read the session. Elements are now judged by namespace and local name, and url(…) to other sites is dropped. Shipped icons and logos come out unchanged (213 of 213).
  • Server: a damaged database (both meta pages bad, or a truncated restore) was replaced by an empty one with the first-run setup open, so the first visitor could set the admin password. The setup now stays locked until it is done from the server itself; the log says how.
  • Server: the login limit counted each IPv6 /64 on its own, so one /48 could buy 327,680 password checks per 15 minutes, more CPU than the server has.
    • A /48 now also has a budget: 20 failures per 15 minutes.
    • At most 2 checks run at once. A login that finds both busy is asked to retry; it is not counted.
  • Server and web: the admin page (and a private dashboard viewed with the session) opened the live stream with the 24-hour session in its URL, which proxies and CDNs log. It now trades the session for a single-use ticket that is valid for 30 s.
  • Server and agent: a newly registered agent could be polled over plain HTTP before its first push, with its secret in the request (seen in 2 of 2 starts). The server now waits 20 s before polling a new registration, and agent 1.3.68 pushes before it registers.
  • Server: an unknown server ID and a wrong secret get the same answer, so the IDs that exist are not revealed. Error responses no longer carry internal error text.
  • Agent 1.3.68:
    • pushes and registrations follow no redirect to another host (their body carries the secret);
    • child processes no longer inherit SECRET.

Robustness

  • Server: when the disk is full, every server used to stay online with frozen numbers, and nothing said so. Now:
    • a push counts only once it is stored;
    • a failed save is logged;
    • /healthz answers 503 while pushes cannot be stored.
  • Server: a step of the server's own clock (an NTP fix) no longer drops TCPing samples for two minutes. The agent clock estimates measure ages on the monotonic clock.
  • Server: changing the shared secret writes the config and every system's secret in one transaction, touching only the secret. It was one commit per system, which could stop halfway and could undo edits made meanwhile.
  • Server: a viewer that stops reading is dropped within about a minute. It used to hold its stream and kernel memory for 8 minutes or more.
  • Server: the TCPing history cache keeps only the gzip copy, so every server's history fits. A client asking for each server in turn no longer makes each request a database read (about 40 ms of CPU each).
  • Web: a stream that connects and then drops is retried with a growing pause, and the connection notice shows. It used to reconnect about once a second without a notice.
  • Agent 1.3.68:
    • after a failed push the next one waits 6, 12, then 24 s; it used to retry every 3 s, each time with the whole backlog;
    • after a rejection (unknown ID, wrong secret) it pushes once a minute and says why in its log.

Design

  • A new switch, Averaged Charts (自定义设置 → 资源历史 → 按时段平均), shows while Resource History is on. It is off by default, and the charts then show every recorded minute, as before. Switched on, they show averages, about 72 points a chart:

    • 24 h: 20-minute averages;
    • 12 h: 10-minute averages;
    • 6 h: 5-minute averages;
    • 1 h: every minute.

    The line under the tabs says which. A day then reads as a curve instead of 1,440 minutes packed two to a pixel, and one minute's spike no longer flattens the rest of the network chart.

Performance

  • Agent 1.3.68 uses HTTP/2 where the server's CDN speaks it (Cloudflare does): 40 % fewer bytes per push.
  • Web: a language switch translates the page once; it ran twice. Opening a row no longer runs a page-wide translation.

Windows

  • Agent 1.3.68: one unreadable drive (a locked BitLocker volume, a dead share) no longer zeroes the disk total, and only the machine's own fixed disks count (no network drives, USB sticks or ISOs).

Compatibility

  • Agent 1.3.68 works with every v1.3 server, and every agent works with this server. Agents installed with auto-update move to 1.3.68 within a day.
  • The server changes and the sanitizer fix are shared with Pulse-Hotaru. Hotaru's pages keep opening the stream with admin_token, which still works.

Verified

  • Go, with the race detector:
    • the locked setup after a damaged database (forwarded headers do not count as local);
    • the /48 login budget and the 2-check limit;
    • the shared-secret transaction;
    • pushes counted only once stored, and /healthz;
    • stream tickets (single use, 30 s, admin view only with a valid session);
    • one answer for an unknown ID and a bad secret;
    • gzip-only cache entries served byte-identical;
    • agent clocks across server clock steps (−10 min to +1 h);
    • the agent's push outcomes, backoff and logs;
    • the Windows drive totals.
  • Containers:
    • a packet capture of agent start-up: the secret on the wire with v1.3.68 and agent 1.3.67 (2 of 2 starts), not with this server (agent 1.3.67) nor with agent 1.3.68;
    • the agent against a server answering 503, hanging, 401 and 404;
    • 50 stalled viewers: dropped within 90 s (v1.3.68: still open after 3 minutes);
    • the new agent against the new server.
  • The sanitizer: 11 crafted SVGs in Chromium, Firefox and WebKit (6, 4 and 7 unsafe before, 0 after), and every shipped icon.
  • Chromium, Firefox and WebKit:
    • the stream tickets on the admin page and a private dashboard;
    • the connect-and-drop stream;
    • the averaged-charts switch: off, the charts draw every minute as v1.3.68 did; on, the averages;
    • the login messages;
    • the logo on /, /login and /admin;
    • a language switch;
    • the regression suites.

📦 Docker Images

  • xhh1128/pulse:1.3.69
  • xhh1128/pulse:latest

📥 Downloads

Client binaries

Platform File
Linux amd64 probe-client
Linux arm64 probe-client-arm64
macOS Intel (amd64) probe-client-darwin-amd64
macOS Apple Silicon (arm64) probe-client-darwin-arm64
Windows amd64 probe-client.exe
Install Script (Linux + macOS) install.sh

Server standalone binaries (uploaded by the standalone workflow)

Platform File
Linux amd64 pulse-server-standalone-linux-amd64
Linux arm64 pulse-server-standalone-linux-arm64

Quick Install (Linux & macOS):

curl -sSL https://raw.githubusercontent.com/xhhcn/Pulse/main/client/install.sh | sudo bash -s -- --id YOUR_ID --server http://YOUR_SERVER:8008

One-click migration to a new host:

PASSWORD="$OLD_ADMIN_PW" \
  sudo -E ./scripts/migrate.sh --from https://old.example.com