高级指南

工具及使用场景一览

有很多工具、安装包以及脚本都可以用于管理Braiins OS。请使用下方的树状列表查找最适合您的情况:

  • 安装Braiins OS

  • 蚂蚁矿机S9固件远程SSH锁解锁

  • 升级Braiins OS

  • 切换到Braiins OS社区版(不带自动调整功能)

  • 切换到Braiins OS+(带自动调整功能)

  • 重置到Braiins OS初始版本(矿机首次安装Braiins OS的版本) - 恢复出厂设置

  • 卸载Braiins OS

  • 开启/关闭预先发行版(Nightly Version)推送

  • 开启/关闭自动更新

  • 在矿机上运行自定义Shell命令

BOS工具箱

BOS工具箱能让用户轻松安装,卸载,升级,检测以及配置Braiins OS,并在矿机上运行自定义命令。它还有批量模式,并支持自动下载更新最新版本的固件,让您对矿场的管理更得心应手。我们推荐您使用批量模式管理矿机。

如何使用

  • 在我们 官网 上下载 BOS工具箱

  • 创建一个txt文本文件,并将文件命名为"listOfMiners",然后在文件内输入您想执行操作的矿机的IP地址, 一个IP地址一行 !保存文本文件后,再将文件后缀从".txt"改为".csv"。并确定此文件和BOS工具箱都放在同一路径下(同一文件夹中)。

  • 再按下面相应部分的步骤进行操作

BOS工具箱的特性及优缺点

  • 远程安装Braiins OS,在安装过程中自动破解S9矿机上的官固锁

  • 远程升级Braiins OS

  • 远程卸载Braiins OS

  • 远程配置Braiins OS

  • 在矿机上运行自定义命令

  • 扫描网络中的矿机

  • 安装Braiins OS时默认自动转移原厂固件中的配置(也可以设置不转移)

  • 卸载Braiins OS时默认自动转移现有配置到原厂固件(也可以设置不转移)

  • 可自定义进程的参数

  • 批量模式让管理大量矿机也能得心应手

  • 使用简单,容易上手

  • 不支持SSH远程功能被锁住的X17系列矿机

使用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-toolbox.bat install ARGUMENTS HOSTNAME
    

    Linux 上的Terminal控制终端请用:

    ./bos-toolbox install ARGUMENTS HOSTNAME
    

    请注意: 当在Linux系统中使用BOS工具箱时,您需要先使用以下命令让BOS工具箱变得可执行(一次就够):

    chmod u+x ./bos-toolbox
    

您可以使用下方的 参数 调整安装进程:

重点: 当您在 单台矿机 上安装Braiins OS时,需要使用 HOSTNAME 这个参数 (IP地址)。 当您在多台矿机上 批量 安装Braiins OS时,请 不要 使用HOSTNAME这个参数,而是使用 --batch BATCH 这个参数。

参数

描述

-h, --help

显示帮助信息并退出

--open-source

安装开源社区版Braiins OS(不可和 预先发行版自定义固件下载链接 参数同时使用)

--nightly

安装预先发行版(不可和 社区开源版自定义固件下载链接 参数同时使用)

--feeds-url [FEEDS_URL]

自定义固件下载URL链接地址(不可和 社区开源版预先发行版 参数同时使用)

--fw-version [FW_VERSION]

选择固件的某个特定版本

--backup

在进行升级前备份矿机

--no-auto-upgrade

关闭固件自动更新

--no-nand-backup

跳过对矿机内置储存NAND的备份(仍备份矿机配置)

--pool-user [POOL_USER]

为默认矿池设置用户名(Username)和矿工名(Workername)

--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脚本文件目录

--bos-mgmt-id [BOS_MGMT_ID]

设置BOS工具箱管理识别标签

-p PASSWORD, --password PASSWORD

矿机密码

安装命令和参数使用示例如下:

bos-toolbox.bat install --password root --open-source listaDeMineros.csv

解释:上方的命令和参数,会自动破解官固固件锁并将Braiins OS安装到在 listOfMiners.csv (矿机IP地址列表)中列出的矿机上。当矿机要求输入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-toolbox.bat update ARGUMENTS HOSTNAME
    

    Linux 上的Terminal控制终端请用:

    ./bos-toolbox update ARGUMENTS HOSTNAME
    

    请注意: 当在Linux系统中使用BOS工具箱时,您需要先使用以下命令让BOS工具箱变得可执行(一次就够):

    chmod u+x ./bos-toolbox
    

您可以使用下方的 参数 调整更新进程:

重点: 当您在 单台矿机 上安装Braiins OS时,需要使用 HOSTNAME 这个参数 (IP地址)。 当您在多台矿机上 批量 安装Braiins OS时,请 不要 使用HOSTNAME这个参数,而是使用 --batch BATCH 这个参数。

参数

描述

--h, --help

显示帮助信息并退出

-p PASSWORD, --password PASSWORD

矿机密码

-i, --ignore

忽略错误

更新命令和参数使用示例如下:

bos-toolbox.bat update 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-toolbox.bat uninstall ARGUMENTS HOSTNAME
    
    在 **Linux** 上的Terminal控制终端请用: ::
    
     ./bos-toolbox uninstall ARGUMENTS HOSTNAME
    

    请注意: 当在Linux系统中使用BOS工具箱时,您需要先使用以下命令让BOS工具箱变得可执行(一次就够):

    chmod u+x ./bos-toolbox
    

您可以使用下方的 参数 调整卸载进程:

重点: 当您在 单台矿机 上安装Braiins OS时,需要使用 HOSTNAME 这个参数 (IP地址)。 当您在多台矿机上 批量 安装Braiins OS时,请 不要 使用HOSTNAME这个参数,而是使用 --batch BATCH 这个参数。

参数

描述

-h, --help

显示帮助信息并退出

--install-password INSTALL_PASSWORD

用于安装的SSH密码

--feeds-url [FEEDS_URL]

自定义固件下载URL链接地址

--nand-restore

使用上一次从矿机NAND储存备份的矿机固件

卸载命令和参数使用示例如下:

bos-toolbox.bat uninstall listOfMiners.csv

解释:上方的命令和参数,会卸载在 listOfMiners.csv (矿机IP地址列表)中列出矿机上的Braiins OS,并重装原厂固件。

卸装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-toolbox.bat config ARGUMENTS ACTION TABLE
    

    Linux 上的Terminal控制终端请用:

    ./bos-toolbox config ARGUMENTS ACTION TABLE
    

    请注意: 当在Linux系统中使用BOS工具箱时,您需要先使用以下命令让BOS工具箱变得可执行(一次就够):

    chmod u+x ./bos-toolbox
    

您可以使用下方的 参数 调整配置进程:

参数

描述

-h, --help

显示帮助信息并退出

-u USER, --user USER

矿机网页端后台用户名

-p PASSWORD, --password PASSWORD

矿机网页端后台密码

-P, --change-password

允许更改(*listOfMiners.csv*文件中列出矿机)的密码

-c, --check

不写入的试运行检查

-i, --ignore

忽略错误

您必须 至少选择使用 下方的 动作 中的一个来调整配置进程:

参数

描述

load

加载矿机的目前配置到一个CSV文件中

save

保存CSV文件中的矿机设定到矿机(但尚未应用设定)

apply

应用之前从CSV文件复制(保存)到矿机上的设定

save_apply

保存并应用之前从CSV文件复制(保存)到矿机上的设定

配置命令和参数使用示例如下:

bos-toolbox.bat config --user root load listOfMiners.csv

#把矿机上的配置加载到CSV文件中后,可以通过表格软件编辑配置(如MS Office Excel,LibreOffice Calc等)

bos-toolbox.bat config --user root -p admin -P 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-toolbox.bat discover ARGUMENTS
    

    Linux 上的Terminal控制终端请用:

    ./bos-toolbox discover ARGUMENTS
    

    请注意: 当在Linux系统中使用BOS工具箱时,您需要先使用以下命令让BOS工具箱变得可执行(一次就够):

    chmod u+x ./bos-toolbox
    

您可以使用下方的 参数 调整网络扫描和矿机发现进程:

参数

描述

-h, --help

显示帮助信息并退出

您必须 至少选择使用 下方的 参数 中的一个来调整网络扫描和矿机发现进程:

参数

描述

scan

主动扫描提供的IP地址范围

listen

监听矿机识别广播(当按下IP report键时)

网络扫描和矿机发现命令和参数使用示例如下:

#扫描从10.10.10.0到10.10.10.255的网络范围
bos-toolbox.bat discover scan 10.10.10.0/24

#扫描从10.10.0.0到10.10.255.255的网络范围
bos-toolbox.bat discover scan 10.10.0.0/16

#扫描从10.10.0.0到10.255.255.255的网络范围
bos-toolbox.bat 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-toolbox.bat command ARGUMENTS TABLE COMMAND
    

    Linux 上的Terminal控制终端请用:

    ./bos-toolbox command ARGUMENTS TABLE COMMAND
    

    请注意: 当在Linux系统中使用BOS工具箱时,您需要先使用以下命令让BOS工具箱变得可执行(一次就够):

    chmod u+x ./bos-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-toolbox.bat command -o list.csv stop

使用BOS工具箱解锁蚂蚁矿机S9上的固件远程SSH锁

  • 在我们 官网 上下载 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-toolbox.bat unlock ARGUMENTS HOSTNAME
    

    Linux 上的Terminal控制终端请用:

    ./bos-toolbox unlock ARGUMENTS HOSTNAME
    

    请注意: 当在Linux系统中使用BOS工具箱时,您需要先使用以下命令让BOS工具箱变得可执行(一次就够):

    chmod u+x ./bos-toolbox
    

您可以使用下方的 参数 调整解锁进程:

重点: 当您在 单台矿机 上安装Braiins OS时,需要使用 HOSTNAME 这个参数 (IP地址)。 当您在多台矿机上 批量 安装Braiins OS时,请 不要 使用HOSTNAME这个参数,而是使用 --batch BATCH 这个参数。

参数

描述

--h, --help

显示帮助信息并退出

-u USERNAME, --username USERNAME

矿机登录名

-p PASSWORD, --password PASSWORD

矿机密码

--port PORT

矿机端口

--ssl

是否使用SSL

安装命令和参数使用示例如下:

bos-toolbox.bat unlock -p root listOfMiners.csv

解释:上方的命令和参数,会解锁在 listOfMiners.csv (矿机IP地址列表)中列出的矿机上的固件远程SSH锁。

网页端后台方式安装包

如果您使用的是2019年前的原厂固件,您从矿机的网页端后台,使用Braiins OS的网页端后台方式安装包,即可用直接升级Braiins OS。使用的是其他基于原厂固件的第三方固件的情况下也应该是同理的。由于2019年后发布的原厂固件,对网页端后台升级采取了固件签名认证来防止安装第三方固件,所以Braiins OS的网页端后台方式安装包就无法用于对2019年后发布的原厂固件的升级。

如何使用

  • 在我们 官网 上下载 网页端后台方式安装包

  • 再按下方步骤进行操作.

此方式的特性和优缺点:

  • 无需额外工具就能直接用Braiins OS替换调原厂固件

  • 默认自动转移原厂固件的网络配置

  • 默认自动转移原厂固件的矿池URL地址,用户名及密码

  • 不支持升级2019年及之后发布的原厂固件

  • 不支持配置安装(比如始终会自动转移网络配置)

  • 不支持批量操作(除非您自己写脚本)

使用网页端后台方式安装包安装Braiins OS

  • 在我们 官网 上下载 网页端后台方式安装包

  • 登陆您矿机的网页端后台,点击 System(系统) -> Upgrade(升级)

  • 上传您下载的安装包,并刷入固件映像。

SD卡方式安装映像

如果您使用的是2019年前的原厂固件,您只能通过SD卡刷的方法来安装Braiins OS。因为从2019年起的原厂固件为了防止第三方固件的使用,封锁了SSH连接并在网页端后台升级刷固件时要求验证签名。

如何使用

  • 在我们 官网 上下载 SD卡方式安装映像

  • 再按下方步骤进行操作。

此方式的特性和优缺点:

  • 用Braiins OS替换锁定SSH的原厂固件

  • 默认使用内置储存NAND中的网络配置 (可禁用, 见下方的 网络设置 部分)

  • 不支持转移之前的矿池URL,用户名及密码

  • 不支持批量操作

使用SD卡方式安装映像安装Braiins OS

  • 在我们 官网 上下载 SD卡方式安装映像

  • 将下载的映像烧录到SD卡上(例如使用像 Etcher 之类的烧录软件)。请注意:光复制到SD卡上是不够的,必须用软件刷到卡上!

  • (只有蚂蚁矿机S9) 调整跳线,让矿机从SD卡启动(而不是从NAND内存),如下所示。

S9 跳线 S9 跳线板

  • 将SD卡插到矿机上,开机。

  • 过一会,您就应该能通过设备的IP地址进到Braiins OS界面了。

  • [可选操作]: 您也可以将Braiins OS从SD卡刷到内置储存(NAND)上。具体请详见 :ref:`sd_nand_install`这一部分的内容。

网络配置

默认情况下,当从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工具箱。

如何使用

  • 在我们 官网 上下载 远程(SSH)方式安装包

  • 再按下方步骤进行操作。

此方式的特性和优缺点:

  • 远程安装Braiins OS

  • 远程卸装Braiins OS

  • 在安装Braiins OS时,自动转移原厂固件的完整配置到Braiins OS上(可自选)

  • 在卸载Braiins OS时,自动转移Braiins OS固件的完整配置到原厂固件上(可自选)

  • 可使用参数自定义安装/卸载过程

  • 不支持批量操作(除非您自己写脚本)

  • 配置过程耗时

  • 不支持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.org/20.09/braiins-os_am1-s9_ssh_2020-09-07-0-e50f2a1b-20.09.tar.gz -O - | tar -xz


#更改固件解压文件夹的目录
#Antminer S9
cd ./braiins-os_am1-s9_ssh_2020-09-07-0-e50f2a1b-20.09


#创建一个虚拟环境并启用
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-0-e50f2a1b-20.09


#启用虚拟环境(如尚未启用)
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-0-e50f2a1b-20.09 && source .env/bin/activate
python3 restore2factory.py --factory-image FACTORY_IMAGE IP_ADDRESS

注: 更多关于可用参数的信息说明,可用参数 --help 查看。

用之前创建的备份的情况下

您首先需要准备Python环境,请详见 准备环境 部分的内容。

如果您在之前安装Braiins OS时创建了原厂固件的备份,您可以通过下方命令恢复这个备份(按备份ID和日期,和矿机实际IP地址替换命令中 BACKUP_ID_DATEIP_ADDRESS ):

#Antminer S9
cd ~/braiins-os_am1-s9_ssh_2020-09-07-0-e50f2a1b-20.09 && 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"

命令自动会转移您矿机的配置,您不需要作任何矿机配置上的改动。

使用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-11-27-0-5eb922d4-20.11-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 nand_install

使用矿机工具(Miner tool)通过LED灯找出矿机

使用以下命令,您就可以通过 矿机工具(Miner tool) 以让矿机LED闪烁的方式找出矿机:

#开启LED闪烁
miner fault_light on

#关闭LED闪烁
miner fault_light off

.. _miner_nightly:

使用矿机工具(Miner tool)开启/关闭预先发行版(Nightly Version)推送

预先发行版旨在最快能修复固件的一些关键问题,因此它在发布前不会像正式版那样经过全面测试。使用以下命令,您就可以通过 矿机工具(Miner tool) 开启或关闭最新的预先发行版更新推送:

#开启预先发行版推送
miner nightly_feeds on

#关闭预先发行版推送
miner nightly_feeds off

使用矿机工具(Miner tool)开启/关闭自动升级

您可以通过开启自动升级这一特性,让矿机固件自动升级到最新的系统版本。这一特性在从 原厂 固件切换到Braiins OS+时是默认 开启 的,从 Braiins OSBraiins OS+ 的旧版本升级的情况下是默认 关闭 的。使用以下命令,您就可以通过 矿机工具(Miner tool) 开启/关闭固件自动升级:

#开启自动升级
miner auto_upgrade on

#关闭自动升级
miner auto_upgrade off