0%

比特币客户端的设置

比特币客户端的设置

关于如何从源码编译出一个比特币程序网上已经有很多文章了,而且写的非常详细,按照上面的步骤一步步的安装依赖库就可以编译出一个完整的客户端。下面列出搜集到比特币客户端的设置,作为资料备查。

我安装的环境是乌班图系统

关于比特币编译过程可以参考这一篇

Bitcoin 比特币官方客户端有两个版本:一个是图形界面的版本,通常被称为bitcoin-qt,以及一个简洁的版本(称为bitcoind)。它们相互间是兼容的,有着同样的命令行参数,读取相同的配置文件,也读写相同的数据文件。你可以在一台电脑中运行Bitcoin 客户端或是bitcoind 客户端的其中一个(如果不小心尝试同时运行另外一个客户端,它会提示你已经有一个客户端在运行并且自动退出)。当然简易的配置直接参考《精通比特币》一书的配置,根据自己安装环境选择两类配置。

命令行参数

使用 -? 或–help 参数运行Bitcoin 或bitcoind,它会提示常用的命令行参数并退出。
用法:

1
2
3
4
bitcoind [选项]
bitcoind [选项] <命令> [参数] 将命令发送到 -server 或 bitcoind
bitcoind [选项] help 列出命令
bitcoind [选项] help <命令> 获取该命令的帮助

选项:

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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
-conf=<文件名> 指定配置文件(默认:bitcoin.conf)
-pid=<文件名> 指定 pid (进程 ID)文件(默认:bitcoind.pid)
-gen 生成比特币
-gen=0 不生成比特币
-min 启动时最小化
-splash 启动时显示启动屏幕(默认:1)
-datadir=<目录名> 指定数据目录
-dbcache=<n> 设置数据库缓存大小,单位为兆字节(MB)(默认:25)
-dblogsize=<n> 设置数据库磁盘日志大小,单位为兆字节(MB)(默认:100)
-timeout=<n> 设置连接超时,单位为毫秒
-proxy=<ip:端口> 通过 Socks4 代理链接
-dns addnode 允许查询 DNS 并连接
-port=<端口> 监听 <端口> 上的连接(默认:8333,测试网络 testnet:18333)
-maxconnections=<n> 最多维护 <n> 个节点连接(默认:125)
-addnode=<ip> 添加一个节点以供连接,并尝试保持与该节点的连接
-connect=<ip> 仅连接到这里指定的节点
-irc 使用 IRC(因特网中继聊天)查找节点(默认:0)
-listen 接受来自外部的连接(默认:1)
-dnsseed 使用 DNS 查找节点(默认:1)
-banscore=<n> 与行为异常节点断开连接的临界值(默认:100)
-bantime=<n> 重新允许行为异常节点连接所间隔的秒数(默认:86400)
-maxreceivebuffer=<n> 最大每连接接收缓存,<n>*1000 字节(默认:10000)
-maxsendbuffer=<n> 最大每连接发送缓存,<n>*1000 字节(默认:10000)
-upnp 使用全局即插即用(UPNP)映射监听端口(默认:0)
-detachdb 分离货币块和地址数据库。会增加客户端关闭时间(默认:0)
-paytxfee=<amt> 您发送的交易每 KB 字节的手续费
-testnet 使用测试网络
-debug 输出额外的调试信息
-logtimestamps 调试信息前添加时间戳
-printtoconsole 发送跟踪/调试信息到控制台而不是 debug.log 文件
-printtodebugger 发送跟踪/调试信息到调试器
-rpcuser=<用户名> JSON-RPC 连接使用的用户名
-rpcpassword=<密码> JSON-RPC 连接使用的密码
-rpcport=<port> JSON-RPC 连接所监听的 <端口>(默认:8332)
-rpcallowip=<ip> 允许来自指定 <ip> 地址的 JSON-RPC 连接
-rpcconnect=<ip> 发送命令到运行在 <ip> 地址的节点(默认:127.0.0.1)
-blocknotify=<命令> 当最好的货币块改变时执行命令(命令中的 %s 会被替换为货币块哈希值)
-upgradewallet 将钱包升级到最新的格式
-keypool=<n> 将密匙池的尺寸设置为 <n>(默认:100)
-rescan 重新扫描货币块链以查找钱包丢失的交易
-checkblocks=<n> 启动时检查多少货币块(默认:2500,0 表示全部)
-checklevel=<n> 货币块验证的级别(0-6,默认:1)

SSL 选项:

1
2
3
4
-rpcssl 使用 OpenSSL(https)JSON-RPC 连接
-rpcsslcertificatechainfile=<文件.cert> 服务器证书文件(默认:server.cert)
-rpcsslprivatekeyfile=<文件.pem> 服务器私匙文件(默认:server.pem)
-rpcsslciphers=<密码> 可接受的密码(默认:TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH)

bitcoin.conf 配置文件

除了 -datadir 和-conf 以外的所有命令行参数都可以通过一个配置文件来设置,而所有配置文件中的选项也都可以在命令行中设置。命令行参数设置的值会覆盖配置文件中的设置。
配置文件是“设置=值”格式的一个列表,每行一个。
您还可以使用# 符号来编写注释。
配置文件不会自动创建;您可以使用您喜爱的纯文本编辑器来创建它。默认情况下,Bitcoin(或bitcoind)会在比特币数据文件夹下查找一个名为“bitcoin.conf”的文件,但是数据文件夹和配置文件的路径都可以分别通过-datadir 和-conf 命令行参数分别指定。

Windows:%APPDATA%\Bitcoin 即C:\Users\username\AppData\Roaming\Bitcoin\bitcoin.conf

Linux $HOME/.bitcoin/ 即/home/username/.bitcoin/bitcoin.conf

注意:如果Bitcoin 比特币客户端测试网模式运行,在数据文件夹下客户端会自动创建名为“testnet”的子文件夹。

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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# bitcoin.conf 配置文件。以 # 开头的行是注释。
# 网络相关的设置:
# 在测试网络中运行,而不是在真正的比特币网络
testnet=0
# 通过一个 Socks4 代理服务器连接
proxy=127.0.0.1:9050

##############################################################
## addnode 与 connect 的区别 ##
## ##
## 假设您使用了 addnode=4.2.2.4 参数,那么 addnode 便会与您的节点连接,并且告知您的节点所有与它相连接的其它节点。
## 另外它还会将您的节点信息告知与其相连接的其它节点,这样它们也可以连接到您的节点。
## ##
## connect 在您的节点“连接”到它的时候并不会做上述工作。仅它会与您连接,而其它节点不会。
## ##
## 因此如果您位于防火墙后,或者因为其它原因无法找到节点,则使用“addnode”添加一些节点。
## 如果您想保证隐私,使用“connect”连接到那些您可以“信任”的节点。 ##
## ##
## 如果您在一个局域网内运行了多个节点,您不需要让它们建立许多连接。
## 您只需要使用“connect”让它们统一连接到一个已端口转发并拥有多个连接的节点。 ##
##############################################################

# 您可以在下面使用多个 addnode= 设置来连接到指定的节点
addnode=69.164.218.197
addnode=10.0.0.2:8333
# 或使用多个 connect= 设置来仅连接到指定的节点
connect=69.164.218.197
connect=10.0.0.1:8333
# 不使用因特网中继聊天(IRC)(irc.lfnet.org #bitcoin 频道)来查找其它节点
noirc=0
# 入站+出站的最大连接数
maxconnections=
# JSON-RPC 选项(用于控制运行中的 Bitcoin/bitcoind 进程):
server=1 告知 Bitcoin-QT 接受 JSON-RPC 命令
server=0
# 您必须设置 rpcuser 和 rpcpassword 以确保 JSON-RPC 的安全
rpcuser=bitcoinrpc
rpcpassword=YourSuperGreatPasswordNumber_DO_NOT_USE_THIS_OR_YOU_WILL_GET_ROBBED_385593
# 客户端在 HTTP 连接建立后,等待多少秒以完成一个 RPC HTTP 请求
rpctimeout=30
# 默认仅允许来自本机的 RPC 连接。在这里您可以指定多个
# rpcallowip=,来设置您想允许连接的其它主机 IP 地址。
# 您可以使用 * 作为通配符。
rpcallowip=10.1.1.10
rpcallowip=192.168.1.*
# 在如下端口监听 RPC 连接
rpcport=8332
# 您可以通过如下设置使用 Bitcoin 或 bitcoind 来发送命令到一个在其它主机远程运行的 Bitcoin/bitcoind 客户端
rpcconnect=127.0.0.1
# 使用安全套接层(也称为 TLS 或 HTTPS)来连接到 Bitcoin -server 或 bitcoind
rpcssl=1
# 当 rpcssl=1 时使用的 OpenSSL 设置
rpcsslciphers=TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH
rpcsslcertificatechainfile=server.cert
rpcsslprivatekeyfile=server.pem
# 其它选项:
# 设置 gen=1 以尝试生成比特币(采矿)
gen=0
# 预生成如下数目的公匙和私匙,这样钱包备份便可以对已有的交易以及未来多笔交易有效
**keypool=100**
# 每次您发送比特币的时候支付一个可选的额外的交易手续费。
# 包含手续费的交易会更快的被包含在新生成的货币块中,因此会更快生效
paytxfee=0.00
# 允许直接连接,实现“通过 IP 地址支付”功能
allowreceivebyip=1
# 用户界面选项:
# 最小化启动比特币客户端
min=1
# 最小化到系统托盘
minimizetotray=1