lncli peers updatenodeannouncement：不停机改别名、颜色与地址并重发节点公告

一、改个别名为什么要重启

闪电节点的公告消息（node announcement）里装着名片信息：网络地址集合、别名、颜色、支持的特性位。过去更新这张名片，要么改 lnd.conf 里的对应项再重启节点，要么等下次自然节拍重播旧内容。LND 把这件事归进 peers 服务：接口 UpdateNodeAnnouncement，命令行 lncli peers updatenodeannouncement，命令说明原文概括得很清楚——增删可连地址、改别名与颜色、启停特性位，都不需要重启节点，改完生成新版本公告并广播给对端。

二、第一个门槛：默认二进制里没有它

这份命令源码文件带着构建标签，默认发行构建不包含 peers 服务，要用它得从源码以 peersrpc 构建标签编译。很多照着教程敲命令报未知命令的读者卡的就是这一步，而不是参数写错。验证方法很直接：跑 lncli help peers，有输出才有这条路；没有，说明手上的发行版没带这个服务，先解决构建再谈参数。

三、六个参数拆成三组

按命令源码里的标志定义，六个参数分三组。地址组：address_add 与 address_remove，都是可重复的列表型——新增一个可连地址（典型场景：换端口、加一条 Tor 或清网地址）与退役旧地址，一次命令内可同时带多个动作。显示组：alias 换成新别名、color 换十六进制颜色，就是各路浏览器里看到的名字与色块。能力声明组：feature_bit_add 与 feature_bit_remove 按特性位序号增删声明——这是六项里唯一会影响对端行为的，启停某个位等于改写你对外声明支持 BOLT9 特性清单，改之前要确认底层配置真的支持该项，让声明与实际能力脱节比不改更糟。三组都是增量语义：地址按动作做加减，别名颜色是整值替换，没有带过去的旧值会被静默改动。

四、生效链路与传播节奏

接口定义里响应体回一组操作记录，逐条说明每个字段被怎么处理。真正要注意的是传播：命令成功只代表本节点生成了更高时间戳的新公告并推给直接对端，全网图谱要等每个中继按自己的限流节拍继续转发——浏览器上的别名不会瞬间变。如果广播后一段时间外部还看不到新版本，先分清问题在生成还是传播：本地直接问对端或翻 gossip 相关日志，能定位在自家还是路上。另外地址集合的生效边界别混淆：公告里的地址列表只是声明，节点实际监听与拨号由配置文件里的监听、onlynet 等参数决定，公告改得掉声明、改不掉监听。

五、实操示例

一条完整命令的典型形状：lncli peers updatenodeannouncement --alias=NewName --color=#3399ff --address_add=tcp://x...onion:9735 --address_remove=tcp://old.onion:9735，把要改的字段挂齐一次执行。别名限制用系统内已生效的规则即可（长度与字符集以你的 lnd 配置层校验为准），命令不会替你绕过配置校验。建议的验证顺序：执行命令、检查响应里的操作列表逐项符合预期、隔一段时间再用外部图谱工具核对新版本出现。改特性位这种影响协商的项，执行前后各抓一次 nodeinfo 对比声明变化，是最省事的确认方式。

六、边界与替代路径

这个命令管的是公告字段热更新，不碰通道层：通道参数与别名颜色无关，频道公告是另一族 channel_update 消息；地址声明改了之后，防火墙、端口映射或隐藏服务配置没跟上，图谱里会留着一个连不上的地址而不是报错——公告只负责说，不负责验证。不想带 peersrpc 构建标签的部署，常规路径仍然是改配置重启：公告自然换新。热更新的价值主要在必须保持连接稳定的托管场景，家用节点重启三十秒能解决的事没必要折腾构建标签。

风险提示：本文仅作机制说明，不构成任何投资建议。