.. raw:: html
.. _configuration:
####################
配置(Configuration)
####################
.. contents::
:local:
:depth: 2
****************************************
使用BOS工具箱配置Braiins OS
****************************************
使用**BOS工具箱**,您可以轻松地在多个矿机上配置Braiins OS。具体请详见 :ref:`bosbox_configure` 部分的步骤。
************************************************
使用远程(SSH)包配置Braiins OS
************************************************
安装脚本使用两种参数:
* 位置参数(Positional Arguments)——完成安装所必需的参数。
* 可选参数(Optional Arguments)——安装过程中可选(即非必须)的参数。
安装脚本的句法如下:
::
usage: upgrade2bos.py [-h] [--no-backup] [--no-nand-backup]
[--no-keep-network] [--keep-hostname] [--no-wait]
hostname
**位置参数:**
.. code-block:: none
hostname [hostname ...] 选中矿机的矿机用户名或IP地址
**可选参数:**
.. code-block:: none
-h, --help 显示帮助信息并退出
--no-backup 在矿机固件升级后跳过备份
--no-nand-backup 跳过对矿机内置储存(NAND)的完整备份(但仍备份矿机配置)
--no-keep-network 不保留矿机的网络参数(使用DHCP)
--keep-hostname 保留矿机用户名
--no-wait 直到系统完成完整升级过程,不等待
***********************
矿池设置(Pool Settings)
***********************
用户可以同时设置多个矿池。在同组(Group)下的矿池,使用“多矿池故障转移策略”(Fail-over multipool strategy),这意味着在一个矿池不可用的情况下, BOSminer将自动切换到第二个矿池。
在矿机网页界面(*Miner(矿机) -> Configuration(配置)*)中,或在 ``/etc/bosminer.toml`` 配置文件中可以进行设置。
句法如下:
::
[[group]]
name = 'Default'
quota = 1
[[group.pool]]
enabled = true
url = 'stratum2+tcp://v2.stratum.slushpool.com/u95GEReVMjK6k5YqiSFNqqTnKU4ypU2Wm8awa6tmbmDmk1bWt'
user = 'username.workername'
password = 'secret'
* *name* - 矿池组名(在下一部分关于矿池组的介绍中会具体说明)
* *quota* - 用户设定矿机组内矿池的算力比例配额(在下一部分关于矿池组的介绍中会说明)
* *enabled* - BOSminer初始化后的矿池初始状态 (默认值=true (矿池组启用))
* *url* - 矿池服务器URL地址是必要参数,它以
``scheme://HOSTNAME:PORT/POOL_PUBLIC_KEY`` 为格式。
使用Slush Pool矿池时,您无需为阶层Stratum V2协议指定特定的端口。
因为目前该协议还在开发过程中,我们的矿池会在两个默认端口 (**3336** 和 **3337**)间切换。
未升级的矿工仍可继续使用旧版阶层Stratum协议。已进行升级的矿工也无需担心因为新端口的原因,需要更新矿池服务器URL地址。
在矿池服务器URL地址中,现在需要填写一个新元素——矿池的公钥,挖矿软件需要使用矿池的公钥来验证连接到的挖矿终点。
如果对矿工算力进行中间人攻击则会验证失败,软件会拒绝所给的矿池地址,从而预防中间人攻击窃取矿工的算力
* *user* - 用户名是必要参数,它以 ``USERNAME.WORKERNAME`` (用户名.矿工名)的格式指定
* *password* - 密码的设置是非必须的
矿池组(Pool Groups)
===================
用户可以创建多个不同的矿池组。位于同组内的矿池都使用上文所述的“多矿池故障转移策略”(Fail-over multipool strategy)。
在创建了多个多池组的情况下,算力会基于比例配额(Quota basis),或基于固定百分比(Fixed Share Ratio)按照负载平衡的策略进行分配。
案例说明:
1号矿池组的比例配额(Quota)为"1",其中有2个矿池地址。2号矿池组的比例配额为"2",其中只有1个矿池地址。
- 两个矿池组的算力分配为1:2。
- 分配到2号矿池组的算力始终会是分配到1号的两倍。
- 如果1号矿池组中的第一个矿池地址不可用,BOSminer将会自动切换到1号矿池组中的第二个矿池地址。
基于固定百分比(Fixed Share Ratio)和基于比例配额(Quota basis)的算力分配模式不可以同时使用,只能二选一!
在矿池组比例配额为1:1的情况下,就相当于设置了0.5(50%)的固定百分比。 即对半分配发送到两个矿池组的算力。
在矿机网页界面(*Miner(矿机) -> Configuration(配置)*)中,或在配置文件 ``/etc/bosminer.toml`` 中可以进行设置。
两个矿池组和多个矿池地址的设置案例:
::
[[group]]
name = 'MyGroup1'
quota = 1
[[group.pool]]
enabled = true
url = 'stratum2+tcp://v2.stratum.slushpool.com/u95GEReVMjK6k5YqiSFNqqTnKU4ypU2Wm8awa6tmbmDmk1bWt'
user = 'userA.worker'
[[group.pool]]
enabled = true
url = 'stratum+tcp://stratum.slushpool.com:3333'
user = 'userA.worker'
[[group]]
name = 'MyGroup2'
quota = 2
[[group.pool]]
url = 'stratum+tcp://stratum.slushpool.com:3333'
user = 'userB.worker'
在上面的设置案例中,算力以1:2的比例分到了两个矿池组。
默认情况下,矿机会选择在1号组"MyGroup1"内的第一个矿池地址,和在2号组"MyGroup2"内设置的矿池地址挖矿。
如果1号组"MyGroup1"内的第一个矿池地址不可用,矿机会自动切换到组内的第二个矿池地址挖矿。
如果2号组"MyGroup2"内设置的矿池地址不可用,矿机则什么也不会做。
*******************************
运算板设置(Hash Chain Settings)
*******************************
运算板设置能超控所有运算板的默认设置,由矿工自行选择。
它让矿工能直接设置每个运算板的频率和电压,以及开关AsicBoost功能。
对单个运算板的设置能够超控所有运算板的全局设置。
**当矿机的自动调整功能(Autotuning)开启时,上述设置一律无效!**
在矿机网页界面(*Miner(矿机) -> Configuration(配置)*)中,或在配置文件 ``/etc/bosminer.toml`` 中可以进行设置。
句法示例如下:
::
[hash_chain_global]
asic_boost = true
frequency = 650.0
voltage = 8.8
* *asic_boost* - 设置启用或禁用AsicBoost支持(默认值=true)
* *frequency* - 为所有运算板设定以兆赫兹Mhz为单位的默认芯片频率 (默认值=650.0)
* *voltage* - 为所有运算板设定以伏V为单位的默认电压(默认值=8.8)
设置超控单个运算板的句法示例如下:
::
[hash_chain.6]
frequency = 650.0
voltage = 8.8
* *[hash_chain.6]* - 超控'6'号运算板的全局设置
* *frequency* - 超控'6'号运算板以兆赫兹Mhz为单位的全局芯片频率设置(默认值='hash_chain_global.frequency')
* **(只有蚂蚁矿机S9)** *voltage* - 超控'6'号运算板以伏V为单位的全局芯片电压设置(默认值='hash_chain_global.voltage')
******************************************
温度和风扇控制(Temperature and Fan Control)
******************************************
温度控制模式(Temperature Control Mode)
======================================
Braiins OS+支持自动风扇控制 (使用 `PID控制器 `__)。
控制器能在三种模式下运行:
- **自动(Automatic)** - 矿机软件自动调整风扇转速,使矿机的温度大概保持在一个目标温度。
目标温度可调,它的允许设置范围在0-200摄氏度之间。
- **手动(Manual)** - 无论温度如何,风扇转速始终保持固定在用户自定义的转速。
如果您有自己的降温方法,或在温度传感器不起作用的情况下,这一模式是很有用的。
允许设置的风扇转速范围为0%-100%。控制器仅监控过热和危险温度。
- **禁用(Disabled)** - **警告**: 没有温度控制,设备可能会损坏!
温度控制模式可以在矿机网页界面(*Miner(矿机) -> Configuration(配置)*)中,或在 ``/etc/bosminer.toml`` 配置文件中可以进行设置。
**警告**: 不正确地配置风扇(无论是关闭风扇还是使用过低的转速,或设置太高的目标温度)可能导致您的矿机不可逆转地 **损坏** 。
默认温度限制(Default temperature limits)
========================================
设置默认温度限制是为了防止矿机的过热及损坏。
* **目标温度(Target temperature)** 指矿机会尝试保持的温度(*默认值* 为 **89°C**)。
* **过热温度(Hot temperature)** 指风扇会开始以100%转速运行的阈值温度(*默认值* 为 **100°C**)。
* **危险温度(Dangerous temperature)** 指为防止矿机的过热及损坏,BOSminer会自动关闭的阈值温度(*默认值* 为 **110°C**)。
默认温度限制的温度值可以在 *Miner(矿机) -> Configuration(配置)* 页面中,或在 ``/etc/bosminer.toml`` 配置文件中调整。
在 ``bosminer.toml`` 配置文件中的温度和风扇控制(Temperature and Fan Control configuration in bosminer.toml)
=========================================================================================================
在配置文件 ``/etc/bosminer.toml`` 中,编辑相应行可以修改默认值。
句法如下:
::
[temp_control]
mode = 'auto'
target_temp = 89
hot_temp = 100
dangerous_temp = 110
* *mode* - 温度控制模式设定 (默认值='auto'(自动))
* *target_temp* - 设定以摄氏度为单位的目标温度(默认值=89.0)。 该选项仅在 'temp_control.mode' (温度控制模式)设定为 'auto' (自动)的情况下可用!
* *hot_temp* - 设定以摄氏度为单位的过热温度(默认值=100.0)。 当矿机达到该温度时,风扇转速会自动调整为100%。
* *dangerous_temp* - 设定以摄氏度为单位的危险温度(默认值=110.0)。 当矿机达到该温度时,矿机将会自动关闭!**警告:** 将危险温度值设置太高会损坏矿机!
::
[fan_control]
speed = 100
min_fans = 1
* *speed* - 设定以 %为单位(默认值=70)的风扇固定转速。 当 *temp_control.mode* 风扇控制模式)设定为 'auto'(自动)时,请不要使用本选项!
* *min_fans* - 设定BOSminer运行所需要的最少风扇数量 (默认值=1)。
* 要想完全 **禁用风扇控制**, 请将 'speed' (转速)和'min_fans' (最少风扇数)设定为0。
风扇的运行(Fan operation)
=========================
1. 一旦温度传感器启动,风扇控制也将启用。如温度传感器失效,或温度读数为零,风扇转速将自动设置为全速。
2. 如果当前模式为“固定风扇转速(Fixed fan speed)”,风扇将调节到设定的转速。
3. 如果当前模式为“自动风扇控制(Automatic fan control)”,风扇的转速调整由温度决定。
4. 如果矿机温度超过 *过热温度(HOT temperature)*, 风扇转速将自动设为100%(即使在“固定风扇转速(Fixed fan speed)”模式下)。
5. 如果矿机温度超过 *危险温度(DANGEROUS temperature)*, BOSminer将会关闭(即使在“固定风扇转速(Fixed fan speed)”模式下)。
************
自动升级(Auto-upgrade)
************
若启用自动升级,矿机将定期检查可用更新,并在发现有升级可用后自动升级Braiins OS的新版本。在从原厂固件切换到Braiins OS时,这一功能将默认启用。但是在从Braiins OS或Braiins OS+的旧版本升级的情况下,必须手动启动这一功能。
自动升级功能可以通过矿机网页界面GUI或使用BOS工具箱进行配置。
在矿机网页界面GUI中,请在目录 *系统(System) -> 升级(Upgrade)* 页面中编辑 *系统升级(System Upgrade)* 部分的内容。
使用 **BOS工具箱** 批量升级多台矿机 ,请参见 :ref:`bosbox_configure` 部分的操作。
或者,您也可以最开始在安装时,使用 ``--no-auto-upgrade`` 参数命令 **关闭** 自动升级功能。
**请注意:** 为保护矿场带宽不被升级占用,自动升级具有时间随机性从而让所有的矿机不会同时进行升级。自动升级会每天检查三次是否有可用的新版本。
*************************
SSH远程密码(SSH password)
*************************
您可以通过SSH从远程主机运行以下的命令来设置矿机的密码,请您使用您自己想用的密码替换下方命令中的 *[newpassword]* 项。
注:Braiins OS 不会保留已执行命令的历史记录。
.. code:: bash
ssh root@[miner-hostname-or-ip] 'echo -e "[newpassword]\n[newpassword]" | passwd'
如需在多台主机上同时执行此操作,可以使用 `p-ssh `__。
*********************************
MAC地址和IP地址(MAC & IP address)
*********************************
默认情况下,安装新固件后矿机的MAC地址,是从矿机(NAND)上的原有固件(原厂或Braiins OS)继承而来并保持不变。
同理,新安装Braiins OS的矿机开机后的IP地址和之前应该也是一样的。
此外,您也可以通过修改(位于SD卡第一个FAT分区中)的 ``uEnv.txt`` 文件中的 ``ethaddr=`` 参数,指定一个具体的MAC地址。