同一台机器跑第二个比特币节点：port 参数与端口族怎么错开

在一台机器上同时跑两个比特币节点——比如一个主网一个 signet，或者一个对外服务一个内部测试——失败的第一现场永远是端口冲突。端口族比表面上复杂：每个网络不止一个端口，改一个还不够。本文按 Bitcoin Core v31.0 源码把端口族的构成和隔离清单一次讲清。

一、基准值：五个网络五套端口

源码的链参数定义里，主网、testnet3、testnet4、signet、regtest 各有自己的基准端口：主网 P2P 是 8333，测试网络依次取不同数值；RPC 侧对应 8332、各测试网络分别是 18332、48332、38332 等。源码注释里有一句诚实的话：Tor 入站连接用的端口族（8334 一族）是为了让端口范围紧凑而”任意挑选”的。换句话说，端口号不是协议的一部分，只是事实标准——网络识别靠的是消息头里的魔法字节，不是端口。

二、-port 只管监听端口这一件事

-port=<n> 改变的是 P2P 入站监听端口，以及由它派生的一族：Tor 入站监听默认取监听端口加一。它改变不了 RPC 端口——RPC 归 -rpcport 管；也改变不了网络基准本身。所以双实例隔离必须逐个点名：给第二个实例配 -port 错开 P2P、配 -rpcport 错开 RPC、配独立的 -datadir，三者缺一不可。日志锁文件与 RPC cookie 文件都落在 datadir 里，datadir 分开后这些自动随目录隔离。反过来，只改端口不改 datadir 会撞链上数据，只改 datadir 不改端口会撞监听——冲突报错的形态因此各不相同，认得形态就能倒推缺了哪一项。

三、派生端口的连锁位置

两处派生值得单独记：其一，-bind 的文档说明默认主网在监听端口加一处监听 Tor 入站（形如本机地址加端口族），其二，测试网络的默认值随网络切换整体平移。这意味着显式改 -port 后，Tor 派生端口跟着走；而用 -bind 手工指定监听地址时，派生逻辑被你的显式配置替代。双实例若都启用 Tor 监听，派生端口也要手工错开，否则一个看似只改了主端口的配置仍能在 Tor 监听上撞车。

四、端口之外：网络隔离的完整清单

端口冲突只是双实例问题的一层，另一层是网络身份。两个实例连同一张网络会互相发现（地址公告会把对方找过来），同一 datadir 更不可能并跑。稳妥的组合是：不同 -datadir、错开 P2P 与 RPC 端口、最好再分网络（主网与 signet 各一）；若必须同网络双实例，需要接受地址交换层面的交叉，或给其中一端配连接白名单收紧。改端口还有一个不显眼的安全面：公网暴露非标准端口会让扫描器找不到你——这对想低调的入站监听是优点，但依赖默认端口的可达性探测与第三方服务会因此报不可达，部署前先对齐预期。

五、动手前的端口清点

一个可复用的操作顺序：先用系统工具清点当前监听（本机监听列表加常见端口过滤），确认哪些端口已被第一个实例占住；给第二个实例选一组错开的值时，顺手检查候选值是否落在系统临时端口区间——撞上动态分配端口会引发比普通冲突更难查的间歇故障。配好后启动，第一次运行先看日志里监听绑定与 RPC 绑定两行是否落在预期端口，再看 RPC 连通性与对等连接数是否正常，两分钟就能闭环验收。如果第二个实例是给测试工具或索引服务用的，还有一个隐性检查点：不少第三方客户端默认值写死了主网端口，改端口后这些工具需要同步改连法，否则它们的报错会伪装成节点故障。端口规划的最终形态是一张贴在机器上的表：哪个网络、哪份数据目录、哪组端口，三个维度互不重叠，半年后回来加第三个实例的人（通常还是你自己）会感谢这张表。

本文所有事实按 Bitcoin Core v31.0 源码核对，端口分配可能随版本调整，不构成任何投资建议。