高级指南¶
工具及使用场景一览¶
有很多工具、安装包以及脚本都可以用于管理Braiins OS+。请使用下方的树状列表查找最适合您的情况:
安装Braiins OS+
使用BOS+工具箱 (使用BOS+工具箱安装Braiins OS+)
使用网页端后台方式安装包 (使用网页端后台方式安装包安装Braiins OS+)
使用SD卡刷 (使用SD卡方式安装映像安装Braiins OS+)
使用SD卡刷和矿机工具(Miner tool) (使用矿机工具(Miner tool)将SD卡上的固件安装到矿机内置储存NAND上)
使用SSH脚本(使用远程(SSH)方式安装包安装Braiins OS+)
升级Braiins OS+
使用BOS+工具箱 (使用BOS+工具箱升级Braiins OS+)
使用OPKG批量包 (使用OPKG包管理器升级Braiins OS+)
使用SYSUPGRADE(系统升级)包 (使用系统升级(Sysupgrade)从Braiins OS的其他版本切换到Braiins OS+)
使用BOS2BOS(从Braiins OS升级到Braiins OS其他版本的)脚本 (BOS到BOS(Bos2Bos)脚本)
降级到Braiins OS社区版(不带自动调整功能)
使用SYSUPGRADE(系统升级)包 (使用系统升级(Sysupgrade)从Braiins OS的其他版本切换到(不带自动调整功能的)Braiins OS)
使用BOS2BOS(从Braiins OS升级到Braiins OS其他版本的)脚本 (BOS到BOS(Bos2Bos)脚本)
升级到Braiins OS+(带自动调整功能)
使用OPKG批量包 (使用OPKG包管理器从Braiins OS的其他版本切换到Braiins OS+)
使用SYSUPGRADE(系统升级)包 (使用系统升级(Sysupgrade)从Braiins OS的其他版本切换到Braiins OS+)
使用BOS2BOS(从Braiins OS升级到Braiins OS的其他版本)脚本 (BOS到BOS(Bos2Bos)脚本)
重置到Braiins OS初始版本(矿机首次安装Braiins OS的版本) - 恢复出厂设置
使用OPKG批量包 (使用OPKG包管理器对Braiins OS+恢复出厂配置)
使用SD卡刷 (使用SD卡方式安装映像对Braiins OS+恢复出厂配置)
使用矿机工具(Miner tool) (使用矿机工具(Miner tool)对Braiins OS+恢复出厂配置)
使用BOS2BOS(从Braiins OS升级到Braiins OS其他版本的)脚本(BOS到BOS(Bos2Bos)脚本)
卸载Braiins OS+
使用BOS+工具箱 (使用BOS+工具箱卸载Braiins OS+)
使用SSH脚本 (使用远程(SSH)方式安装包卸载Braiins OS+)
开启/关闭预先发行版(Nightly Version)推送
使用矿机工具(Miner tool) (使用矿机工具(Miner tool)开启/关闭预先发行版(Nightly Version)推送)
开启/关闭自动更新
使用矿机工具(Miner tool) (使用矿机工具(Miner tool)开启/关闭自动升级)
在矿机上运行自定义Shell命令
使用BOS+工具箱 (使用BOS+工具箱在矿机上运行自定义命令)
BOS+工具箱¶
BOS+工具箱能让用户轻松安装,卸载,升级,检测以及配置Braiins OS+,并在矿机上运行自定义命令。它还有批量模式,让您对矿场的管理更得心应手。我们推荐您使用批量模式管理矿机。
如何使用¶
在我们 官网 上下载 BOS+工具箱 。
创建一个txt文本文件,并将文件命名为"listOfMiners",然后在文件内输入您想执行操作的矿机的IP地址, 一个IP地址一行 !保存文本文件后,再将文件后缀从".txt"改为".csv"。并确定此文件和BOS+工具箱都放在同一路径下(同一文件夹中)。
再按下面相应部分的步骤进行操作
BOS+工具箱的特性及优缺点¶
远程安装Braiins OS+
远程升级Braiins OS+
远程卸载Braiins OS+
远程配置Braiins OS+
在矿机上运行自定义命令
扫描网络中的矿机
安装Braiins OS+时默认自动转移原厂固件中的配置(也可以设置不转移)
卸载Braiins OS+时默认自动转移现有配置到原厂固件(也可以设置不转移)
可自定义进程的参数
安装Braiins OS+后默认自动开启矿机自动调整功能(默认功率限制1420瓦)
批量模式让管理大量矿机也能得心应手
使用简单,容易上手
不支持SSH功能被锁住的矿机
使用BOS+工具箱安装Braiins OS+¶
在我们 官网 上下载 BOS+工具箱 。
创建一个txt文本文件,并将文件命名为"listOfMiners",然后在文件内输入您想执行操作的矿机的IP地址, 一个IP地址一行 !保存文本文件后,再将文件后缀从".txt"改为".csv"。并确定此文件和BOS+工具箱都放在同一路径下(同一文件夹中)。
使用命令行(Windows操作系统的CMD,Ubuntu的Terminal终端等)。
用放置矿机地址文件和BOS+工具性的实际路径(文件夹地址),替换下方命令中的 FILE_PATH_TO_BOS+_TOOLBOX 。执行命令,切换到路径。
cd FILE_PATH_TO_BOS+_TOOLBOX然后根据您的操作系统,运行以下相应的命令:
在 Windows 上的命令提示行请用:
bos-plus-toolbox.exe install ARGUMENTS HOSTNAME在 Linux 上的Terminal控制终端请用:
./bos-plus-toolbox install ARGUMENTS HOSTNAME请注意: 当在Linux系统中使用BOS+工具箱时,您需要先使用以下命令让BOS+工具箱变得可执行(一次就够):
chmod u+x ./bos-plus-toolbox
您可以使用下方的 参数 调整安装进程:
重点: 当您在 单台矿机 上安装Braiins OS+时,需要使用 HOSTNAME 这个参数 (IP地址)。 当您在多台矿机上 批量 安装Braiins OS+时,请 不要 使用HOSTNAME这个参数,而是使用 --batch BATCH 这个参数。
参数 |
描述 |
---|---|
-h, --help |
显示帮助信息并退出 |
--batch BATCH |
指定"listOfMiners.csv"(矿机主机IP地址列表)文件 |
--backup |
在进行升级前备份矿机 |
--no-auto-upgrade |
关闭固件自动更新 |
--no-nand-backup |
跳过对矿机内置储存NAND的备份(仍备份矿机配置) |
--pool-user [POOL_USER] |
为默认矿池设置用户名(Username)和矿工名(Workername) |
--psu-power-limit [PSU_POWER_LIMIT] |
设置(以瓦为单位)的电源功率限制 |
--no-keep-network |
不保留(转移)矿机的原网络配置(在使用DHCP自动分配IP的情况下) |
--no-keep-pools |
不保留(转移)矿机的原矿池配置 |
--no-keep-hostname |
不保留(转移)矿机的原主机名(Hostname)并根据矿机MAC地址生成一个新的 |
--keep-hostname |
强制保留(转移)矿机的原主机名 |
--no-wait |
直到系统完全更新完毕不等待 |
--dry-run |
执行所有的更新步骤但不实际进行更新 |
--post-upgrade [POST_UPGRADE] |
指定stage3.sh脚本文件目录 |
--install-password INSTALL_PASSWORD |
设置安装的SSH密码 |
安装命令和参数使用示例如下:
bos-plus-toolbox.exe install --batch listOfMiners.csv --psu-power-limit 1200 --install-password admin
解释:上方的命令和参数,会将Braiins OS+安装到在 listOfMiners.csv (矿机IP地址列表)中列出的矿机上,并设置列表中所有矿机的输入功率限制为1200瓦。当矿机要求输入SSH密码时,命令将自动输入 admin 这个密码。
使用BOS+工具箱升级Braiins OS+¶
在我们 官网 上下载 BOS+工具箱 。
创建一个txt文本文件,并将文件命名为"listOfMiners",然后在文件内输入您想执行操作的矿机的IP地址, 一个IP地址一行 !保存文本文件后,再将文件后缀从".txt"改为".csv"。并确定此文件和BOS+工具箱都放在同一路径下(同一文件夹中)。
使用命令行(Windows操作系统的CMD,Ubuntu的Terminal终端等)。
用放置矿机地址文件和BOS+工具性的实际路径(文件夹地址),替换下方命令中的 FILE_PATH_TO_BOS+_TOOLBOX 。执行命令,切换到路径。
cd FILE_PATH_TO_BOS+_TOOLBOX然后根据您的操作系统,运行以下相应的命令:
在 Windows 上的命令提示行请用:
bos-plus-toolbox.exe update ARGUMENTS HOSTNAME在 Linux 上的Terminal控制终端请用:
./bos-plus-toolbox update ARGUMENTS HOSTNAME请注意: 当在Linux系统中使用BOS+工具箱时,您需要先使用以下命令让BOS+工具箱变得可执行(一次就够):
chmod u+x ./bos-plus-toolbox
您可以使用下方的 参数 调整更新进程:
重点: 当您在 单台矿机 上安装Braiins OS+时,需要使用 HOSTNAME 这个参数 (IP地址)。 当您在多台矿机上 批量 安装Braiins OS+时,请 不要 使用HOSTNAME这个参数,而是使用 --batch BATCH 这个参数。
参数 |
描述 |
---|---|
--h, --help |
显示帮助信息并退出 |
--batch BATCH |
指定"listOfMiners.csv"(矿机主机IP地址列表)文件 |
-p PASSWORD, --password PASSWORD |
矿机密码 |
-i, --ignore |
忽略错误 |
更新命令和参数使用示例如下:
bos-plus-toolbox.exe update --batch listOfMiners.csv
解释:上方的命令和参数,会在有新固件更新可用的情况下,对在 listOfMiners.csv (矿机IP地址列表)中列出矿机上的Braiins OS+进行更新。
使用BOS+工具箱卸载Braiins OS+¶
在我们 官网 上下载 BOS+工具箱 。
创建一个txt文本文件,并将文件命名为"listOfMiners",然后在文件内输入您想执行操作的矿机的IP地址,一个IP地址一行!(矿机的IP地址在矿机网页端界面中的 *Status(状态)-> Overview(总览)中可以进行查询)。保存文本文件后,再将文件后缀从".txt"改为".csv"。确定此文件和BOS+工具箱都放在同一路径下(同一文件夹中)。
使用命令行(Windows操作系统的CMD,Ubuntu的Terminal终端等)。
用放置矿机地址文件和BOS+工具性的实际路径(文件夹地址),替换下方命令中的*FILE_PATH_TO_BOS+_TOOLBOX*。执行命令,切换到路径。
cd FILE_PATH_TO_BOS+_TOOLBOX然后根据您的操作系统,运行以下相应的命令:
在 Windows 上的命令提示行请用:
bos-plus-toolbox.exe uninstall ARGUMENTS HOSTNAME 在 **Linux** 上的Terminal控制终端请用: :: ./bos-plus-toolbox uninstall ARGUMENTS HOSTNAME请注意: 当在Linux系统中使用BOS+工具箱时,您需要先使用以下命令让BOS+工具箱变得可执行(一次就够):
chmod u+x ./bos-plus-toolbox
您可以使用下方的 参数 调整卸载进程:
重点: 当您在 单台矿机 上安装Braiins OS+时,需要使用 HOSTNAME 这个参数 (IP地址)。 当您在多台矿机上 批量 安装Braiins OS+时,请 不要 使用HOSTNAME这个参数,而是使用 --batch BATCH 这个参数。
参数 |
描述 |
---|---|
-h, --help |
显示帮助信息并退出 |
--batch BATCH |
指定"listOfMiners.csv"(矿机主机IP地址列表)文件 |
--install-password INSTALL_PASSWORD |
用于安装的SSH密码 |
--factory-image FACTORY_IMAGE |
指定原厂更新固件文件路径或URL地址(默认是: Antminer-S9-all-201812051512-autofreq-user-Update2UBI- NF.tar.gz) |
卸载命令和参数使用示例如下:
bos-plus-toolbox.exe uninstall --batch listOfMiners.csv
解释:上方的命令和参数,会卸载在 listOfMiners.csv (矿机IP地址列表)中列出矿机上的Braiins OS+,并重装原厂固件(Antminer-S9-all-201812051512-autofreq-user-Update2UBI-NF.tar.gz)。
使用BOS+工具箱配置Braiins OS+¶
在我们 官网 上下载 BOS+工具箱 。
创建一个txt文本文件,并将文件命名为"listOfMiners",然后在文件内输入您想执行操作的矿机的IP地址,一个IP地址一行!(矿机的IP地址在矿机网页端界面中的 *Status(状态)-> Overview(总览)中可以进行查询)。保存文本文件后,再将文件后缀从".txt"改为".csv"。确定此文件和BOS+工具箱都放在同一路径下(同一文件夹中)。
使用命令行(Windows操作系统的CMD,Ubuntu的Terminal终端等)。
用放置矿机地址文件和BOS+工具性的实际路径(文件夹地址),替换下方命令中的*FILE_PATH_TO_BOS+_TOOLBOX*。执行命令,切换到路径。
cd FILE_PATH_TO_BOS+_TOOLBOX然后根据您的操作系统,运行以下相应的命令:
在 Windows 上的命令提示行请用:
bos-plus-toolbox.exe config ARGUMENTS ACTION TABLE在 Linux 上的Terminal控制终端请用:
./bos-plus-toolbox config ARGUMENTS ACTION TABLE请注意: 当在Linux系统中使用BOS+工具箱时,您需要先使用以下命令让BOS+工具箱变得可执行(一次就够):
chmod u+x ./bos-plus-toolbox
您可以使用下方的 参数 调整配置进程:
参数 |
描述 |
---|---|
-h, --help |
显示帮助信息并退出 |
-u USER, --user USER |
矿机网页端后台用户名 |
-p PASSWORD, --password PASSWORD |
矿机网页端后台密码 |
-c, --check |
不写入的试运行检查 |
-i, --ignore |
忽略错误 |
您必须 至少选择使用 下方的 动作 中的一个来调整配置进程:
参数 |
描述 |
---|---|
load |
加载矿机的目前配置到一个CSV文件中 |
save |
保存CSV文件中的矿机设定到矿机(但尚未应用设定) |
apply |
应用之前从CSV文件复制(保存)到矿机上的设定 |
save_apply |
保存并应用之前从CSV文件复制(保存)到矿机上的设定 |
配置命令和参数使用示例如下:
bos-plus-toolbox.exe config --user root load listOfMiners.csv
#把矿机上的配置加载到CSV文件中后,可以通过表格软件编辑配置(如MS Office Excel,LibreOffice Calc等)
bos-plus-toolbox.exe config --user root save_apply listOfMiners.csv
解释:上方的第一个命令和参数,会(使用*root*这个后台用户名)提取在 listOfMiners.csv (矿机IP地址列表)中列出矿机的配置,并将这些配置保存到一个CSV文件中。然后您可以打开并编辑这个CSV文件,调整矿机的配置。您改动好之后,就可以用上方的第二个命令和参数,将配置复制(保存)到矿机上,并应用新配置。
使用BOS+工具箱扫描网络并发现矿机¶
在我们 官网 上下载 BOS+工具箱 。
创建一个txt文本文件,并将文件命名为"listOfMiners",然后在文件内输入您想执行操作的矿机的IP地址,一个IP地址一行!(矿机的IP地址在矿机网页端界面中的 *Status(状态)-> Overview(总览)中可以进行查询)。保存文本文件后,再将文件后缀从".txt"改为".csv"。确定此文件和BOS+工具箱都放在同一路径下(同一文件夹中)。
使用命令行(Windows操作系统的CMD,Ubuntu的Terminal终端等)。
用放置矿机地址文件和BOS+工具箱的实际路径(文件夹地址),替换下方命令中的*FILE_PATH_TO_BOS+_TOOLBOX*。执行命令,切换到路径。
cd FILE_PATH_TO_BOS+_TOOLBOX然后根据您的操作系统,运行以下相应的命令:
在 Windows 上的命令提示行请用:
bos-plus-toolbox.exe discover ARGUMENTS在 Linux 上的Terminal控制终端请用:
./bos-plus-toolbox discover ARGUMENTS请注意: 当在Linux系统中使用BOS+工具箱时,您需要先使用以下命令让BOS+工具箱变得可执行(一次就够):
chmod u+x ./bos-plus-toolbox
您可以使用下方的 参数 调整网络扫描和矿机发现进程:
参数 |
描述 |
---|---|
-h, --help |
显示帮助信息并退出 |
您必须 至少选择使用 下方的 参数 中的一个来调整网络扫描和矿机发现进程:
参数 |
描述 |
---|---|
scan |
主动扫描提供的IP地址范围 |
listen |
监听矿机识别广播(当按下IP report键时) |
网络扫描和矿机发现命令和参数使用示例如下:
#扫描从10.10.10.0到10.10.10.255的网络范围
bos-plus-toolbox.exe discover scan 10.10.10.0/24
#扫描从10.10.0.0到10.10.255.255的网络范围
bos-plus-toolbox.exe discover scan 10.10.0.0/16
#扫描从10.10.0.0到10.255.255.255的网络范围
bos-plus-toolbox.exe discover scan 10.0.0.0/8
使用BOS+工具箱在矿机上运行自定义命令¶
在我们 官网 上下载 BOS+工具箱 。
创建一个txt文本文件,并将文件命名为"listOfMiners",然后在文件内输入您想执行操作的矿机的IP地址,一个IP地址一行!(矿机的IP地址在矿机网页端界面中的 *Status(状态)-> Overview(总览)中可以进行查询)。保存文本文件后,再将文件后缀从".txt"改为".csv"。确定此文件和BOS+工具箱都放在同一路径下(同一文件夹中)。
使用命令行(Windows操作系统的CMD,Ubuntu的Terminal终端等)。
用放置矿机地址文件和BOS+工具箱的实际路径(文件夹地址),替换下方命令中的*FILE_PATH_TO_BOS+_TOOLBOX*。执行命令,切换到路径。
cd FILE_PATH_TO_BOS+_TOOLBOX然后根据您的操作系统,运行以下相应的命令:
在 Windows 上的命令提示行请用:
bos-plus-toolbox.exe command ARGUMENTS TABLE COMMAND在 Linux 上的Terminal控制终端请用:
./bos-plus-toolbox command ARGUMENTS TABLE COMMAND请注意: 当在Linux系统中使用BOS+工具箱时,您需要先使用以下命令让BOS+工具箱变得可执行(一次就够):
chmod u+x ./bos-plus-toolbox
您可以使用下方的 参数 调整矿机运行自定义命令的进程:
参数 |
描述 |
---|---|
-h, --help |
显示帮助信息并退出 |
-a, --auto |
若RPC不可用的话则使用SSH |
-l, --legacy |
使用SSH |
-L, --no-legacy |
使用RPC |
-o, --output |
捕获并打印远程输出 |
-O, --output-hostname |
捕获并打印远程输出某个Hostname |
-p PASSWORD, --password PASSWORD |
密码管理 |
-j JOBS, --jobs JOBS |
当前工作数量 |
您必须 至少选择使用 下方的 命令 中的一个来调整矿机运行自定义命令的进程:
命令 |
描述 |
---|---|
start |
启动BOSminer |
stop |
关闭BOSminer |
custom_shell_command |
使用您自己的Shell命令,替换 custom_shell_command (例如用 cat /etc/bosminer.toml 命令 显示 bosminer.toml 配置文件的内容) |
矿机运行自定义命令的命令和参数使用示例如下:
#关闭BOSminer, 有效地停止挖矿并将电能消耗降到最低
bos-plus-toolbox.exe command -o list.csv stop
网页端后台方式安装包¶
如果您使用的是2019年前的原厂固件,您从矿机的网页端后台,使用Braiins OS+的网页端后台方式安装包,即可用直接升级Braiins OS+。使用的是其他基于原厂固件的第三方固件的情况下也应该是同理的。由于2019年后发布的原厂固件,对网页端后台升级采取了固件签名认证来防止安装第三方固件,所以Braiins OS+的网页端后台方式安装包就无法用于对2019年后发布的原厂固件的升级。
此方式的特性和优缺点:¶
无需额外工具就能直接用Braiins OS+替换调原厂固件
默认自动转移原厂固件的网络配置
默认自动转移原厂固件的矿池URL地址,用户名及密码
默认自动开启矿机自动调整功能(默认功率限制1420瓦)
不支持升级2019年及之后发布的原厂固件
不支持配置安装(比如始终会自动转移网络配置)
不支持批量操作(除非您自己写脚本)
SD卡方式安装映像¶
如果您使用的是2019年前的原厂固件,您只能通过SD卡刷的方法来安装Braiins OS。因为从2019年起的原厂固件为了防止第三方固件的使用,封锁了SSH连接并在网页端后台升级刷固件时要求验证签名。
此方式的特性和优缺点:¶
用Braiins OS+替换锁定SSH的原厂固件
默认使用内置储存NAND中的网络配置 (可禁用, 见下方的 网络设置 部分)
默认自动开启矿机自动调整功能(默认功率限制1420瓦)
不支持转移之前的矿池URL,用户名及密码
不支持批量操作
使用SD卡方式安装映像安装Braiins OS+¶
网络配置¶
默认情况下,当从SD卡启动Braiins OS+时,将使用内置储存NAND上的网络配置置。此特性可以按照以下步骤禁用:
加载SD卡上的第一个FAT格式的分区
打开uEnv.txt文件并插入下方的参数 (注意空行,一条参数一行)
cfg_override=no
对在网络中找不到(无法发现)矿机的矿工来说,禁用原始网络配置会很有帮助(比如NAND中原静态IP地址不在局域网地址范围内)。禁用之后,则使用DHCP动态IP地址。
将固件刷到矿机内置储存NAND上¶
- 您也可以将SD卡上的Braiins OS+刷到矿机内置储存NAND上。有两种方式可选:
在您矿机的网页端后台中,点击 System(系统) -> Install current system to device (NAND)(安装当前系统到矿机(NAND)上)
或通过SSH,使用 miner(矿机) 工具 —— 请按指南中 ref:miner_nand_install 的部分进行
使用SD卡方式安装映像对Braiins OS+恢复出厂配置¶
您可以按下方步骤恢复出厂配置:
加载SD卡上的第一个FAT格式的分区
打开uEnv.txt文件并插入下方的参数 (注意空行,一条参数一行)
factory_reset=yes
远程(SSH)方式安装包¶
您可以使用 远程(SSH)方式安装包 安装或卸载Braiins OS+。由于此方法需要用到Python设置,我们并不推荐使用此方法。您最好使用BOS+工具箱。
此方式的特性和优缺点:¶
远程安装Braiins OS+
远程卸装Braiins OS+
在安装Braiins OS+时,自动转移原厂固件的完整配置到Braiins OS+上(可自选)
在卸载Braiins OS+时,自动转移Braiins OS+固件的完整配置到原厂固件上(可自选)
可使用参数自定义安装/卸载过程
在安装Braiins OS+后,默认自动开启矿机自动调整功能(默认功率限制1420瓦)
不支持批量操作(除非您自己写脚本)
配置过程耗时
不支持SSH远程功能被锁住的矿机
准备环境¶
首先,您需要准备Python环境。请按下方步骤操作:
(仅在Windows上作这一步) 从 微软商店 下载安装 “Ubuntu for Windows 10“ 。
在命令行终端中运行以下命令:
(请注意,以下命令仅适用于Ubuntu或Ubuntu for Windows 10。如您使用的是另外的Linux发行版或其他操作系统,请查阅相应的技术文档并对以下命令作出相应的更改。)
#更新库和安装发布环境(Dependencies)
sudo apt update && sudo apt install python3 python3-virtualenv virtualenv
#下载和解压固件包
#Antminer S9
wget -c https://feeds.braiins-os.com/20.09/braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus.tar.gz -O - | tar -xz
#Antminer S17
wget -c https://feeds.braiins-os.com/20.09/braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus.tar.gz -O - | tar -xz
#更改固件解压文件夹的目录
#Antminer S9
cd ./braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus
#Antminer S17
cd ./braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus
#创建一个虚拟环境并启用
virtualenv --python=/usr/bin/python3 .env && source .env/bin/activate
#安装所需的Python包
python3 -m pip install -r requirements.txt
使用远程(SSH)方式安装包安装Braiins OS+¶
请按以下步骤使用所谓的“远程(SSH)方式”安装Braiins OS+:
(自定义固件) 刷原厂固件。如果设备已经运行的是原厂固件或旧版本的Braiins OS,则此步可以跳过。 (请注意:取决于固件版本,Braiins OS+有可能可以直接从自定义固件升级,可能最开始需要刷原厂固件。)
(仅在Windows上作这一步) 从 微软商店 下载安装 “Ubuntu for Windows 10“ 。
准备Python环境,请详见 准备环境 部分。
在命令行终端中,运行以下命令(按矿机实际IP地址替换命令中的
IP_ADDRESS
):
(请注意,以下命令仅适用于Ubuntu或Ubuntu for Windows 10。如您使用的是另外的Linux发行版或其他操作系统,请查阅相应的技术文档并对以下命令作出相应的更改。)
#更改固件解压文件夹的目录(如已不在固件文件夹中)
#Antminer S9
cd ./braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus
#Antminer S17
cd ./braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus
#启用虚拟环境(如尚未启用)
source .env/bin/activate
#运行Braiins OS+安装脚本
python3 upgrade2bos.py IP_ADDRESS
注: 更多关于可用参数的信息说明,可用参数 --help 查看。
使用远程(SSH)方式安装包卸载Braiins OS+¶
用原厂固件映像的情况下¶
您首先需要准备Python环境,请详见 准备环境 部分的内容。
在蚂蚁矿机S9上,您可以使用厂家官网上的以 tar.gz
为格式未解压的原厂固件下载地址URL,替换下方命令中的 FACTORY_IMAGE
,并按矿机实际IP地址替换命令中的 IP_ADDRESS
, 并运行下方命令。
(支持的固件映像及其相应的MD5哈希值在Github上的 platform.py 文件中已列出。)
#Antminer S9
cd ~/braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py --factory-image FACTORY_IMAGE IP_ADDRESS
#Antminer S17
cd ~/braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py --factory-image FACTORY_IMAGE IP_ADDRESS
注: 更多关于可用参数的信息说明,可用参数 --help 查看。
用之前创建的备份的情况下¶
您首先需要准备Python环境,请详见 准备环境 部分的内容。
如果您在之前安装Braiins OS+时创建了原厂固件的备份,您可以通过下方命令恢复这个备份(按备份ID和日期,和矿机实际IP地址替换命令中 BACKUP_ID_DATE
和 IP_ADDRESS
):
#Antminer S9
cd ~/braiins-os_am1-s9_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py backup/BACKUP_ID_DATE/ IP_ADDRESS
#Antminer S17
cd ~/braiins-os_am2-s17_ssh_2020-09-07-1-463cb8d0-20.09-plus && source .env/bin/activate
python3 restore2factory.py backup/BACKUP_ID_DATE/ IP_ADDRESS
注: 因为备份创建的要求比较复杂,也没有办法能够检查可能已损坏的备份文件,一般不推荐使用此法卸载Braiins OS+。请在使用过程中自行注意风险,如备份恢复失败,您还可以选择使用通过SD卡方式恢复矿机固件!
OPKG包管理器¶
在通过远程SSH连接矿机后,就能使用OPKG包管理器命令。OPKG包管理器命令有很多,对于Braiins OS+,相应的OPKG包管理器命令如下:
- ::
opkg update - 更新包列表。推荐在使用其他OPKG包管理器命令前使用此命令。
opkg install PACKAGE_NAME - 安装定义名称的包。推荐在使用此命令安装前使用 opkg update 命令更新包列表。i
opkg remove PACKAGE_NAME - 移除定义名称的包。
由于固件的改变会导致重启,以下的输出将会出现:
...
Collected errors:
* opkg_conf_load: Could not lock /var/lock/opkg.lock: Resource temporarily unavailable.
Saving config files...
Connection to 10.10.10.1 closed by remote host.
Connection to 10.10.10.1 closed.
此方式的特性和优缺点:¶
远程升级Braiins OS+
远程从Braiins OS的其他版本切换到Braiins OS+
远程回滚Braiins OS初始版本
无需进行任何配置,默认自动转移矿机原厂配置并继续挖矿(当升级或切换到Braiins OS+时)
不支持批量操作(除非您自己写脚本)
使用OPKG包管理器升级Braiins OS+¶
通过远程SSH方式连接到矿机,并使用以下命令,您就能使用OPKG包管理器轻松升级您安装的Braiins OS+:
opkg update
opkg install firmware
#也可以用远程SSH连接您的矿机并运行:
ssh root@IP_ADDRESS "opkg update && opkg install firmware"
命令自动会转移您矿机的配置,您不需要作任何矿机配置上的改动。
使用OPKG包管理器从Braiins OS的其他版本切换到Braiins OS+¶
通过远程SSH方式连接到矿机,并使用以下命令,您就能使用OPKG包管理器轻松切换到Braiins OS+:
opkg update
opkg install bos_plus
#也可以用远程SSH连接您的矿机并运行:
ssh root@IP_ADDRESS "opkg update && opkg install bos_plus"
命令自动会转移您矿机的配置,您不需要作任何矿机配置上的改动。默认功率将被限制为1420瓦。
使用OPKG包管理器对Braiins OS+恢复出厂配置¶
通过远程SSH方式连接到矿机,并使用以下命令,您就能使用OPKG包管理器轻松回滚到初始(在矿机上首次安装)的Braiins OS版本:
opkg update
opkg remove firmware
#也可以用远程SSH连接您的矿机并运行:
ssh root@IP_ADDRESS "opkg update && opkg remove firmware"
命令会将配置重置到初次安装Braiins OS后的状态。
系统升级(Sysupgrade)包¶
系统升级(Sysupgrade)可以用于矿机上运行的系统。您可以使用此方式安装Braiins OS的各种版本,或创建系统备份。使用 Braiins OS网页端后台 或 opkg安装固件 安装固件就是使用了系统升级(Sysupgrade)包的方式。建议直接使用 Braiins OS网页端后台 或 opkg安装固件 而不是此方式进行安装。
如何使用¶
您需要通过远程SSH连接到矿机来使用系统升级(Sysupgrade)。句法如下:
sysupgrade [parameters] <image file or URL>
最重要的参数是 --help (显示帮助信息)和 -F (强制安装)。除非是在您对此方式相当熟悉的情况下,通常不建议使用这种方式进行固件安装。
此方式的特性和优缺点:¶
当连接到矿机时,在矿机上安装各种版本的Braiins OS
默认自动转移原厂固件的配置
可使用参数自定义过程
不支持批量操作(除非您自己写脚本)
不支持切换到较旧版本的Braiins OS(2020年以前发布的)
使用系统升级(Sysupgrade)从Braiins OS的其他版本切换到(不带自动调整功能的)Braiins OS¶
请使用下方命令(并根据实际IP地址替换 IP_ADDRESS
),对旧版本的Braiins OS进行升级,或从Braiins OS+降级到Braiins OS:
#Antminer S9
ssh root@IP_ADDRESS 'wget -O /tmp/firmware.tar https://feeds.braiins-os.org/am1-s9/firmware_2020-09-07-0-e50f2a1b-20.09_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
#Antminer S17
ssh root@IP_ADDRESS 'wget -O /tmp/firmware.tar https://feeds.braiins-os.org/am2-s17/firmware_2020-09-07-0-e50f2a1b-20.09_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
此命令包含以下的命令:
ssh - 远程SSH连接到矿机
wget - 下载文件,这里具体指下载固件包
sysupgrade - 将下载的固件包刷到矿机上
使用系统升级(Sysupgrade)从Braiins OS的其他版本切换到Braiins OS+¶
使用下方命令(并根据实际IP地址替换 IP_ADDRESS
),从旧版本的Braiins OS升级到从Braiins OS+:
#Antminer S9
ssh root@IP_ADDRESS 'wget -O /tmp/firmware.tar https://feeds.braiins-os.com/am1-s9/firmware_2020-09-07-1-463cb8d0-20.09-plus_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
#Antminer S17
ssh root@IP_ADDRESS 'wget -O /tmp/firmware.tar https://feeds.braiins-os.com/am2-s17/firmware_2020-09-07-1-1f02b3bd-20.09-plus_arm_cortex-a9_neon.tar && sysupgrade /tmp/firmware.tar'
This command contains the following commands:
此命令包含以下的命令:
ssh - 远程SSH连接到矿机
wget - 下载文件,这里具体指下载固件包
sysupgrade - 将下载的固件包刷到矿机上
注意:推荐使用 BOS+工具箱 , Braiins OS网页端后台 或 opkg install bos_plus命令 而不是使用此方法升级。
BOS到BOS(Bos2Bos)脚本¶
除非是在您对此方式相当熟悉的情况下,通常不建议使用BOS到BOS(Bos2Bos)脚本这种方式进行固件安装 除非是在您在使用其他方法安装遇到问题的情况下,通常不建议使用BOS到BOS(Bos2Bos)脚本。 只有矿机上已安装有Braiins OS,此方法才会是有效的。
此方式的特性和优缺点:¶
远程安装Braiins OS的任意版本
安装纯净版Braiins OS
可使用参数自定义过程
不支持批量操作(除非您自己写脚本)
如何使用¶
使用BOS到BOS(Bos2Bos)脚本需要的环境设置如下:
(仅在Windows上作这一步) 从 微软商店 下载安装 “Ubuntu for Windows 10“ 。
在命令行终端中运行以下命令:
(请注意,以下命令仅适用于Ubuntu或Ubuntu for Windows 10。如您使用的是另外的Linux发行版或其他操作系统,请查阅相应的技术文档并对以下命令作出相应的更改。)
#更新库和安装发布环境(Dependencies)
sudo apt update && sudo apt install python3 python3-virtualenv virtualenv
#克隆库
git clone https://github.com/braiins/braiins-os.git
#更改目录
cd ./braiins-os/braiins-os/
#创建一个虚拟环境并启用
virtualenv --python=/usr/bin/python3 .env && source .env/bin/activate
#安装所需的Python包
python3 -m pip install -r requirements.txt
在您完成环境设置后,您可以使用以下命令:
- ::
#启用虚拟环境 source .env/bin/activate
#下方是基本用法 python3 bos2bos.py FIRMWARE_URL IP_ADDRESS
#下方是可用于显示所有可用参数的帮助信息的命令 python3 bos2bos.py -h
矿机工具(Miner tool)¶
使用矿机工具(Miner tool)将SD卡上的固件安装到矿机内置储存NAND上¶
通过远程SSH方式连接到矿机,并使用以下命令,就能用SD卡上的Braiins OS+固件替换矿机内置储存NAND中的固件:
miner nand_install
使用矿机工具(Miner tool)对Braiins OS+恢复出厂配置¶
使用以下命令,同样能通过 矿机工具(Miner tool) 对矿机上的Braiins OS+恢复出厂配置:
miner factory_reset
使用矿机工具(Miner tool)通过LED灯找出矿机¶
使用以下命令,您就可以通过 矿机工具(Miner tool) 以让矿机LED闪烁的方式找出矿机:
#开启LED闪烁 miner fault_light on #关闭LED闪烁 miner fault_light off
使用矿机工具(Miner tool)开启/关闭预先发行版(Nightly Version)推送¶
预先发行版旨在最快能修复固件的一些关键问题,因此它在发布前不会像正式版那样经过全面测试。使用以下命令,您就可以通过 矿机工具(Miner tool) 开启或关闭最新的预先发行版更新推送:
#开启预先发行版推送 miner nightly_feeds on #关闭预先发行版推送 miner nightly_feeds off
使用矿机工具(Miner tool)开启/关闭自动升级¶
您可以通过开启自动升级这一特性,让矿机固件自动升级到最新的系统版本。这一特性在从 原厂 固件切换到Braiins OS+时是默认 开启 的,从 Braiins OS 或 Braiins OS+ 的旧版本升级的情况下是默认 关闭 的。使用以下命令,您就可以通过 矿机工具(Miner tool) 开启/关闭固件自动升级:
#开启自动升级 miner auto_upgrade on #关闭自动升级 miner auto_upgrade off