容器数是 6 个、6 个、还是 6 个,可服务早被换掉了:用一个 5.5MB 的 Go 单文件把机器每周的变化记下来,再给它套一层别人看不懂的入口

容器数是 6 个、6 个、还是 6 个,可服务早被换掉了:用一个 5.5MB 的 Go 单文件把机器每周的变化记下来,再给它套一层别人看不懂的入口

0 前言

家里那台机器上跑着十几个容器,我基本每周才认真看它一眼。每次看完都得出同一个结论:6 个在跑,没什么变化,还行。

问题是这个结论是错的。有一回我想起某个服务该重启了,打开 docker ps -a 才发现那个容器早就不在列表里了------旧的被我删掉,新的用同一个镜像是同一个服务,名字换成了 xxx-1。在"数量"这个维度上,机器从 6 变成 6,一切安好;在"身份"这个维度上,服务已经换了一茬。

数量是会骗人的。 6 个容器替换掉 6 个容器,CPU 不会跳,内存不会跳,磁盘不会跳,你打开监控图看一小时,曲线平得像没人在家。

这篇要解决的就是这件事:给这台机器装一个每周跑一次、把"这一周到底换了什么"真的说出来的东西,再把它的页面开成一个自己出门也能看的入口。工具选的是 HomeButler------一个 Go 写的单文件二进制,GitHub 上 358 star,v1.8.0 发布于 2026-11-11。选它的理由很直白:零依赖、不用 Docker、不用 JDK、不用 Node,下载解压就是一个可执行文件,跑完能落盘成 JSON 快照,两次快照之间的差异按"身份"而不是"数量"报出来。

图 1:单文件二进制在本机采集快照,两次快照按身份对比,只有比出差异才值得看一眼

1 这个工具在这篇里负责什么

HomeButler 是个面向自托管机器的命令行工具箱,子命令铺得挺开:status 看资源、docker 管容器、ports 列端口、wake 发 Wake-on-LAN、doctor 做体检、serve 起网页看板、mcp 起一个给 AI agent 用的接口。

这篇只用它两件事:

  • report:采集一份快照落到本地,并和上一份快照对比,把差异打印出来
  • serve:把这个机器的当前状态起成一个网页看板,带 token 鉴权

其余的子命令都先放着。不是它们没用,是这篇文章要论证的东西很窄------同一个计数、不同的身份,算不算变化。工具越多越容易写跑偏。

先把结论摆出来:这个工具在"数量"之外还记了一条时间线。它每次采集都会写一份带时间戳的快照到 ~/.homebutler/reports/snapshots/,下次采集时读上一份,逐条比容器的名字和状态、比端口的监听地址、比挂载的磁盘。容器数量一点没变,它也能说出"gone hb-old、new hb-new"。

2 环境准备:确认平台,把二进制拿到手

2.1 先看平台

bash 复制代码
uname -sm

macOS 上 Apple Silicon 输出 Darwin arm64,Intel 输出 Darwin x86_64;Linux 上一般是 Linux x86_64 或 Linux aarch64。这一步别跳过,后面下载哪个包全靠它。

我这台是 Mac mini(M1),下面所有命令都在 darwin/arm64 上跑过。

2.2 下载并解压

拿官方 v1.8.0 的预编译包,解出来是一个二进制加一个 LICENSE、一个 README:

bash 复制代码
mkdir -p ~/hb && cd ~/hb
curl -sL -o homebutler.tar.gz \
  https://github.com/Higangssh/homebutler/releases/download/v1.8.0/homebutler_1.8.0_darwin_arm64.tar.gz
tar xzf homebutler.tar.gz
ls -lh homebutler.tar.gz homebutler

我这边压缩包是 5.5MB,解出来的二进制 13MB 左右。压缩包小,是因为 Go 把依赖都编进去了,不需要额外装运行时。

x86_64 的 Mac 把包名里的 darwin_arm64 换成 darwin_x86_64;Linux 换成 linux_amd64。包名写错会直接 404,curl 下来的文件只有几十个字节,tar 会报 Unrecognized archive format------遇到这个报错,先回去核对包名,不要怀疑 tar。

2.3 跑起来之前先验一下

bash 复制代码
chmod +x ./homebutler
./homebutler version

输出应该是:

text 复制代码
homebutler 1.8.0 (built 2026-11-11T09:52:31Z, go1.26.10)

macOS 上如果弹出"无法验证开发者",在"系统设置 → 隐私与安全性"里点"仍要打开",或者 xattr -d com.apple.quarantine ./homebutler 去掉隔离标记再执行。

版本号对上了,才算这一节做完。这不是形式主义------跑错版本,后面 report 的快照结构对不上,差异会报得很奇怪。

3 第一次采集:从"没有历史"到"有了基线"

3.1 先空跑一次,不落盘

bash 复制代码
./homebutler report --no-save

第一次跑,它会在开头几行告诉你没有上一份快照可比:

text 复制代码
First inspection --- no previous snapshot found

这时候下面那堆 Current Status 全是"当前长什么样",没有 Notable Changes 段。这一步的意义只是确认它能读到你的 Docker、能读到你的磁盘------读完不落盘,不会在 ~/.homebutler 里留下任何东西。

3.2 正式采集第一份基线

bash 复制代码
./homebutler report

输出会变成:

text 复制代码
First inspection --- baseline snapshot created

同时写入一份快照文件,路径形如:

text 复制代码
~/.homebutler/reports/snapshots/snapshot_20261114T061527Z.json

我这台机器上这份文件 51766 字节。文件名是采集时间的 UTC 时间戳。

这里有个容易踩的地方: 快照默认保留最近 30 份(--keep 默认 30),是按份数裁的,不是按天裁的。你要是手一抖一天跑了 30 次,一周前的历史就被挤掉了。周更场景下 30 份够用,但出问题时手贱反复重跑的那种排错习惯,会把这个数吃光。真遇到这种情况,加 --keep 60 或者直接跑一次就把频率稳住。

3.3 第一次跑要看的不是变化,是"它到底在看什么"

第一份快照拿到手,别急着看变化。先看 Current Status 那一段里的三块:磁盘、容器、端口。

我这台机器第一次跑出来,磁盘那一栏是这样的(节选):

text 复制代码
Disk /                            12.0/228.0 GB (19%)
Disk /Volumes/VM                  47.0/1945.6 GB (3%)
Disk /Volumes/.timemachine/BE236CE3-.../2026-03-10-132317.backup   34.0/1945.6 GB (2%)
Disk /Volumes/.timemachine/BE236CE3-.../2026-03-12-074759.backup   38.0/1945.6 GB (2%)

一屏二十多行全是 Time Machine 的备份挂载点。这不是 bug,这是它把挂载的卷全列出来了。 而这一段带来的直接后果是:这东西的默认报告不适合直接截图发出去,备份盘的 UUID、备份日期、容量全在里面。

后面第 7 节会专门处理这件事,现在先记住这个特征。

4 让它说出真正的变化:同一数量的不同身份

这一节是整篇的核心。我在这台机器上完整复现了两遍,每遍只动一个容器。

4.1 先造一个"旧"容器

bash 复制代码
docker create --name hb-old alpine:3.20 sleep 3600
./homebutler report

docker create 只创建不启动,容器处于 Created 状态。这一步跑完,报告的 Notable Changes 里会多出一行:

text 复制代码
new   hb-old   now created

注意 Needs Attention 里的数字也跟着从 7 变成 8------它把 stopped 类容器都算进去了。这个数字你后面还会看到:它不区分"这个容器是故意停的"还是"这个容器已经死了",只数个数。

4.2 换成另一个容器,数量完全不变

bash 复制代码
docker rm -f hb-old
docker create --name hb-new alpine:3.20 sleep 3600
./homebutler report

这一次的输出是我要给你看的重点:

text 复制代码
── Needs Attention ───────────────────────────────────────────
   ⚠️  8 container(s) stopped

── Notable Changes ───────────────────────────────────────────
   gone  hb-old  was created
   new   hb-new  now created

8 还是 8。如果你只盯着那个数字,这一周什么都没发生。可实际发生的事情是:一个容器被删掉了,另一个容器出现了。

把这两个场景放在一起看就清楚了:

看什么 第一次(新增) 第二次(替换)
容器总数 8 8
报告里的告警数字 8 8
变化条数 1 条 new 1 条 gone + 1 条 new

数字一样,变化不一样。这就是这篇开头那个"6 个、6 个、还是 6 个"的来源。

4.3 用 JSON 看差异,别只看人类可读版

人看的那一版排版漂亮,但要做自动化、要存周报、要对比历史,得看 JSON:

bash 复制代码
./homebutler report --json --no-save > /tmp/now.json
python3 -c "
import json
d = json.load(open('/tmp/now.json'))
print('running', d['running_count'], 'stopped', d['stopped_count'], 'ports', d['public_port_count'])
for c in d['notable_changes']:
    print(c['kind'], c['target'], '|', c.get('detail',''))
"

--no-save 这一下是有意的:我只需要看差异,不想为了看一眼在快照目录里留一份垃圾。

notable_changes 里每条的 kind 字段就是差异类型,target 是对象,detail 是补充说明。写周报脚本的时候,按 kind 分组统计就够了。

4.4 落盘快照里的容器长什么样

真正落盘的快照文件比 --json 打出来的报告更全,多了 containers、ports、processes 三段。用 Python 直接读最后一份:

bash 复制代码
python3 - <<'EOF'
import json, glob
f = sorted(glob.glob('/Users/admin/.homebutler/reports/snapshots/*.json'))[-1]
d = json.load(open(f))
print(f)
print('running', d['running_count'], 'stopped', d['stopped_count'])
for c in d['containers'][:3]:
    print(c['name'], '|', c['image'], '|', c['state'], '|', c['ports'])
EOF

我这份最后一份快照里,前三条是:

text 复制代码
hb-new | alpine:3.20 | created |
mysql | mysql:8.4 | restarting |
open-notebook-open_notebook-1 | lfnovo/open_notebook:v1-latest | running | 0.0.0.0:5055->5055/tcp, [::]:5055->5055/tcp, ...

state 和 ports 是两个别处看不到的东西:restarting 能直接告诉你这个容器在反复重启,ports 里的 0.0.0.0: 前缀能告诉你这个端口对全家局域网都开着。这两条信息在"数量"里一个字都看不到。

图 2:两份快照对比,容器计数相同,但 gone/new 两条差异把一次替换完整说出来了

5 让它每周自己跑一次

手跑一次能说明问题是能看见的,但没人会每周记得敲一次命令。得让它自己跑。

macOS 上用 launchd。写一个 plist 放在 ~/Library/LaunchAgents/:

bash 复制代码
mkdir -p ~/Library/LaunchAgents
cat > ~/Library/LaunchAgents/dev.homebutler.weekly.plist <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>dev.homebutler.weekly</string>
  <key>ProgramArguments</key>
  <array>
    <string>/Users/admin/hb/homebutler</string>
    <string>report</string>
  </array>
  <key>StartCalendarInterval</key>
  <dict>
    <key>Weekday</key><integer>1</integer>
    <key>Hour</key><integer>9</integer>
    <key>Minute</key><integer>0</integer>
  </dict>
  <key>StandardOutPath</key><string>/Users/admin/hb/last-report.txt</string>
  <key>StandardErrorPath</key><string>/Users/admin/hb/last-report.err</string>
  <key>RunAtLoad</key><false/>
</dict>
</plist>
EOF
launchctl load ~/Library/LaunchAgents/dev.homebutler.weekly.plist
launchctl list | grep homebutler

三个地方必须改成你自己的:ProgramArguments 里的二进制绝对路径、两个输出文件的路径、以及 Weekday。Weekday 这里 1 是周一,0 和 7 都是周日。

launchctl list | grep homebutler 有一条输出,说明任务已经注册成功。这行输出里第二个字段是上次退出码,刚注册的时候是 -,跑完之后应该是 0。

先别急着等周一。 想立刻验证,把 plist 里的 StartCalendarInterval 换成 <key>StartInterval</key><integer>60</integer>,加载后一分钟内就会跑一次,cat ~/hb/last-report.txt 能看到报告就成。验证完再把这段改回日历触发,重新 launchctl unload + load。

Linux 上对应的就是一行 cron:

bash 复制代码
crontab -e
# 每周一 09:00 采集一份
0 9 * * 1 /home/youruser/hb/homebutler report > /home/youruser/hb/last-report.txt 2>&1

cron 里的路径必须写绝对路径,~ 在 crontab 里不会展开成你的家目录------这个坑踩过的人都记得。

5.1 更狠一点:让它盯重启循环

单看每周快照,有个东西是看不出来的:一个容器在两次采集之间反复重启了 40 次,快照里只是 running。这种情况得用 watch:

bash 复制代码
./homebutler watch --help
./homebutler watch history

这套东西会在后台盯容器的重启,把每次事故的退出码、死前日志、崩溃分类都记下来,连续 10 分钟重启 3 次以上会标成 acute flapping。通知默认是关的,只在本地记录,对不想往外面发消息的机器来说这个默认值是对的。这一块这篇不展开,但值得知道它存在。

6 把它做成网页看板:先让它只对本机开

6.1 起一个不回环以外露脸的看板

bash 复制代码
export HOMEBUTLER_TOKEN=$(openssl rand -hex 16)
./homebutler serve --port 8087

输出一行:

text 复制代码
homebutler dashboard: http://127.0.0.1:8087

serve 的 --host 默认就是 127.0.0.1,这个默认值是对的,别动它。

token 有三种给法,serve --help 里写得很清楚,优先级从高到低是 --token 参数、配置文件里的 web.token、环境变量 HOMEBUTLER_TOKEN。不要用 --token 参数 ,它会在 ps 里对机器上所有用户可见。我这篇统一用环境变量。

token 建议直接存下来,后面每次起服务都要用:

bash 复制代码
echo "export HOMEBUTLER_TOKEN=$(cat /dev/urandom | xxd -p -l 16 | tr -d '\n')" >> ~/.zshrc

顺手说一句,你自己也要有地方查这个 token,不然忘了就进不去。

6.2 验一下它到底护住了什么

这是本节最有价值的一步,三条 curl 全跑一遍:

bash 复制代码
# 首页:没有 token 也能拿到 HTML
curl -s -o /dev/null -w "root=%{http_code}\n" http://127.0.0.1:8087/

# 接口:没有 token 拿数据,被挡
curl -s -o /dev/null -w "api=%{http_code}\n" http://127.0.0.1:8087/api/status

# 接口:token 放在 query 里,一样被挡
curl -s -o /dev/null -w "api_q=%{http_code}\n" "http://127.0.0.1:8087/api/status?token=abc"

# 接口:token 放在 Authorization 头里,通过
curl -s -o /dev/null -w "api_bearer=%{http_code}\n" \
  -H "Authorization: Bearer $HOMEBUTLER_TOKEN" http://127.0.0.1:8087/api/status

我这里的实测结果是 root=200、api=401、api_q=401、api_bearer=200。

这四行说清楚了一件很多人会想当然的事:token 只保护 /api/*,不保护首页。 首页是一个 532 字节的空壳 HTML,真正的内容全在 /assets/index-xxx.js 那个前端包里,数据靠前端带 Authorization 头去请求。

前端把 token 存在哪?我拉了一下它的包,用的是 localStorage.getItem('homebutler.token')。也就是说:浏览器第一次打开页面时,你得自己把 token 填进去,它记在本地。

明白了这一层,后面所有关于"能不能公开"的判断都好做了:公开出去的只是那个空壳 HTML,数据接口在没 token 的情况下是 401。

6.3 顺手对比一下"图省事"的做法

bash 复制代码
./homebutler serve --host 0.0.0.0 --port 8089

它会先打一行警告:

text 复制代码
⚠️  WARNING: binding to 0.0.0.0 exposes the dashboard to all network interfaces.

照常服务,只在开头多那一行警告。我用局域网地址验了一遍:curl -o /dev/null -w "%{http_code}" http://192.168.50.161:8089/ 返回 200,/api/status 仍然是 401,带 Bearer 头是 200。

结论是:绑到 0.0.0.0 不会让数据泄露,但会让局域网里任何人知道你有一台这样的机器、跑着一个这样的看板。 数据在 token 后面,机器本身被看见了。

要不要这么做取决于你的场景,但既然第 7 节要用 cpolar 打通外面,就没有必要再开一层局域网口子------cpolar 只从回环取页面就够了。

7 用 cpolar 把它开成一个自己认得的入口

7.1 为什么一个 index 页也要单独开一层入口

看板只在 127.0.0.1:8087。人在外面时,回一趟家显然不现实。

出门前查一下上周换了什么。这一步省下的不是时间,是那种"好像哪里不对但说不上来"的憋闷------快照不替你判断,它只把两次之间真正动了的东西列出来,剩下的你一眼就能看出来。

真要用 cpolar 的话先装客户端,macOS 用 Homebrew:

bash 复制代码
brew tap probezy/core && brew install cpolar
cpolar version

安装和登录的完整步骤在官网文档 https://www.cpolar.com/docs/ ,下载页在 https://www.cpolar.com/download 。

7.2 隧道指向 8087,别指向别的

bash 复制代码
cpolar http 8087

命令行会在终端里打印一行 Forwarding https://xxxx.cpolar.top -> http://localhost:8087,那串 cpolar.top 就是入口。

如果你习惯用 Web UI,按这个填:隧道名称自己起,协议选 http,本地地址填 8087,域名类型免费套餐选随机域名,地区按需选;建完去"状态 → 在线隧道列表"里看公网地址。

这里有一个决定要自己做:开哪一层。

  • 指 8087:出去的是带 token 的看板,打开是一层需要填 token 的界面
  • 指 9200:那是 cpolar 自己的管理面板,直接给整台机器的隧道管理开了口,不要这么做

我这次的 cpolar 起隧道没起来,10 秒内没打印 Forwarding 那行,进程直接退出、日志是空的。所以这篇里关于隧道地址长什么样、外面能不能打开,用的是官方文档的口径,不是我这台机器上的实测结果。你自己跑的时候以终端里打印出来的那一行为准,看不到那行就是没成,先查 cpolar version 和登录状态,不要继续往下折腾。

7.3 让入口变得"别人看不懂"

回到标题里那个"别人看不懂的入口"。这件事不是靠改端口号或者起个怪名字做到的,靠的是三层:

  1. 入口地址本身不可猜 。cpolar 免费套餐给的是随机子域名(xxxx.cpolar.top),手扫扫不到;代价是免费地址 24 小时内会变,要长期用就得换固定二级子域名,这个需要基础套餐或以上。
  2. 打开后的页面不说明这是台什么机器 。看板首页只是一个空壳 HTML,数据全在 /api/status 后面。
  3. token 不放在 URL 里 。?token= 是 401,必须走 Authorization 头,这就意味着这个地址即使被人看到、被粘到聊天记录里,也没有把凭证一起带出去。

第 3 条是这一节的重点。很多人做自建入口图省事,会搞 ?key=xxxx 拼在地址后面,再把地址发给自己。地址一旦进了浏览器历史、剪贴板、微信收藏,token 就等于公开了。HomeButler 这个设计反而是对的------难看一点,但不会顺手把钥匙递出去。

7.4 出去之前先过期掉那二十行备份盘

这是第 3.3 节留下的问题。

/api/status 的 disks 数组里,每一个挂载卷都是一条记录。这台机器上 Time Machine 的备份挂载点一个不落地全在里面,UUID、备份日期、卷容量全在。如果这个接口通过公网暴露出去,哪怕有 token,你也等于把"这台机器有几块盘、备份到什么日期"给出了。

三种处理方式,按代价从低到高:

bash 复制代码
# 方式一:只取要看的几条,别把整段 disks 原样转发
curl -s -H "Authorization: Bearer $HOMEBUTLER_TOKEN" http://127.0.0.1:8087/api/status \
  | python3 -c "
import json,sys
d=json.load(sys.stdin)
for x in d['disks']:
    if x['mount'].startswith('/Volumes/.timemachine'): continue
    print(x['mount'], x['used_gb'], '/', x['total_gb'], f\"({x['usage_percent']}%)\")
"

方式二是不给看板开公网,只在本机通过 cpolar 的 TCP 隧道临时看一次,看完就关。方式三最干脆:这台机器如果本来就不该被外网看见,就别开隧道。

我自己的做法是第一种------外面只看经过筛选的那几条,原始报告留在家里。

图 3:cpolar 只从回环取看板页面,接口仍由 token 守着,报告里的备份盘挂载点在出口处被裁掉

8 总结

回到最开始那个问题。这台机器上的容器数,周一看到 6 个,周四看到 6 个,下周一还是 6 个。这三个 6 之间发生过的替换、重启、端口变化,全都不在这三个数字里。HomeButler 干的事情很朴素:每次采集把当前这一份状态连同身份一起落盘,下次采集时拿上一份逐条对比,把"同一个数字底下的不同东西"说出来。

它做完之后你手上多了这几样东西:

  • ~/.homebutler/reports/snapshots/ 里一条按时间排的快照时间线,默认留最近 30 份,--keep 可调
  • 每周一次自动采集,输出落在本地文件里,不进通知渠道也不发往外面
  • 一个默认只听 127.0.0.1 的看板,/api/* 走 Bearer token,首页是个空壳,token 不接受 URL 参数
  • 一个可以从外面打开的入口,前提是你自己的隧道指向 8087 而不是别的端口

后面还能往下走的几个方向:把 report --json 的 notable_changes 按 kind 统计进周报脚本,gone 和 new 配对的那些就是这周被换掉的东西;doctor 的体检项里有一个是"监听在所有接口上的端口",它在你把哪个服务不小心开到 0.0.0.0 时会直接点名;mcp 子命令能把"看状态、发 wake"这些动作交给 agent 调用,--max-risk read 可以限制成只看不改。

至于"再给它套一层别人看不懂的入口"------真正起作用的不是入口名字有多难猜,而是三件很具体的小事:随机地址、页面不带身份信息、凭证不放在地址里。这三件事任何一件做到位都不算完,三件一起做,那个链接就算哪天被同事捡到,也只是捡到一个需要 token 的登录框。

相关推荐
ONEYAC唯样28 分钟前
YXC扬兴科技小型化有源晶振OT4JI-111-24M,提升红外热成像稳定性
人工智能·python·pygame
威哥爱编程43 分钟前
模拟面试智能体开发实战 09:把面试官装进手机,鸿蒙端聊天界面用 SSE 流式输出让回复逐字滚出来
python·agent·harmonyos
威哥爱编程1 小时前
模拟面试智能体开发实战 10:配置写死在代码里还怎么换服务端,把设置和简历做成界面可配、可存
python·agent·harmonyos
青少儿编程课堂1 小时前
第十八届蓝桥杯青少组图形化 + 全国青少年信息素养大赛 + 电子学会图形化考级:校园三消乐大挑战解析
c++·python·算法·bfs·信息学竞赛
万俟淋曦1 小时前
[ROS 系列学习教程] 建模与仿真 - 使用 ros_control 控制六轴串联机械臂
人工智能·ai·机器人·ros·机械臂·robotics·具身智能
青少儿编程课堂1 小时前
蓝桥杯·全国青少年信息素养大赛·电子学会Python/C++考级:网格连通块与岛屿数量(DFS+BFS双解)
c++·python·算法·bfs·信息学竞赛
效率工作实验室2 小时前
企业级AI Agent平台选型指南:主流厂商能力对比与落地场景解析
ai·企业级ai·agent平台选型·agent平台能力对比·企业智能体落地场景
M--Y11 小时前
LangGraph 工作流模式
开发语言·javascript·python·langchain·大模型·llm·langgraph
岁月宁静12 小时前
DeepSeek Harness 实战与架构解析:让 Agent 从“会聊”到“能交付”
人工智能·python·agent