被标注弃用的签名入口：geth personal 接口与节点签名时代的落幕

在以太坊节点文档的侧边栏里，personal 这一组接口被正式标注了”deprecated”（已弃用）——但很多新手教程还把它当默认签名入口教。这组接口能解锁账户、直接让节点替你签名，在中心化交易所或矿池时代是标配。本文说明它的历史角色、官方现状、为什么被边缘化，以及它和另一组同样被标注弃用的 miner 接口之间的共同逻辑。

它曾经负责什么

personal 命名空间提供的核心能力：在节点本地创建/导入账户、用节点私钥库给交易签名、解锁/锁定时限。早期节点（包括 geth 一代）默认自带一个明文/加密密钥库，配好 --rpcapi 后，personal_sendTransaction 之类的调用就能完成从解锁到广播的全流程。那是在 MetaMask 等浏览器钱包普及之前、“节点即钱包”的标准姿势。

被标注弃用的签名入口：geth personal 接口与节点签名时代的落幕图 2 — 被标注弃用的签名入口：geth personal 接口与节点签名时代的落幕 · 图 2

现状：文档明示弃用

今天的 go-ethereum 官方文档把 personal 命名空间明确标为 deprecated，同页导航里 miner 命名空间也带同样的标注。弃用的核心理由不是某个 bug，而是角色错位：现代实践中，节点越来越被当作”链的查询与广播服务”，私钥保管与签名交给钱包软件、签名器（signer）或硬件设备，节点侧不再持有热私钥。一个能让节点替你签名的接口，等于在数据服务中心里放了一个保险柜，每一次 RPC 暴露、每一项跨域配置都变成真实资金风险面。

攻击面怎么拼起来

把 RPC 当裸奔端口开的历史事故都有同一块拼图：暴露的接口加上无认证监听。personal 接口在其中放大后果——攻击者不需要偷私钥文件，直接调用签名或发币命令即可。安全部署的常识因此收敛为：RPC 默认只绑回环地址；需要远程访问时上认证、反向代理与防火墙白名单（这些边界在 JSON-RPC 接口文档里另有专门说明）；签名永远在节点外完成。同源的 personal_importRawKey 一类操作在生产节点上尤其应视为禁忌。

与 miner 的对照

miner 命名空间被同批标注弃用的逻辑几乎一致：合并后”发起出块”概念从执行层客户端剥离，接口名存实亡；personal 则是”保管私钥”职责从客户端剥离。两者合起来讲的是同一件事——执行层客户端正在回归”链软件”本位，钱包属性被系统性地请出信任边界。

一次自查操作

怀疑自己的节点暴露了不该有的能力时，按这条顺序走一遍：第一，看进程启动命令行与配置文件里 RPC 相关条目，确认没有历史遗留的解锁式选项；第二，在节点本机查询已注册方法列表（不同客户端接口不同，以当期文档为准），确认 personal 一类签名命名空间不在默认集合；第三，从局域网另一台机器尝试连接 RPC 端口，连不上才说明绑定没放开；第四，如果历史数据目录里存在节点自持账户，把资产迁到外部钱包后归档目录。这四步花不了十分钟，却是把”文档上的弃用”落成”机器上的事实”的全部动作。

常见误区

误区一：“标了弃用说明还能凑合用。“弃用即警告：默认不启用、随时可能移除，教程里拿它演示签名流程是在教攻击面。误区二：“RPC 绑了 127.0.0.1 就不用管认证。“本机被入侵或本地恶意软件面前，边界只剩一层，敏感方法仍应不加载。误区三：“personal 没有 miner 危险。“两者一个动资产一个动共识角色，不该拿来比烂。