Bitcoin 比特币官方客户端有两个版本：一个是图形界面的版本，通常被称为 Bitcoin（首字母大写），以及一个简洁命令行的版本（称为 bitcoind）。它们相互间是兼容的，有着同样的命令行参数，读取相同的配置文件，也读写相同的数据文件。您可以在一台电脑中运行 Bitcoin 客户端或是 bitcoind 客户端的其中一个（如果您不小心尝试同时运行另外一个客户端，它会提示您已经有一个客户端在运行并且自动退出）。
命令行参数
使用 -? 或 –help 参数运行 Bitcoin 或 bitcoind，它会提示常用的命令行参数并退出。
用法
1
2
3
4
5
6
7
| 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
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
71
72
73
74
75
76
77
78
79
80
81
82
83
| -conf = <文件名> 指定配置文件（默认：bitcoin.conf）
-pid = <文件名> 指定 pid （进程 ID）文件（默认：bitcoind.pid）
-gen 生成比特币
-gen=0 不生成比特币
-min 启动时最小化
-splash 启动时显示启动屏幕（默认：1）
-datadir=<目录名> 指定数据目录
-dbcache= 设置数据库缓存大小，单位为兆字节（MB）（默认：25）
-dblogsize= 设置数据库磁盘日志大小，单位为兆字节（MB）（默认：100）
-timeout= 设置连接超时，单位为毫秒
-proxy= 通过 Socks4 代理链接
-dns addnode 允许查询 DNS 并连接
-port=<端口> 监听 <端口> 上的连接（默认：8333，测试网络 testnet：18333）
-maxconnections= 最多维护 个节点连接（默认：125）
-addnode= 添加一个节点以供连接，并尝试保持与该节点的连接
-connect= 仅连接到这里指定的节点
-irc 使用 IRC（因特网中继聊天）查找节点（默认：0）
-listen 接受来自外部的连接（默认：1）
-dnsseed 使用 DNS 查找节点（默认：1）
-banscore= 与行为异常节点断开连接的临界值（默认：100）
-bantime= 重新允许行为异常节点连接所间隔的秒数（默认：86400）
-maxreceivebuffer= 最大每连接接收缓存，*1000 字节（默认：10000）
-maxsendbuffer= 最大每连接发送缓存，*1000 字节（默认：10000）
-upnp 使用全局即插即用（UPNP）映射监听端口（默认：0）
-detachdb 分离货币块和地址数据库。会增加客户端关闭时间（默认：0）
-paytxfee= 您发送的交易每 KB 字节的手续费
-testnet 使用测试网络
-debug 输出额外的调试信息
-logtimestamps 调试信息前添加[时间戳](http://8btc.com/article-165-1.html)
-printtoconsole 发送跟踪/调试信息到控制台而不是 debug.log 文件
-printtodebugger 发送跟踪/调试信息到调试器
-rpcuser=<用户名> JSON-RPC 连接使用的用户名
-rpcpassword=<密码> JSON-RPC 连接使用的密码
-rpcport= JSON-RPC 连接所监听的 <端口>（默认：8332）
-rpcallowip= 允许来自指定 地址的 JSON-RPC 连接
-rpcconnect= 发送命令到运行在 地址的节点（默认：127.0.0.1）
-blocknotify=<命令> 当最好的货币块改变时执行命令（命令中的 %s 会被替换为货币块哈希值）
-upgradewallet 将钱包升级到最新的格式
-keypool= 将密匙池的尺寸设置为 （默认：100）
-rescan 重新扫描货币块链以查找钱包丢失的交易
-checkblocks= 启动时检查多少货币块（默认：2500，0 表示全部）
-checklevel= 货币块验证的级别（0-6，默认：1）
|
SSL 选项
1
2
3
4
5
6
7
| -rpcssl 使用 OpenSSL（https）JSON-RPC 连接
-rpcsslcertificatechainfile=<文件.cert> 服务器证书文件（默认：server.cert）
-rpcsslprivatekeyfile=<文件.pem> 服务器私匙文件（默认：server.pem）
-rpcsslciphers=<密码> 可接受的密码（默认： ）
|
bitcoin.conf 配置文件
除了 -datadir 和 -conf 以外的所有命令行参数都可以通过一个配置文件来设置，而所有配置文件中的选项也都可以在命令行中设置。命令行参数设置的值会覆盖配置文件中的设置。
配置文件是“设置=值”格式的一个列表，每行一个。您还可以使用 # 符号来编写注释。
配置文件不会自动创建；您可以使用您喜爱的纯文本编辑器来创建它。默认情况下，Bitcoin（或 bitcoind）会在比特币数据文件夹下查找一个名为“bitcoin.conf”的文件，但是数据文件夹和配置文件的路径都可以分别通过 -datadir 和 -conf 命令行参数分别指定。
默认配置文件路径
Windows
1
2
3
4
5
| %APPDATA%\\Bitcoin\
(XP) C:\\Documents and Settings\\username\\Application Data\\Bitcoin\\bitcoin.conf
(Vista, 7) C:\\Users\\username\\AppData\\Roaming\\Bitcoin\\bitcoin.conf
|
Linux
1
2
3
| $HOME/.bitcoin/
/home/username/.bitcoin/bitcoin.conf
|
Mac OSX
1
2
3
| $HOME/Library/Application Support/Bitcoin/
/Users/username/Library/Application Support/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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
|
