Skip to content

Latest commit

 

History

History
41 lines (37 loc) · 6.29 KB

ConfigFileDetails-zhCN.md

File metadata and controls

41 lines (37 loc) · 6.29 KB

BTCAgent 配置文件详解

所有选项

{
    "agent_type": "btc",
    "always_keep_downconn": false,
    "disconnect_when_lost_asicboost": true,
    "use_ip_as_worker_name": false,
    "ip_worker_name_format": "{1}x{2}x{3}x{4}",
    "submit_response_from_server": false,
    "agent_listen_ip": "0.0.0.0",
    "agent_listen_port": 3333,
    "pool_use_tls": false,
    "use_iocp": false,
    "fixed_worker_name": "",
    "pools": [
        ["us.ss.btc.com", 1800, "YourSubAccountName"],
        ["us.ss.btc.com", 443, "YourSubAccountName"],
        ["us.ss.btc.com", 3333, "YourSubAccountName"]
    ]
}

选项列表

配置项 名称 使用说明
agent_type 代理类型 保留用于未来支持其他币种,目前只能为"btc"。如果你手动编写配置文件,建议直接省略该选项。
always_keep_downconn 矿池断开时向矿机发送虚假任务 正常情况下,如果智能代理与矿池服务器断开连接,它会停止向矿机发送任务,然后矿机收不到任务,就会切换到备用池。

但是如果您遇到外网故障,矿机也就连不上备用池,一段时间后矿机就会停止挖矿。在某些环境中,矿机突然停止挖矿可能会导致矿机损坏,或者在网络恢复正常后矿机无法自行恢复挖矿(比如因为温度太低而无法启动)。此时您就可以启用该选项。

启用该选项后,如果智能代理与矿池服务器断开连接,它不会停止向矿机发送任务,而是会产生一些虚假任务发送给矿机,这样矿机就能持续挖矿。等网络恢复后,智能代理就可以向矿机发送真实任务了。

但是请注意:虚假任务产生的算力不会提交到矿池(就算提交也只是徒增拒绝率),所以也无法产生收益。并且,如果智能代理是矿机的首选矿池,那么启用该选项也会让矿机失去切换到备用池的机会,因为在它看来,首选矿池始终是活跃的。
disconnect_when_lost_asicboost 自动重连ASICBoost失效的矿机 某些支持ASICBoost的矿机,在挖矿过程中ASICBoost可能会突然失效,这会导致矿机算力降低,或者功耗上升。

启用该选项可以让智能代理自动断开这些矿机的连接,矿机会立即自动重连,并且重连后ASICBoost通常可以恢复正常。

建议始终启用该选项,因为它没有什么副作用。就算矿机不支持ASICBoost,启用该选项也不会导致任何问题。
use_ip_as_worker_name 使用矿机IP作为矿机名 启用该选项可以让智能代理把矿机的IP地址作为矿机名,填写在矿机控制面板中的矿机名会被忽略。

例如,IP地址为“192.168.1.23”的矿机,矿机名就会变成“192x168x1x23”。矿机名的具体格式可以通过ip_worker_name_format选项设置。
ip_worker_name_format IP地址矿机名的格式 设置IP地址矿机名的格式。

可用变量:
{1} 表示IP地址的第一段。
{2} 表示IP地址的第二段。
{3} 表示IP地址的第三段。
{4} 表示IP地址的第四段。

举例:
{1}x{2}x{3}x{4}
IP地址“192.168.1.23”的矿机名为“192x168x1x23”。

{2}x{3}x{4}
IP地址“192.168.1.23”的矿机名为“168x1x23”。

{3}x{4}
IP地址“192.168.1.23”的矿机名为“1x23”。
submit_response_from_server [高级选项]
向矿机发送矿池响应
向矿机发送矿池服务器的真实响应。

如果该选项未启用,智能代理在收到矿机提交后会立即发送“成功”响应,这样一来,矿机控制面板的“拒绝率”就会始终为0。

如果想在矿机控制面板看到真实拒绝率,可以启用该选项。但是启用该选项可能会增加网络带宽开销以及提交延迟。
agent_listen_ip BTCAgent监听IP BTCAgent代理的监听IP,矿机需要通过这个IP来连接到代理。需要填写已经分配给运行代理的电脑的IP,或者填写0.0.0.0。建议填写0.0.0.0,它表示“所有可用的IP”。
agent_listen_port BTCAgent监听端口 BTCAgent代理的监听端口,矿机需要通过这个端口来连接到代理。如果你在同一台电脑上运行多个代理,每个代理的端口都应该不同。

可用的端口范围是1到65535,但是建议使用2000到5000范围内的端口。因为使用低于1024的端口需要root权限(管理员权限),高于5000的端口容易被其他程序随机占用。
pool_use_tls 连接矿池时启用SSL/TLS加密 连接到SSL/TLS加密的矿池服务器,防止中间人进行网络窃听。

注意:支持SSL/TLS加密的矿池服务器的地址和端口与普通服务器不同,如果您填写的矿池地址端口不支持SSL/TLS加密,启用该选项会导致智能代理连不上矿池。

此外,启用该选项只会加密到矿池的连接,不会加密到矿机的连接,所以不需要修改矿机的设置。
use_iocp [仅限Windows]
[实验性功能]
联网时启用IOCP
让智能代理在联网时使用Windows I/O完成端口(IOCP)。

启用该选项可能可以提升智能代理的吞吐量,可以让更多矿机同时连接到同一个智能代理。

但是该选项是高度实验性的。我们的测试表明,启用该选项后智能代理的内存占用会显著增加,并且某些情况下可能会崩溃或者失去响应。

我们不建议普通用户启用该选项,除非您真的遇到吞吐量问题,并且没有其他解决方法。

如果启用了该选项,请务必给矿机配置备用矿池,以便在智能代理故障时自动切换。
fixed_worker_name [高级选项]
使用固定矿机名
把所有矿机的矿机名都设为同一个值,这会模拟传统Stratum代理的行为,让矿池认为连接到BTCAgent的所有矿机都是同一台矿机。

留空(值设为"")或者省略该选项可以禁用这个功能。
pools 矿池地址、端口、子账户名 [
    ["矿池地址1", 矿池端口1, "子账户名1"],
    ["矿池地址2", 矿池端口2, "子账户名2"],
    ["矿池地址3", 矿池端口3, "子账户名3"]
]