跳至内容

更新

peers 会检查自己有没有新版本,由你在终端或会话里决定是否安装。检查是自动的;peers update 默认先请你确认,除非加 --yes;会话里 Claude Code 默认会请你确认 update_broker 调用。

检查新版本

Broker 的正式发布版本启动后会检查 GitHub:先等约一分钟,检查一次,此后默认每 24 小时检查一次。检查在 Broker 进程里进行,一个 Broker 覆盖连到它的所有会话。

有新版本时,两个地方会显示。peers service status 的最后一行如下,其中 <latest> 是最新版本,<installed> 是已安装版本:

Update: <latest> available (current <installed>); run peers update

有可用新版本时,某次工具结果的末尾会附上:

peers <latest> is available (this Broker runs <installed>). To upgrade, the user can ask you to call update_broker or run `peers update` in a terminal.

同一个版本在一个会话中只提示一次;会话开着期间出了新版本,之后的工具调用会再提示一次。MCP 服务在第一次工具调用时向 Broker 查询更新状态,此后最多每 10 分钟查询一次。不是正式发布版本的构建,例如不带 -ldflags 从源码构建的二进制,不检查,也不会出现这两行。

两个配置键控制检查:update.check 打开或关闭检查,update.check_interval 设置间隔,默认 24 小时,最短 1 小时。取值与默认值见配置键。

更新二进制

peers update 只安装更新的正式发布版本。要安装指定版本,包括回退到更旧的版本,可以用安装脚本的 --version;见用一条命令安装。

在终端运行:

peers update

命令先拒绝不是正式发布版本的二进制,然后在改动任何东西之前询问。回答 y 或 yes 才会继续;其他回答会取消更新,二进制与服务都保持原样。确认之后才选 Broker;随后做什么,取决于选中的 Broker 以及它怎样运行。

加 --yes 可以跳过询问。标准输入不是终端时,例如在脚本或计划任务里,命令要求带 --yes,否则拒绝执行,并给出 standard input is not a terminal; pass --yes to proceed without asking。已经是最新版本时,命令打印 peers 0.6.0 is up to date,直接退出,不做任何改动。

命令的完整说明见命令行。

更新用户级安装

本账户的用户级 Broker 在服务管理器下运行时,命令请这个 Broker 自己更新。Broker 下载适用于本平台与架构的发布包,并与 checksums.txt 比对。它运行新二进制核对报出的版本是否符合预期,然后在保留原有权限模式与属主的前提下替换自己的二进制。它按新版本的格式重写用户级服务定义;systemd 的 drop-in 与 macOS plist 里的 EnvironmentVariables 都原样保留。随后 Broker 退出,服务管理器以新版本重新启动它。重写失败或超时时,Broker 把二进制与服务定义恢复为旧版本,不重启,继续以旧版本运行,命令报告原因。命令要等到新 Broker 报出新版本才返回,输出如下:

peers <installed> is installed. Update to the latest release? [y/N] y
The Broker is restarting with version <latest>.
The Broker is running peers <latest>.
Sessions that are already open keep the old MCP server until they are reopened; this Broker's connections recover automatically.

用户级 Broker 不在服务管理器下运行时,Broker 会拒绝请求,命令改为就地替换二进制。正在运行的 Broker 会一直用旧版本,直到你重启它;新二进制在 Broker 下次启动时生效。

更新系统级安装

对系统级安装,命令请系统级 Broker 自己更新,Broker 做同样的工作:先检查自己能否写入配置文件,再下载并校验发布包,替换自己的二进制,由服务管理器以新版本重新启动。替换二进制之后、重启之前,它会按新版本的格式重写系统级服务定义,systemd 的 drop-in 与 macOS plist 里的 EnvironmentVariables 都原样保留。管理组成员不用 sudo 就能运行这条命令,见管理权限。不在组内的账户会被拒绝,因为 Broker 按配置文件的写权限判定,要改用 sudo peers update,或者先加入管理组。本账户同时运行着自己的用户级 Broker 时,命令先选中它,要用 sudo peers update 才能到达系统级 Broker。

在终端里手动启动的系统级 Broker 不能自己更新:命令会报错,并给出把 Broker 装成服务的命令。Broker 是否在服务管理器下运行,按服务管理器报告的主进程 PID 判断。

命令要等到重启后的 Broker 报出新版本。超过等待时间仍未报出时,命令报告超时,并给出系统级服务日志的位置。替换之前的任何一步失败,二进制与服务都不改动。重写服务定义失败或超时时,Broker 会把二进制与服务定义都恢复为旧版本,不重启,继续以旧版本运行,命令报告原因。

系统级更新只重启系统级服务。其他账户如果从同一个二进制运行用户级 Broker,要各自重启自己的 Broker,才会用上新版本。

由 Broker 执行的更新,下载在 Broker 服务进程里进行,代理环境变量取自那个进程;由命令自己替换二进制时,变量取自命令的环境。

系统级 Broker 从服务环境里读取这些变量:

  • Linux:运行 sudo systemctl edit peers.service,加入 [Service] 与 Environment=HTTPS_PROXY=http://proxy.example:8080(需要时加上 HTTP_PROXY 与 NO_PROXY),然后运行 sudo peers service restart --system。drop-in 在重装后仍然保留。
  • macOS:在 /Library/LaunchDaemons/io.github.wangzw.peers.plist 里加入 EnvironmentVariables 字典,写入 HTTPS_PROXY 等变量,然后运行 sudo peers service restart --system,重启会重新读取 plist。重装会重写 plist,之后要重新加入这个字典;更新则会保留这个字典。

用户级服务的做法相同:Linux 上用 systemctl --user edit peers.service 编辑 drop-in,再用 peers service restart 重启服务;macOS 上在 ~/Library/LaunchAgents/io.github.wangzw.peers.plist 里加入字典,再运行 peers service restart,重启会重新读取 plist。重装同样会重写这个 plist,之后要重新加入;更新则会保留。

没有正在运行的 Broker

没有 Broker 在运行时,命令自己替换二进制,替换前同样检查二进制所在目录是否可写。它不启动也不重启任何服务,因为服务可能是有意停掉的。你确认之后,如果查到更新的发布版本,它打印已安装版本、可用版本与发布页面,替换二进制,最后输出:

The new binary takes effect the next time the Broker starts.

按你原来启动的方式启动 Broker,例如在终端重新运行 peers service run,让它运行新的二进制。目录不可写时,命令在任何下载之前停下,并提示运行 sudo peers update。

在会话里更新

会话可以用 update_broker 工具更新 Broker,这个工具不带参数。它请会话已登记的 Broker 升级自己,在 Broker 应答后立即返回,给出升级前后的版本,以及 Broker 是否即将重启。已是最新版本时,它说明这一点,不做任何改动。用户级或系统级的 Broker 不在服务管理器下运行时,不能自己更新,工具会提示改用终端命令。

工具最多等 4 分钟。到时 Broker 没有完成,它返回的说明给出两种可能结果:升级被放弃、运行中的版本不变(已经开始替换的会回滚),或者升级已完成、Broker 正带着新版本重启;说明还提示用 peers --version、peers service status,或在终端运行 peers update 来核实。

这个工具需要对 Broker 配置文件的写权限,这一权限可以与读权限分开授予。它不需要终端:Claude Code 默认会在调用前请你确认,这次确认是 Broker 的二进制被替换之前最后一道人工检查。不要把 update_broker 加入自动批准,以免跳过这道确认。

Broker 重启后,连接会自动恢复。发起调用的会话里,MCP 服务要重开会话才会用上新版本。工具与返回字段见 MCP 工具。

重连已打开的会话

由 Broker 执行的更新会重启 Broker,连接自动恢复。已经打开的会话仍在运行旧的 MCP 服务,每个会话都要用 /mcp 重连或重开,才会用上新版本。没有 Broker 运行、由命令替换二进制时,没有连接需要恢复;Broker 下次启动、会话连上它之后就会用上新版本。

更新也可能改变链路协议版本。已配对的 Broker 只有使用同一个版本才能建立链路,所以遇到这种更新时,与本机配对的主机也要更新到同一版本,链路才会恢复;配对关系保留,对方更新后拨号方会自动重新建立链路。

按安装方式选择命令

安装方式命令处理方式
用户级:未安装系统级服务,由以下任一方式安装:对 Install for every account on this host? [y/N] 回答 n 或直接回车、以非 root 账户在没有终端时运行、带 --user,或手工把二进制放进 ~/.local/binpeers update装有服务时,Broker 替换自己的二进制,服务管理器重启它;没有服务时,命令替换二进制,下次启动时生效。
系统级:带 --system 或对级别询问回答 y 的安装命令,或以 root 运行,或手工 sudo install 到 /usr/local/bin管理组成员且本账户没有运行用户级 Broker 时用 peers update;其余情形用 sudo peers update;不在组内的,也可以先加入管理组Broker 替换自己的二进制,服务管理器重启它。
没有正在运行的 Brokerpeers update命令替换二进制,不启动也不重启任何服务。

用 -ldflags 以发布版本号从源码构建的二进制,按它所属安装方式对应的一行处理。不带 -ldflags 从源码构建的二进制报出的版本是 dev;它不是正式发布版本,命令会拒绝执行,并给出 version "dev" is not a release build; only release builds can update themselves。要就地更新,请安装正式发布版本。

二进制是符号链接时,命令会解析链接,替换它指向的文件。

关闭更新检查

要让 Broker 不再检查:

peers config set update.check false

提示会立刻消失:peers service status 不再打印 Update 一行,会话也不再出现更新提示。无法访问 GitHub 的主机可以一直关着检查;只有你自己运行 peers update 时,命令才会访问 GitHub。

安全模型说明检查发出的网络访问。