## 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](https://github.com/bitcoin/bitcoin/blob/master/share/examples/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
```