从安装，到开始挖矿

先选接入方式

1. 注册一个群控账号

1. 打开 网页登录页，点击“注册账号”。
2. 填写自己的账号和密码。账号可以自定义；如果全部使用数字，至少填写 6 位。密码为 8–64 位。
3. 注册后，用同一组账号密码登录网页、本地群控或 Linux 客户端。多个矿场使用同一账号，设备就会集中到同一个列表。

平台会自动分配一个六位设备连接 ID。日常使用直接填写你注册的账号即可，不需要另记一套登录方式。

2. 下载所需软件

下面入口跟随已发布的新版安装包更新。按所选方案下载，不必把全部软件都装一遍。

本地群控支持 Windows 8 及以上，需 .NET Framework 4.5 或更高版本；新版 Windows 矿机客户端为 64 位。Linux 安装包适用于受支持的 HiveOS / Ubuntu 22.04 及兼容的 64 位系统。挖矿核心还需符合其自身的显卡、驱动和系统要求。

3A. 每个矿场通过一台本地群控接入

先让矿机出现在本地群控里

1. 在矿场选一台能够持续运行的 Windows 电脑，安装并打开本地群控。默认目录为 C:\QskgController。便携版解压后运行 qskg-controller.exe。
2. 群控电脑与矿机放在可互通的局域网，允许群控程序通过 Windows 防火墙。自动发现不可跨越路由器的网络隔离。
3. Windows 矿机：把客户端解压到简单目录，例如 C:\qswk，运行 qskg.exe。在“高级设置”中启用“自动查找群控”；查找不到时，填写本地群控电脑的 IP 并保存。
4. Linux / HiveOS 矿机：按下方的安装步骤安装客户端，打开 http://矿机IP:9999，在“系统设置”的群控连接区域填写本地群控 IP，点击“保存并连接”。
5. 回到本地群控，确认出现矿机名，刷新时间在更新。没有设备时，先按常见问题排查连接。

再把本地群控连接到网页

1. 打开本地“群控设置”，勾选“多地、异地群控”。
2. 填写第 1 步注册的账号、密码，点击旁边的“登录”。填写完不会自动登录；成功后按钮变灰并显示“已登录”。其余设置点击“确定”保存。
3. 浏览器打开 qk.qswk.net，登录同一账号，检查设备列表。
4. 其他矿场重复上述步骤，登录同一账号。可按矿场给设备分组，方便批量操作。

连接成功的标志：本地和网页都能看到设备，刷新时间正常更新。需要异地管理时，请保持本地群控运行、电脑联网。

3B. Linux / HiveOS 矿机直接接入网页

这套方式不需要额外运行 Windows 群控。安装方法与方案 A 的 Linux 矿机相同，连接设置不同。

安装 Linux 客户端

1. 在 HiveOS 的终端、远程终端或矿机本地终端，复制并执行下面这条命令。

bash -o pipefail -c 'curl -fsSL --connect-timeout 15 --max-time 60 --proto =https https://qswk.net/os/install.sh | sudo bash'

首次安装会接管挖矿：安装程序会停止原挖矿任务，并暂停 HiveOS 云端同步。安装完成后在轻松矿工设置任务；需要回到 HiveOS 时使用“交还hive”。已有客户端请优先用在线升级。

2. 等待安装完成。如果原来的远程终端断开，改用浏览器打开 http://矿机IP:9999，例如 http://192.168.1.160:9999。
3. 首次本机网页密码为 admin。登录后在“系统设置”修改网页密码。这是矿机本机密码，与平台账号密码分别设置。
4. 打开“系统设置 → 网页群控”，填写平台注册的账号密码，点击“登录并连接”。
5. 在 qk.qswk.net 登录同一账号，确认矿机出现。多台矿机分别完成安装和登录即可。

登录建立管理连接；开始挖矿和交还 HiveOS 是单独的操作。如果设备当前由 HiveOS 管理，先点“接管hive”，再下发轻松矿工任务。

本机管理网页用于可信局域网内访问，异地访问使用网页群控即可，无需把 9999 端口开放到公网。完整安装说明见客户端安装教程；新硬盘装机见自动装机教程。

4. 下发第一个挖矿任务

1. 先勾选一台测试矿机，点击“一键切换”。菜单打开后会自动获取在线币种、核心和矿池列表。
2. 选择币种或算法，再选适合设备系统、显卡的核心。Windows 和 Linux 核心不能混用。
3. 选择矿池，填写自己的钱包地址、矿工名。确认无误后应用任务。
4. 等待核心下载与启动，查看这台设备的操作结果。客户端报告成功后，再检查实际算力和矿池接收情况。
5. 单台正常后，再勾选同类设备批量下发。每台设备分别显示结果，失败时查看对应原因。

矿池与钱包怎么填

钱包是你的收款地址，必须对应所挖币种；矿池地址、端口按矿池官方说明选择。钱包管理可保存常用地址。矿工名用于区分设备，不是钱包地址。

附加参数怎么填

新手没有特殊需要可以留空。确需填写时，只使用所选核心支持的参数，避免重复设置平台已生成的钱包、矿池和设备参数。不同核心的参数不能直接照搬。

已有 HiveOS 飞行表

在“其他操作 → 飞行表”导入兼容的飞行表配置，核对币种、钱包、矿池和支持的核心，再勾选矿机下发。飞行表中的所有自定义核心和扩展项并非都能直接使用，以导入与执行结果为准。

5. 轻松矿工与 HiveOS 随时切换

交还只恢复 HiveOS 管理，不卸载客户端、不删除设置，轻松矿工客户端仍保持在线。需要时可以随时“接管hive”。在矿机自己的网页中，也可以进入“系统设置 → 挖矿管理”切换。

自动执行 hello 需要 Linux 客户端 1.7.3 或以上。若联系 HiveOS 服务器失败，查看该机日志并检查网络后重试；不要把“命令已发送”当作恢复成功。

6. 设置单卡或统一超频

1. 勾选设备，点击“一键超频”。选一台默认显示单卡界面；选多台默认显示统一设置的一行汇总。
2. 用“单卡超频 / 全部超频”按钮切换模式。单卡模式点击对应显卡旁的“设置”；统一模式点击汇总行“设置”。
3. 填写要修改的参数，留空表示不修改。应用后等待逐台结果，再检查刷新后的读数。

灰色文字显示超频方案，实时读数反映当前运行状态，两者可能不同。成功提示表示客户端执行了设置；还需观察实际频率、温度、功耗和稳定性。六项设置需使用支持的新版 NVIDIA 客户端，硬件不支持的项目以实际结果为准。

7. 更新软件与局域网共享下载

三个入口分别更新什么

• 升级矿机客户端：勾选矿机，点“一键升级”，选择对应系统的新版客户端。
• 升级 Windows 本地群控：使用群控窗口中的“检查更新”。“一键升级”是给矿机客户端升级。
• 使用新版挖矿核心：重新打开“一键切换”，在自动刷新的核心列表中选择需要的版本。

正常在线升级会保留设备身份、连接和挖矿设置。手动覆盖升级时保留配置目录，不要为了升级先卸载客户端。

怎样尽量减少公网下载

新版客户端按顺序尝试：可用的本机缓存 → 本地群控 → 局域网其他设备缓存 → 互联网下载。重启后需要下载时，会先尝试建立群控连接，再寻找局域网资源。

1. 让本地群控持续运行，矿机能正常连接它。
2. 先选一台测试矿机完成任务切换，等核心准备完成后再批量切换其他矿机。
3. 尽量让同系统的矿机使用同一核心版本，便于复用同一个包。不要频繁清理缓存。

例如 10 台矿机都需要同一个 100 MB 安装包，成功共享时，这个包的公网下载量可从约 1000 MB 减少到约 100 MB。实际还会产生状态上报、矿池通信、不同包与重试等流量；并非整个矿场的所有流量都只算一台。

下载缓慢但进度仍在更新时，可以继续等待，不必每隔两分钟重新下发。长时间没有进展，再查看设备日志与网络状态。

8. 日常查看与批量管理

• 选择范围：勾选的设备才是批量操作对象；“全选”再次点击可取消全选。执行前看清设备名和数量。
• 分组、备注与视图：按矿场或用途分组。“我的视图”保存常用的列显示、顺序和宽度，方便只看需要的信息。
• 矿工改名：修改后会同步到客户端；正在挖矿的设备需要重启挖矿核心，使新名称进入挖矿连接。
• 日志：操作记录查看逐台执行结果，维护日志查看设备维护记录。文字过长时滚动查看，或调整日志区域大小。
• 在线状态：正常在线为黑色，刚上线短暂显示绿色，超过 5 分钟没有上报显示灰色离线。网页自身的连接状态与每台矿机的在线状态是两回事。
• 一键设置：按所选设备支持的功能显示选项。不可用的系统功能不会强行下发，执行结果逐台查看。

常见问题