比特币核心版本 v22.0.0

用法：bitcoin-qt [命令行选项]

选项：

-？

打印此帮助信息并退出

-alertnotify=

当收到相关警报或我们看到一个非常长的分叉时执行命令（cmd 中的 %s 被替换为消息）

-assumevalid=

如果此块是链假设它和它的祖先是有效的，并可能跳过他们的脚本验证（0核实所有，默认：00000000000000000008a89e854d57e5667df88f1cdef6fde2fbca1de5b639ad，testnet：0000000000004ae2f3896ca8ecd41c460a35bf6184e145d91558cece1c688a76，印，000000187d4440e5bff91488b700a140441e089a8aaea707414982460edbfe54）

-blockfilterindex=

按块维护紧凑过滤器的索引（默认值：0，值：基本）。如果未提供 或 = 1，则启用所有已知类型的索引。

-blocknotify=

最佳区块发生变化时执行命令（cmd中的%s被区块哈希代替）

-blockreconstructionextraxn=

为紧凑块重建保留在内存中的额外事务（默认值：100）

-blocksdir=

指定目录以保存 *.dat 文件的块子目录（默认值：）

-blocksonly

是否拒绝来自网络对等方的交易。来自入站对等点的任何事务的自动广播和重新广播被禁用，除非对等点具有“forcerelay”权限。 RPC 事务不受影响。 （默认值：0）

-coinstatsindex

维护 gettxoutsetinfo RPC 使用的 coinstats 索引（默认值：0）

-conf=

指定只读配置文件的路径。相对路径将以 datadir 位置为前缀。 （默认：bitcoin.conf）

-datadir=

指定数据目录

-dbcache=

最大数据库缓存大小 MiB（4 到 16384，默认值：450）。此外，此缓存共享未使用的 mempool 内存（请参阅 -maxmempool）。

-debuglogfile=

指定调试日志文件的位置。相对路径将以特定于网络的 datadir 位置为前缀。 （-nodebuglogfile 禁用；默认值：debug.log）

-includeconf=

指定额外的配置文件，相对于 -datadir 路径（只能从配置文件中使用，而不是命令行）

-loadblock=

启动时从外部文件导入块

-maxmempool=

将事务内存池保持在 兆字节以下（默认值：300）

-maxorphantx=

在内存中最多保留 个不可连接的事务（默认值：100）

-mempoolexpiry=

不要在内存池中保留交易超过 小时（默认值：336）

-par=

设置脚本验证线程数（-4 到 15，0 = 自动，

-persistmempool

是否在关闭时保存内存池并在重启时加载（默认值：1）

-pid=

指定 pid 文件。相对路径将以特定于网络的 datadir 位置为前缀。 （默认：bitcoind.pid）

-prune=

通过启用旧块的修剪（删除）来减少存储需求。这允许调用 pruneblockchain RPC 来删除特定块，如果提供了以 MiB 为单位的目标大小，则可以自动修剪旧块。此模式与 -txindex、-coinstatsindex 和 -rescan 不兼容。警告：恢复此设置需要重新下载整个区块链。 （默认值：0 = 禁用修剪块，1 = 允许通过 RPC 手动修剪，> = 550 = 自动修剪块文件以保持在 MiB 中指定的目标大小以下）

-重新索引

从磁盘上的 blk*.dat 文件重建链状态和块索引

-重新索引链状态

从当前索引的块重建链状态。当处于修剪模式或磁盘上的块可能已损坏时，请改用 full -reindex。

-settings=

指定动态设置数据文件的路径。可以使用 -nosettings 禁用。文件是在运行时编写的，并不意味着用户可以编辑（使用 bitcoin.conf 代替自定义设置）。相对路径将以 datadir 位置为前缀。 （默认：settings.json）

-startupnotify=

启动时执行命令。

-txindex

维护完整的事务索引，由 getrawtransaction rpc 调用使用（默认值：0）

-版本

打印版本并退出

连接选项：

-addnode=

添加要连接的节点并尝试保持连接打开（有关更多信息，请参阅 addnode RPC 帮助）。可以多次指定该选项以添加多个节点；连接一次限制为 8 个，并且与 -maxconnections 限制分开计算。

-asmap=

指定用于对等点的分桶的 asn 映射（默认值：ip_asn.map）。相对路径将以网络特定的 datadir 位置为前缀。

-bantime=

手动配置禁令的默认持续时间（以秒为单位）（默认值：86400）

-bind=[:][=洋葱]

绑定到给定地址并始终监听它（默认值：0.0.0.0）。对 IPv6 使用 [host]:port 表示法。附加 =onion 以将任何传入连接到该地址和端口标记为传入 Tor 连接（默认值：127.0.0.1:8334=onion，testnet：127.0.0.1:18334=onion，signet：127.0.0.1:38334=onion，regtest： 127.0.0.1:18445=洋葱）

-connect=

只连接到指定节点； -noconnect 禁用自动连接（此对等点的规则与 -addnode 的规则相同）。可以多次指定此选项以连接到多个节点。

-发现

发现自己的 IP 地址（默认：监听时为 1，没有 -externalip 或 -proxy）

-dns

允许对 -addnode、-seednode 和 -connect 进行 DNS 查找（默认值：1）

-dnsseed

如果地址不足，则通过 DNS 查找查询对等地址（默认值：1，除非使用 -connect）

-externalip=

指定您自己的公共地址

- 固定种子

如果 DNS 种子不提供对等点，则允许固定种子（默认值：1）

-forcednsseed

始终通过 DNS 查找查询对等地址（默认值：0）

-i2pacceptincoming

如果已设置且 -i2psam 也已设置，则传入的 I2P 连接将通过 SAM 代理接受。如果未设置但设置了 -i2psam，则将仅对 I2P 网络进行传出连接。如果未设置 -i2psam，则忽略。监听传入的 I2P 连接是通过 SAM 代理完成的，而不是通过绑定到本地地址和端口（默认值：1）

-i2psam=

I2P SAM 代理到达 I2P 对等点并接受 I2P 连接（默认值：无）

-听

接受来自外部的连接（默认值：如果没有 -proxy 或 -connect，则为 1）

-听

自动创建 Tor 洋葱服务（默认值：1）

-maxconnections=

最多保持与对等点的 连接（默认值：125）。此限制不适用于通过 -addnode 或 addnode RPC 手动添加的连接，它们的单独限制为 8。

-maxreceivebuffer=

每个连接的最大接收缓冲区，*1000 字节（默认值：5000）

-maxsendbuffer=

每个连接的最大发送缓冲区，*1000 字节（默认值：1000）

-maxtimeadjustment

最大允许中值对等时间偏移调整。本地时间视角可能会受到这一数量的前向或后向同行的影响。 （默认：4200 秒）

-maxuploadtarget=

尝试将出站流量保持在给定目标以下（每 24 小时以 MiB 为单位）。限制不适用于具有“下载”权限的对等方。 0 = 无限制（默认值：0）

-natpmp

使用 NAT-PMP 映射监听端口（默认值：0）

-网络活动

启用所有 P2P 网络活动（默认值：1）。可以通过 setnetworkactive RPC 命令更改

-onion=

使用单独的 SOCKS5 代理通过 Tor 洋葱服务访问对等点，设置 -noonion 为禁用（默认值：-proxy）

-onlynet=

仅通过网络 （ipv4、ipv6、onion、i2p）进行传出连接。传入连接不受此选项的影响。可以多次指定此选项以允许多个网络。警告：如果它与非洋葱网络一起使用并且设置了 -onion 或 -proxy 选项，那么仍然会建立出站洋葱连接；在这种情况下，使用 -noonion 或 -onion=0 禁用出站洋葱连接。

-peerblockfilters

根据 BIP 157 向对等方提供紧凑块过滤器（默认值：0）

-peerbloomfilters

支持使用布隆过滤器过滤块和事务（默认值：0）

-permitbaremultisig

中继非 P2SH 多重签名（默认值：1）

-port=

监听 上的连接。不使用默认端口（默认：8333，testnet：18333，signet：38333，regtest：18444）的节点不太可能获得传入连接。与 I2P 无关（参见 doc/i2p.md）。

-proxy=

通过 SOCKS5 代理连接，设置 -noproxy 为禁用（默认：禁用）

-代理随机化

为每个代理连接随机化凭据。这将启用 Tor 流隔离（默认值：1）

-seednode=

连接到节点以检索对等地址，然后断开连接。可以多次指定此选项以连接到多个节点。

-超时=

以毫秒为单位指定套接字连接超时。如果在此时间后首次尝试连接不成功，请将其丢弃（最小值：1，默认值：5000）

-torcontrol=:

启用洋葱监听时使用的 Tor 控制端口（默认值：127.0.0.1:9051）

-torpassword=

Tor控制端口密码（默认：空）

-upnp

使用 UPnP 映射监听端口（默认值：0）

-whitebind=

绑定到给定地址并向连接到它的对等方添加权限标志。对 IPv6 使用 [host]:port 表示法。允许的权限：bloomfilter（允许请求 BIP37 过滤的块和交易），noban（不禁止不当行为；暗示下载），forcerelay（中继已经在内存池中的交易；暗示中继），relay（即使在 -blocksonly 模式下也中继，和无限的交易公告），mempool（允许请求 BIP35 mempool 内容），download（在 IBD 期间允许 getheaders，在 maxuploadtarget 限制后不断开连接），addr（对 GETADDR 的响应避免命中缓存并包含最新的随机记录信息）。指定以逗号分隔的多个权限（默认：download,noban,mempool,relay）。可以多次指定。

-whitelist=

向从给定 IP 地址（例如 1.2.3.4）或 CIDR 标记的网络（例如 1.2.3）连接的对等方添加权限标志

/24)。使用与 -whitebind 相同的权限。可以多次指定。

钱包选项：

-地址类型

使用什么类型的地址（“legacy”、“p2sh-segwit”或“bech32”，默认：“bech32”）

- 避免部分支出

按地址对输出进行分组，选择许多（可能全部）或无，而不是基于每个输出进行选择。隐私得到了改善，因为地址大多以较少的交易进行扫描，并且输出汇总在干净的更改地址中。由于这种附加限制导致的硬币选择不太理想，并且可能使用的输入数量可能超过必要数量，因此可能会导致更高的费用。始终为启用“avoid_reuse”的钱包启用，否则默认：0。

-changetype

使用什么类型的更改（“legacy”、“p2sh-segwit”或“bech32”）。默认值与 -addresstype 相同，但当 -addresstype=p2sh-segwit 发送到本机 segwit 地址时使用本机 segwit 输出时除外）

-禁用钱包

不要加载钱包并禁用钱包 RPC 调用

-discardfee=

费率（以 BTC/kvB 为单位）表示您通过将更改添加到费用中来表示您对丢弃更改的容忍度（默认值：0.0001）。注意：如果按此速率输出是灰尘，则会丢弃输出，但我们将始终丢弃至灰尘中继费，并且超过此值的丢弃费受最长目标的费用估算限制

-fallbackfee=

当费用估算数据不足时将使用的费用率（以 BTC/kvB 为单位）。 0 完全禁用 fallbackfee 功能。 （默认值：0.00）

-keypool=

将密钥池大小设置为 （默认值：1000）。警告：如果未使用原始密钥池中的任何地址，则从旧备份恢复时，较小的大小可能会增加丢失资金的风险。

-maxapsfee=

如果允许使用部分支出避免（默认值：0.00），则在额外（绝对）费用（以 BTC 为单位）中花费最多此金额

-mintxfee=

小于此的费用率（以 BTC/kvB 为单位）被视为创建交易的零费用（默认值：0.00001）

-paytxfee=

添加到您发送的交易的费率（以 BTC/kvB 为单位）（默认值：0.00）

-重新扫描

重新扫描区块链以查找启动时丢失的钱包交易

-signer=

外部签名工具，见 doc/external-signer.md

-spendzeroconfchange

发送交易时花费未确认的零钱（默认值：1）

-txconfirmtarget=

如果未设置 paytxfee，则包含足够的费用，以便交易平均在 n 个块内开始确认（默认值：6）

-wallet=

指定在启动时加载的钱包路径。可多次使用以加载多个钱包。路径是包含钱包数据和日志文件的目录。如果路径不是绝对路径，则相对于 进行解释。这只会加载现有的钱包，不会创建新的钱包。为了向后兼容，它还接受 中现有顶级数据文件的名称。

-钱包广播

使钱包广播交易（默认：1）

-walletdir=

指定存放钱包的目录（默认：/wallets，如果存在，否则）

-walletnotify=

当钱包交易发生变化时执行命令。 cmd 中的 %s 替换为 TxID，%w 替换为钱包名称，%b 替换为包含交易的块的哈希（如果不包含交易，则设置为“未确认”），%h 替换为块高度（如果不包括，则为 -1）。 %w 当前未在 Windows 上实现。在支持 %w 的系统上，不应引用它，因为这会破坏用于调用命令的 shell 转义。

-walletrbf

发送启用全 RBF 选择加入的事务（仅限 RPC，默认值：0）

ZeroMQ 通知选项：

-zmqpubhashblock=

在

中启用发布哈希块

-zmqpubhashblockhwm=

设置发布哈希块出站消息高水位标记（默认值：1000）

-zmqpubhashtx=

在

中启用发布哈希事务

-zmqpubhashtxhwm=

设置发布哈希交易出站消息高水位标记（默认：1000）

-zmqpubrawblock=

在

中启用发布原始块

-zmqpubrawblockhwm=

设置发布原始块出站消息高水位标记（默认值：1000）

-zmqpubrawtx=

在

中启用发布原始交易

-zmqpubrawtxhwm=

设置发布原始交易出站消息高水位标记（默认值：1000）

-zmqpubsequence=

在

中启用发布哈希块和 tx 序列

-zmqpubsequencehwm=

设置发布哈希序列消息高水位标记（默认：1000）

调试/测试选项：

-debug=

输出调试信息（默认：-nodebug，提供 是可选的）。如果未提供 或如果 = 1，则输出所有调试信息。 可以是：net、tor、mempool、http、bench、zmq、walletdb、rpc、estimatefee、addrman、selectcoins、reindex、cmpctblock、rand、prune、proxy、mempoolrej、libevent、coindb、qt、leveldb、validation、 i2p，IPC。可以多次指定此选项以输出多个类别。

-debugexclude=

排除debu

获取类别的信息。可与 -debug=1 结合使用，输出除指定类别外的所有类别的调试日志。可以多次指定此选项以排除多个类别。

-帮助-调试

打印带有调试选项的帮助消息并退出

-日志

在调试输出中包含 IP 地址（默认值：0）

-日志源位置

在调试输出前加上原始源位置的名称（源文件、行号和函数名称）（默认值：0）

-logtimestamps

在调试输出前加上时间戳（默认值：1）

-maxtxfee=

在单个钱包交易中使用的最高总费用（以 BTC 为单位）；将此设置得太低可能会中止大型事务（默认值：0.10）

-printtoconsole

将跟踪/调试信息发送到控制台（默认值：没有 -daemon 时为 1。要禁用日志记录到文件，请设置 -nodebuglogfile）

-shrink调试文件

在客户端启动时收缩 debug.log 文件（默认值：无 -debug 时为 1）

-uacomment=

将注释附加到用户代理字符串

链条选择选项：

-chain=

使用链 （默认值：main）。允许值：main、test、signet、regtest

-印章

使用印章链。等效于 -chain=signet。请注意，网络由 -signetchallenge 参数定义

-签名挑战

块必须满足给定的脚本才能被视为有效（仅适用于签名网络；默认为全局默认签名测试网络挑战）

-signetseednode

以 hostname[:port] 格式为 signet 网络指定种子节点，例如sig.net:1234（可以多次使用以指定多个种子节点；默认为全局默认的signet测试网络种子节点）

-测试网

使用测试链。相当于-chain=test。

节点中继选项：

-bytespersigop

中继和挖矿交易中每个 sigop 的等效字节数（默认值：20）

-数据载体

中继和挖掘数据载体交易（默认：1）

-数据载体大小

我们中继和挖掘的数据载体交易中的最大数据大小（默认值：83）

-minrelaytxfee=

小于此的费用（以 BTC/kvB 为单位）被视为中继、挖掘和交易创建的零费用（默认值：0.00001）

-whitelistforcerelay

将“forcerelay”权限添加到具有默认权限的白名单入站对等方。即使交易已经在内存池中，这也会中继交易。 （默认值：0）

-whitelistrelay

将“中继”权限添加到具有默认权限的白名单入站对等方。即使不中继交易，这也将接受中继交易（默认值：1）

块创建选项：

-blockmaxweight=

设置最大 BIP141 块权重（默认值：3996000）

-blockmintxfee=

为要包含在区块创建中的交易设置最低费率（以 BTC/kvB 为单位）。 （默认值：0.00001）

RPC 服务器选项：

-休息

接受公共 REST 请求（默认值：0）

-rpcallowip=

允许来自指定源的 JSON-RPC 连接。对 有效的是单个 IP（例如 1.2.3.4）、网络/网络掩码（例如 1.2.3.4/255.255.255.0）或网络/CIDR（例如 1.2.3.4/24）。该选项可以指定多次

-rpcauth=

JSON-RPC 连接的用户名和 HMAC-SHA-256 散列密码。 字段采用以下格式：:$。一个规范的 python 脚本包含在 share/rpcauth 中。然后客户端使用 rpcuser=/rpcpassword= 对参数正常连接。该选项可以指定多次

-rpcbind=[:端口]

绑定到给定地址以侦听 JSON-RPC 连接。不要将 RPC 服务器暴露给不受信任的网络，例如公共互联网！除非还传递了 -rpcallowip，否则将忽略此选项。端口是可选的并覆盖 -rpcport。对 IPv6 使用 [host]:port 表示法。可以多次指定此选项（默认值：127.0.0.1 和 ::1，即 localhost）

-rpccookiefile=

身份验证 cookie 的位置。相对路径将以特定于网络的 datadir 位置为前缀。 （默认：数据目录）

-rpcpassword=

JSON-RPC 连接的密码

-rpcport=

监听 上的 JSON-RPC 连接（默认：8332，testnet：18332，signet：38332，regtest：18443）

-rpcserialversion

设置以非详细模式，非隔离见证（0）或隔离见证（1）（默认值：1）返回的原始事务或块十六进制的序列化

-rpcthreads=

设置服务 RPC 调用的线程数（默认值：4）

-rpcuser=

JSON-RPC 连接的用户名

-rpcwhitelist=

设置白名单以过滤特定用户的传入 RPC 调用。 字段采用以下格式：:,,...,。如果为给定用户设置了多个白名单，则它们被设置相交。有关默认白名单行为的信息，请参阅 -rpcwhitelistdefault 文档。

-rpcwhitelistdefault

设置 rpc 白名单的默认行为。除非 rpcwhitelistdefault 设置为 0，否则如果设置了任何 -rpcwhitelist，则 rpc 服务器的行为就像所有 rpc 用户都受制于 empty-unless-otherwise-specified 白名单。如果 rpcwhitelistdefault 设置为 1 并且没有 -rpcwhitel

ist 设置后，rpc 服务器就好像所有 rpc 用户都受制于空白名单。

-服务器

接受命令行和 JSON-RPC 命令

用户界面选项：

-选择数据目录

启动时选择数据目录（默认值：0）

-lang=

设置语言，例如“de_DE”（默认：系统语言环境）

-分钟

开始最小化

-resetguisettings

重置在 GUI 中更改的所有设置

-溅

启动时显示启动画面（默认值：1）