bitcoin.conf详解

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

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

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: 连接主网还是测试网:

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

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

1
regtest=0  # 0 - 否 1 - 是

proxy:是否使用socks5代理

1
#proxy=127.0.0.1:9050 # 默认关闭

bind:本地监听地址

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

whitebind:本地白名单监听地址

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

addnode:添加种子节点

1
#addnode=69.164.218.197  # 可添加多个

connect:连接节点地址

1
#connect=69.164.218.197

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

1
#listen=1

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

1
#maxconnections=

2.2 RPC配置

server: 是否启动JSON-RPC接口

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

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

1
#rpcbind=<addr>

rpcport:rpc接口的监听端口

1
#rpcport=8332

rpcuser:rpc接口的访问用户名

1
2
#rpcuser=alice
#rpcpassword=DONT_USE_THIS_YOU_WILL_GET_ROBBED_8ak1gI25KFTvjovL3gAM967mies3E=

rpcclienttimeout:rpc客户端超时秒数

1
#rpcclienttimeout=30

rpcallowip:rpc访问白名单

1
#rpcallowip=1.2.3.4/24

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

1
#rpcconnect=127.0.0.1

2.3 钱包配置

txconfirmtarget:交易最小确认数,默认值:6

1
#txconfirmtarget=n

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

1
paytxfee=0.000x

2.4 其他配置

keypool: 密钥池大小

1
#keypool=100

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

1
#prune=550

2.5 用户界面选项

min:是否启动后最小化

1
#min=1

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

1
#minimizetotray=1

3、示例bitcoin.conf文件

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
#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