bitcoin.conf详解

bitcoin.conf是比特币核心程序bitcoind的配置文件，本文将介绍bitcoin.conf的默认路径，并给出主要配置项的说明。

如果要快速掌握比特币的对接与应用开发，推荐汇智网的在线互动课程：

• Java比特币开发详解
• Php比特币开发详解
• C#比特币开发详解

1、bitcoin.conf的默认路径

• 在linux下，bitcoin.conf的默认路径为$HOME/.bitcoin/bitcoin.conf
• 在windows下，bitcoin.conf的默认路径为%APPDATA%\bitcoin\bitcoin.conf
• 在mac下，bitcoin.conf的默认路径为$HOME/Library/Application Support/Bitcoin/bitcoin.conf

默认情况下bitcoind并不会自动创建上述路径下的bitcoin.conf配置文件，因此需要自行制作一份放入上述目录。如果你没有现成的配置文件可用，可以从github拷贝一份：
bitcoin.conf。

2、bitcoin.conf配置说明

在bitcoin.conf配置文件中，每行以key=value的形式声明配置项与值，#之后的内容为注释。

2.1 总体配置

testnet: 连接主网还是测试网：

testnet=0   # 0 - 主网 1 - 测试网

regtest：是否以私有链模式运行

regtest=0  # 0 - 否 1 - 是

proxy：是否使用socks5代理

#proxy=127.0.0.1:9050 # 默认关闭

bind：本地监听地址

#bind=<addr>   # 注释此行，表示使用默认监听地址

whitebind：本地白名单监听地址

#whitebind=<addr>  # 注释此行，表示使用默认监听地址

addnode：添加种子节点

#addnode=69.164.218.197  # 可添加多个

connect：连接节点地址

#connect=69.164.218.197  

listen：是否进入监听模式，默认启用，除非使用了connect配置

#listen=1

maxconnections：入站/出站最大连接数

#maxconnections=

2.2 RPC配置

server： 是否启动JSON-RPC接口

#server=0    # 0 - 不启动 1 - 启动

rpcbind：rpc接口的监听地址，默认绑定到所有IP

#rpcbind=<addr>

rpcport：rpc接口的监听端口

#rpcport=8332

rpcuser：rpc接口的访问用户名

#rpcuser=alice
#rpcpassword=DONT_USE_THIS_YOU_WILL_GET_ROBBED_8ak1gI25KFTvjovL3gAM967mies3E=

rpcclienttimeout：rpc客户端超时秒数

#rpcclienttimeout=30

rpcallowip：rpc访问白名单

#rpcallowip=1.2.3.4/24

rpcconnect：bitcoin-cli的默认连接地址

#rpcconnect=127.0.0.1

2.3 钱包配置

txconfirmtarget：交易最小确认数，默认值：6

#txconfirmtarget=n

paytxfee：每次发送比特币时的交易费

paytxfee=0.000x

2.4 其他配置

keypool： 密钥池大小

#keypool=100

prune：剪枝留存数量，超过此数量的历史区块将从内存中删除

#prune=550

2.5 用户界面选项

min：是否启动后最小化

#min=1

minimizetotray：是否最小化到系统托盘

#minimizetotray=1

3、示例bitcoin.conf文件

注意下面的配置文件中，选项均已注释，需要根据自己的情况取消注释并设置相应的值：

#testnet=0
#regtest=0
#proxy=127.0.0.1:9050
#bind=<addr>
#whitebind=<addr>
#addnode=69.164.218.197
#addnode=10.0.0.2:8333
#connect=69.164.218.197
#listen=1
#maxconnections=
#server=0
#rpcbind=<addr>
#rpcuser=alice
#rpcpassword=DONT_USE_THIS_YOU_WILL_GET_ROBBED_8ak1gI25KFTvjovL3gAM967mies3E=
#rpcclienttimeout=30
#rpcallowip=10.1.1.34/255.255.255.0
#rpcallowip=1.2.3.4/24
#rpcallowip=2001:db8:85a3:0:0:8a2e:370:7334/96
#rpcport=8332
#rpcconnect=127.0.0.1
#txconfirmtarget=n
#paytxfee=0.000x
#keypool=100
#prune=550
#min=1
#minimizetotray=1