节点在跑着，钱包在亮着，这条路走不通
bitcoin-wallet 是一个独立小工具：它直接打开磁盘上的钱包文件，不需要节点在运行，也不能替代节点。它存在的意义恰恰覆盖节点跑不起来的那批场景——钱包文件躺在旧硬盘里、节点因为其他原因装不上、或者你只想离线确认”这份文件到底是什么”。和所有离线工具一样，它的第一军规是：动手之前先把钱包文件复制一份，所有操作只对副本下手。
它能做五件事，全部在命令行里完成：bitcoin-wallet <文件路径> info 读体检报告，create 新建空钱包，dump 把内容导出为文本清单，salvage 尝试从损坏文件里抢救可解析的记录，createfromdump 从导出文本反向重建。工具没有 GUI，参数是位置式的路径加子命令，行为不写进任何配置文件，用完即走。
info：一份不需要节点的结构体检报告
对一个文件执行 info，会看到八行固定字段：Name（钱包名）、Format（数据库格式，Berkeley DB 还是 SQLite）、Descriptors（是否描述符钱包，yes/no）、Encrypted（是否加密）、HD（是否含 HD 种子）、Keypool Size（预派生密钥数量）、Transactions（钱包记录的交易条数）、Address Book（地址簿条目数）。
这几行能回答很多实际问题。接到一个来历不明的 wallet.dat，先看 Format 和 Descriptors：yes 加 SQLite 说明是 v22 之后 migratewallet 或新参数创建的现代钱包；Berkeley DB 说明是旧格式，新近版本只读不写。HD 为 no 意味着这不是分层确定性钱包，恢复策略完全不同——它更像早期的密钥袋，不能指望从一个种子推回所有地址。Transactions 与 Address Book 两个计数则帮你判断”这个文件有没有内容”，全零的文件要么空要么根本没读对。
info 只读不写，这是它最常被使用的原因：怀疑节点写坏了钱包、或者要从备份盘上确认某次备份是否完整时，跑一次 info 不会改变文件的任何一个字节。但注意它的只读承诺以”节点没在同时打开这个文件”为前提——文件被运行中的节点锁着时，工具会拒绝打开或返回不一致的计数，这不是数据损坏，只是锁。
salvage 的边界，以及 dump 泄密那条红线
salvage 的适用面比看上去窄得多：它只对 Berkeley DB 格式的文件有效。源码层面这功能在没编译 BDB 支持的构建里直接不可用；对 SQLite 钱包文件，salvage 帮不了你——v22 之后 migratewallet 迁移后的钱包损坏，正确的路径是先试节点自带的 -salvage 启动参数路线，或者回到更早的备份。salvage 的产出也是”尽可能解析”：它扫文件里还能读出的密钥与元数据记录，能恢复多少完全取决于损坏程度，恢复出的新钱包里交易历史是残缺的，密钥才是主要目标，找回密钥后再让节点重新扫描链。
dump 值得单独警告：它的输出文本包含私钥明文，工具每次都会在终端打印”The dumpfile may contain private keys. To ensure the safety of your Bitcoin, do not share the dumpfile.”。这句话不是客套——这份文本等于把整条派生树的资金裸放。在排障分享、云端贴日志、论坛求助时携带 dump 文件，是所有比特币工具链里最高频的自杀式操作。真要排查问题，优先分享 info 的八行输出，那里面没有任何敏感信息。createfromdump 作为 dump 的逆操作，同样要求你保证输入文本的来源与完整性，用它重建出来的钱包不会带着原来的交易历史，只有密钥与元数据骨架。
实操顺序建议
典型流程串起来是这样：节点停机，复制 wallet.dat 到工作目录，先 info 判断格式与内容，需要密钥清单时对副本 dump（事后立即安全删除导出文件），文件打不开时 salvage 试副本，一切确认无误后再把处理结果挪回数据目录。全程不需要节点运行，也不需要网络。工具本身不联网、不广播、不签名，它只是钱包文件与磁盘之间的一把螺丝刀。
风险提示：本文是工具用法科普，不构成投资建议。任何直接操作密钥文件的行为都有丢失资产风险，操作前务必备份并在可丢弃的副本上演练。
发表评论
还没有评论，来说两句吧。
评论区为展示样式，提交不会被处理。