## 开始挖矿

1. **选币种**：下拉里有什么就支持什么。
2. **选矿池**：HeroMiners、Kryptex、LuckyPool、PEARLSKI、PearlFortune、PearlHash、F2Pool。先选矿池，客户端会自动筛掉它用不了的内核。
3. **填钱包 / 用户名**：按该矿池的规则填。Kryptex 用户名或钱包都行；F2Pool 只认账号名（矿池后台右上角那个），不是钱包地址；其余矿池填钱包。
4. **选内核**：默认「自动选择系统推荐版本」，用我们推荐的版本（新版本先上架供手动选择，确认稳定后才改为推荐）；想用最新版本或固定某个版本，就在「内核版本」下拉里自己选。第一次用到才下载，下完自动校验，不用手工放文件。
5. **连接方式**：默认直连 TCP；矿池有兼容 TLS 节点时才提供直连 TLS。节点按所选 TCP/TLS 传输筛选；“自动选择”在当前币种和矿池的可用官方及自定义节点中择优，也可手选首选节点。恢复时保留该选择，实际节点另行显示。
6. **自己的代理（仅直连 TCP/TLS 有效）**：先启动代理软件，再填写它的实际本机端口，例如 `http://127.0.0.1:7897` 或 `socks5://127.0.0.1:1080`。端口以你的软件为准，不填订阅链接。
7. **中转**：节点框保留原位并灰显，不使用上面的代理；连接失败时可使用可用的备用连接。
8. **自定义内核（可选）**：仅支持 WildRig、PeakMiner、OneZeroMiner、SRBMiner 四个已兼容家族。选择对应类型，在完整解压的目录中选择主程序（`wildrig.exe`、`peakminer.exe`、`onezerominer.exe` 或 `SRBMiner-MULTI.exe`）；程序会验证内核身份，导入后请做兼容性测试。 主程序改过文件名也可以导入，文件内容须与所选内核一致。
9. **点「开始」**。

- **显卡**：`all` 是全部显卡，也可以只填 `0` 或 `0,1,2`。
- **矿机名**：可自定义前缀，或点随机后缀按钮；留空用本机名。

> 「停止」结束内核并清理状态。


## 连接模式与自有代理

已保存的连接选择保持不变；从没有模式选择的旧版升级时，初始使用中转。

- **连接方式**：默认直连 TCP；矿池有兼容 TLS 节点时才提供直连 TLS。节点按所选 TCP/TLS 传输筛选；“自动选择”在当前币种和矿池的可用官方及自定义节点中择优，也可手选首选节点。恢复时保留该选择，实际节点另行显示。
- **自己的代理（仅直连 TCP/TLS 有效）**：先启动代理软件，再填写它的实际本机端口，例如 `http://127.0.0.1:7897` 或 `socks5://127.0.0.1:1080`。端口以你的软件为准，不填订阅链接。
- **中转**：节点框保留原位并灰显，不使用上面的代理；连接失败时可使用可用的备用连接。

**网络恢复**：临时断网、连接超时或连接被重置会持续自动重试，逐步延长等待并限制最长间隔，不会因为重试两次就停挖。挖矿进程还在运行时由它自行重连，只有进程真正退出或启动暂时失败时才重新启动。直连保留所选节点和自有代理，不会擅自切成 中转 或换矿池；中转 连续连接失败时，可使用可用的备用连接。手动停止、网吧让位、定时休息、退出或版本更新会取消待执行的恢复。显卡故障、永久拒绝登录、缺文件及无效参数仍受故障停止保护，不会无限重启。首次启动仍须通过验证；运行中心跳或验证服务暂时不可达不会中断已有挖矿任务。

已下载的有效内核及自定义版本会保留在客户端目录中，更新客户端后仍可复用；选择版本时仍须满足当前兼容要求。自定义导入会完整复制到 downloads 目录，成功后不再依赖原文件夹。请保留 downloads 及旧的 custom-kernels 目录。空间不足时先自行整理磁盘再重试；无法完整保留文件时，本次更新不会替换原安装。

## 自定义内核版本

仅支持 WildRig、PeakMiner、OneZeroMiner、SRBMiner。先下载并完整解压到任意文件夹，在“挖矿软件”选择对应类型，然后点击旁边的“自定义…”并选择主程序：wildrig.exe、peakminer.exe、onezerominer.exe 或 SRBMiner-MULTI.exe。保留整个文件夹及依赖文件，选择主程序后软件会自动复制整个目录。程序会检查内核类型；类型不符或无法识别时不启用。导入后请先进行兼容性测试。取消勾选“使用自定义版本”即可切回官方版本。 主程序改过文件名也可以导入，文件内容须与所选内核一致。

## 首页能看到什么

- 总算力、份额、矿池余额、已支付、币价；每张显卡单独显示算力、温度、功耗。
- **悬浮窗**：窗口顶部打开「悬浮窗」，桌面上一个小窗显示算力、份额、温度、功耗。
- **矿池网站**：用当前填的钱包直达该矿池的查询页，不用复制粘贴。
- **相关网站**：各矿池官网、区块浏览器等入口。
- 行情或矿池接口临时抽风时相关数字显示 N/A，后台自动重试，不影响挖矿。

> 份额以矿池后台入账为准。客户端是本机口径，会因动态难度、统计窗口、拒绝／过期份额和后台延迟与矿池数字有出入。

## 算力 & 群控

建议注册并登录群控：没登录时右上角是金色的「注册 / 登录群控」按钮，点它就能注册。

注册一个账号（用户名 + 密码 + 邮箱），登录后本机自动归到你名下；再用同一账号登录网页控制台，就能看到名下所有机器。

普通模式下，登录仅在本机有效。制作网吧母盘时，请先开启网吧模式，再登录群控。网吧模式的登录可随 Vminer 文件夹复制到分机。开启或关闭网吧模式后，新的登录方式在下次登录时生效。客户端退出只结束本机登录。如需撤销共享登录，请在群控网页管理登录会话。

新网吧或新增客户机使用新版时，先在母盘开启网吧模式并登录群控，再同步 Vminer 文件夹。先启动两台客户机，在待机时确认它们分别出现在群控中，并核对命令回执。需要停止这份母盘登记更多设备时，在群控账号的登录设备列表选择「停止新增网吧设备」。已登记设备保持连接。

- **看**：在线状态、算力、份额、温度、功耗、显卡型号。
- **管**：远程开停挖矿、重启内核、换币种／矿池／内核／钱包、改功耗风扇超频、改名、重启、关机。
- 一台机器只属于一个账号；命令排队下发，机器在线才执行。
- 网页上还能看收益；右上角铃铛有新公告会亮红点。
- **关机能远程，开机不行** —— 关了要人去现场开。

> 邮箱是找回密码的唯一途径，注册时填能收信的。

**更改配置**：在单机功能清单中，或勾选批量目标后点击“更改配置…”。支持完整配置时，可一次设置矿工名、币种、矿池、内核及版本、连接方式、直连节点、钱包或用户名。单机或只选一台时显示现有设置；批量相同字段显示共同值，不同字段显示“多种配置”，可展开查看各台当前配置。仅编辑过的字段才下发。 完整表单中显式修改矿工名会设为固定完整名称，不再追加原前缀或随机后缀；未改名则保留原命名规则。

更改币种或矿池时，兼容的现有或手选内核及合法版本保持不变；只有未选或不兼容时，才从最终池表合法候选中按 PeakMiner → SRBMiner → OZM（onezerominer）补默认。下拉候选按同一顺序，其他合法项保持原序；只有 WildRig 可用的矿池使用 WildRig。内核变化或版本不合法时才回到系统推荐。原自动选择保持自动，实际内核仍须匹配最终矿池。软件和版本只能选择最终组合支持的项目，显式非法组合不下发。“自动选择系统推荐版本”不等于最新版本。中转 的节点框保留原位并灰显，不可选择；同池切回直连保留节点记忆，换池后无效节点改为最终池的有效默认选项，不改变本机自有代理设置。目标矿池身份格式不合时，钱包或用户名框变红并禁用“应用”；修正合法后才可提交。

钱包或用户名仅回填可核实的当前值；未同步时明确提示，不猜测旧值。未编辑不下发；明确输入替换值需核对收益去向。切入或切出 F2Pool 时，必须填写目标矿池的用户名或钱包，不能默认沿用另一池身份。客户端校验最终组合后才保存；待机只保存，不自动开挖，运行中至多切换一次。

单机和批量均从“更改配置…”进入。支持完整配置时显示完整表单；否则在同一窗口选择一个修改项目。同时修改多项，请从官网下载最新完整安装包。混合批量的完整表单只向支持的设备下发；“单项修改…”操作其余目标。单项方式沿用客户端既有命名和身份规则，不自动组合钱包与换池、换币命令。取消不下发；入队不表示执行成功，请查看回执及随后上报状态。

**直连自动选点与恢复**：节点选“自动选择”（空选项）时，会在当前币种和矿池的官方节点及已保存自定义节点中选择可用、低延迟的线路；手选节点仍保存为首选，暂不可用时可使用同池其他节点，恢复过程不改写已保存的选择。官方节点更新不会删除自定义节点。所有节点暂不可达时持续退避重试，恢复可用后自动重新连接；健康连接不会仅因探测波动被重启。界面分别显示实际节点、连接/矿池数据/用户份额状态及最近切换原因，探测连通不等于挖矿或份额已恢复。中转 下节点框仍在原位灰显；自有代理只用于直连。手动停止、网吧让位和休息优先，恢复探测不会擅自开挖。群控将节点设为自动时使用客户端支持的自动行为；不支持新能力的客户端沿用既有操作。 同一币种与矿池最多保存 64 个有效自定义候选，传递列表上限为 32 KiB；完整启动参数还受 Windows 安全长度限制。添加或启动超限时会明确提示并保留原数据，请先删除不用的节点或精简过长配置。

**LAN 下载与分批更新**：局域网协调、邻居发现与传入文件校验会自动进行，但 LAN 文件分发本身不代表自动升级；安装仍遵循更新开关或手动命令。群控“分批更新”会安排预下载，可选“全部下好后统一安装”或“谁下好谁安装”，并可查看任务进度、停止尚未安装的后续更新。网吧客户机不自动更新；请手动更新母盘，再按无盘系统流程同步镜像。 局域网协调暂不可用时，仍会尝试通过广播发现邻居，必要时从服务器下载；这条提示不是矿池断线或停止挖矿的通知。 网吧模式默认参与局域网分发。只要局域网内有可用的分享机器，下载会优先等待；每台机器同时只向一台邻居分享已校验的文件。没有可用来源或等待超时后，才从服务器下载。机器需保持 Vminer 运行，并允许防火墙及设备互通。分发在后台运行，网吧让位和手动停止仍照常。

## 网吧模式

机器闲着的时候挖矿，有人上机自动让位，客人用起来跟平时一样。

> **记得注册并登录群控**:点右上角「注册 / 登录群控」。先在母盘机上开启网吧模式，再登录一次,克隆出去的每台机器都自动归到你名下,手机上就能看全场算力、远程开停;**手动模式要靠群控唤醒,必须登录**。

- **全力**：一直挖，适合没人用的纯矿机。
- **规避（默认）**：全机范围检查规避名单中的进程，即使它们在后台。名单进程退出并连续空闲 1 分钟后才恢复。
- **灵敏**：检测到键盘或鼠标活动会让位。其他程序的显卡 3D 占用连续两次超过 20% 也会让位。两个条件连续 2 分钟都未触发后才恢复。
- **手动**：开机隐藏、不自动挖，由网页控制台唤醒或在本机点「开始」才挖；挖起来后不再让位，直到关机或手动停止。
- **需要管理员**：请右键 Vminer，选择「以管理员身份运行」。
- **功耗与超频**：功耗、风扇、核心和显存偏移及锁频在「OC超频」页设置。让位时，Vminer 将它尝试设置的项目恢复为硬件默认值，即使此时 OC 开关已关闭。未由 Vminer 设置的项目不受影响。恢复默认失败时会继续重试，完成前暂停挖矿。保存的参数会保留，恢复挖矿时重新应用符合当前设置的参数。

> 无盘网吧：在一台机器上设好，把整个 Vminer 文件夹放进母盘，其它机器开机即用同一套配置。

开着网吧模式时不能用定时挖矿。

## 功耗、风扇与超频

在「OC超频」页，总开关控制功耗、风扇以及核心和显存频率。关闭后不再应用新的 OC 参数。此前由 Vminer 设置的项目仍可按需要恢复默认。

- **功耗**：可以一个值管所有卡，也可以逐卡单独设。降到 70~80% 通常算力掉得很少，温度和电费明显下降。
- **风扇**：固定转速或交给驱动自动。
- **核心 / 显存四项**：核心频率（在挖矿默频上加减，例如「默频+50」）、核心偏移（出厂频率整体加减）、显存频率（锁在一个档位，例如 810，先开挖看状态栏能不能锁上；显示器插在这张卡上会锁不稳，请插到核显并重启电脑）、显存偏移（显存整体加减）。默认关闭，属于高级功能，只在挖矿时生效。每次改动有 10 分钟试用期，期间掉卡、驱动重置、算力归零或过热会自动恢复原值；通过后再看护 1 小时挖矿时间，显卡卡死（满功耗却没算力、挖矿内核自己退出）也会自动撤回这一档。

> 打开「启用 OC超频」需要以管理员身份运行 Vminer。

## 系统设置

每张卡片的说明在标题旁的「?」里，鼠标移上去就显示。

- **自动无感更新**：更新下好并校验后自动重启生效。
- **故障自动重启**：挖矿出现故障、重启挖矿内核也恢复不了时，自动重启软件（挖矿后台无响应）或电脑（显卡掉驱动、卡死），重启后自动接着挖；重启电脑前有 60 秒可以取消。显卡不支持、虚拟内存不足等重启解决不了的情况不会重启，而是停止挖矿并提示原因。
- **持续运行后休息 5 分钟**：连续挖满 24 或 48 小时休息 5 分钟，然后自动恢复。
- **定时挖矿**：按本机时间每天几点开始、几点停止，24 小时制，小时和分钟分开填。停止时间保持「-」就是开始后一直挖。时间段内手动停了会尊重，等第二天开始时间再开。
- **一键放行 Vminer**：杀毒软件误删内核时用。

## 下载与更新

- 安装包不带内核，内核在第一次选用时才下载，所以包很小。
- 下载有主备线路，一条失败自动换另一条，并校验文件大小和哈希。
- 非网吧模式下，客户端自动更新默认开启；网吧模式不支持客户端自动更新。内核下载独立，不受此限制。

## 注意事项

- 杀毒软件误删内核时，用系统设置里的「一键放行 Vminer」把程序目录加进白名单；360、火绒等第三方杀软需要在它自己那边再加一次。
- 日志只显示与你有关的内容：本地服务、内核下载、矿池连接、份额结果和故障。本地的临时小错误不会标红刷屏。
- 与服务器的心跳临时不通时会提示「挖矿继续、后台重连」，不会因为一次失败就停挖。
- 请确认设备适合长时间高负载运行，注意功耗、温度和供电。
- 收益、矿池稳定性和第三方网络服务由对应提供方决定。


## 自定义矿池节点

直连 TCP 只显示 TCP 节点；矿池公布了可用 TLS 节点时，才提供直连 TLS，并只显示 TLS 节点。两种直连都支持自定义节点和自己的代理。选池后点击节点旁的“添加…”，填写当前矿池节点或自定义同池中转地址的域名/IP和端口。TLS 须通过证书校验；使用 IP 时可填写证书域名，留空则要求证书支持该 IP。添加并选择后会保存，删除仅影响自定义条目。自动选择在同池、同传输节点中探测选点；全部不可达时持续重试，恢复后自动继续，不悄悄切换 TCP/TLS。自定义节点故障后实际改用矿池备用节点会在日志提醒，探测成功不等于已恢复挖矿。中转模式的节点框保留原位、灰显不可选，不使用自己的代理设置。手动停止、网吧让位和休息始终优先；修改节点前先停止挖矿。


## 后台更新检查

挖矿时会在后台检查内核和组件更新。检查失败会继续使用当前版本，不会因此停止挖矿，稍后会自动重试。只有确实下载文件时才显示下载进度。自定义内核不会被官方版本覆盖。


开启网吧模式后，不支持自动更新。请手动更新母盘镜像中的客户端版本；也可以在群控找到母盘对应的固定矿工名，点击手动更新。

<!-- update-cache-guide:begin -->

已下载的安装包会保留。重启 Vminer 后，会先取得当前更新信息，再复用安装包并按更新设置或手动操作安装。网络暂不可用时继续运行当前版本。

<!-- update-cache-guide:end -->

## 矿机归属与钱包整体收益

矿机、在线数、算力和份额按当前归属统计。收益区只查询账号明确绑定的钱包，每种币只绑定一个收款钱包；设置页会拒绝重复地址。默认钱包继续用于配置预填。收益包含绑定钱包的历史记录和其他机器贡献，不代表名下矿机独立收益。非绑定钱包的机器会标注“非绑定钱包，未纳入统计”，但仍计入名下机器及算力。钱包信息缺失时显示待确认，不猜测。F2Pool 仍需绑定对应只读账号。添加、移除钱包或转移矿机归属都不会自动修改挖矿钱包。

## 规避名单名称

内置名单按“英文简称／当前语言名称”显示，例如 LOL/英雄联盟。切换客户端语言后重新打开名单即可查看；可以搜索简称、当前语言名称或进程名。缺少译名时显示英文，相同简称不重复显示。勾选规则不变，自己添加的名称和程序保持原样。

在账户管理的“收款钱包”中可另行绑定一个 krx 开头的 Kryptex 挖矿用户名。该绑定只用于配置选择，不计入收益统计，也不自动修改矿机。更改配置时，钱包栏右侧下拉可选择已绑定身份，也可直接填写：Kryptex 支持当前币种钱包或 K 池用户名；F2Pool 只接受矿池用户名，可直接填写，也可从下拉选用已绑定的用户名；其他矿池只支持当前币种的钱包。批量列表仅展示对所有目标都有效的绑定。选择后仍须点击应用并确认。 在「账户管理 → 收款钱包 → F2Pool」分别设置挖矿用户名和收益只读链接。

一台矿机只属于一个账号。未认领的矿机可在客户端登录后加入；已属于其他账号时，请先由当前主人在群控网页转移，再登录接收账号。仅换账号登录不会转移已有归属，也不会改变挖矿钱包或停止挖矿。

## 云 OC 参数

在群控超频页点“编辑并保存…”填写各卡参数。参数按设备保存，改名不影响。用主面板的复选框启用或关闭云 OC，并确认一次。挖矿中的兼容客户端会重启一次挖矿内核来切换。让位中的矿机会在恢复挖矿时切换，其余无法立即切换的矿机会在下次开始挖矿时切换。挖矿中请以客户端回报的勾选状态为准。

矿机正在使用云 OC 挖矿时，保存后可选择重启一次内核并应用新参数。选“否”只保存，不重启。启用云 OC 后，下次开始挖矿会读取已保存的参数。普通和网吧模式均可使用，需以管理员运行，在本机开启 OC 和手动功耗与风扇控制。调频还需开启高级开关。 在群控的设备面板或本机开启「频率偏移(高级)」。若云 OC 正在运行，此操作只保存开关，云 OC 频率参数在下次启动内核时应用。

停止或退出后，本功能写入的功耗、风扇、核心／显存偏移及锁频恢复默认，本机原有保存值保留。恢复未完成时会保留记录并继续重试，不叠加新云参数。暂时取不到云设置时挖矿继续，请查看群控中的实际应用状态；保存成功不等于已经应用。设备换归属后不继承原主人的云参数。

<!-- connection-recovery-guide:begin -->

## 自动恢复连接与通知

中转模式连接失败后，Vminer 会尝试恢复。暂时无法连接时会持续重试，恢复后保持可用连接。手动停止、网吧让位和定时休息优先。

恢复时会继续使用当前矿池，保存的连接设置不会改变。

在群控“我的账户→线路恢复通知”中启用提醒，并绑定Telegram和验证邮箱。首次全部失败和后续恢复时发送结果，重复重试不重复提醒。通知延迟或发送失败不影响继续连接；未绑定的渠道不发送。自动恢复须由服务器允许。

升级后保留现有账号和矿机归属，原有功能无需重新认领。新增功能以当前页面的可用项为准。若操作显示“结果待确认”，请先核对矿机实际状态，再决定是否重试。结果待确认的操作不会自动重复。

群控账号页显示已验证设备数量。待验证设备可在客户端群控页点击“验证本机”，输入当前账号密码；设备归属不变，无需重新认领。保存配置不代表设备已应用，旧群控继续可用。

<!-- connection-recovery-guide:end -->

<!-- account-allocation-guide:begin -->

## 子账号算力转移

在群控“我的账户→子账号算力转移”中设置一个分配对象，比例为0–15%。只作用于当前账号名下、支持该功能的矿机。0%或关闭开关表示停用；不支持的客户端或矿池组合不执行分配，正常挖矿继续。 勾选启用并设置大于 0% 的比例后，才会转移算力。

按币种为分配对象填写收款钱包，也可选用已有绑定作为建议。这里独立保存，不占本账号的收益钱包名额，也不改变首页使用的收益钱包绑定。未填写的币种不分配。Kryptex可填写该对象的挖矿用户名，填写后优先使用用户名；F2Pool使用用户名，如需该对象在F2Pool收款，请填写其F2Pool用户名，留空时使用默认收款配置。与这台矿机当前实际收款钱包或矿池用户名相同时，不执行分配。

保存或移除时需要再次输入账户密码，核对名称、比例和全部收款身份后确认。保存成功不表示矿机已经应用，请查看设备的实际状态；临时网络故障不停止正常挖矿。更换矿机归属后，原主人的分配配置不再适用。

<!-- account-allocation-guide:end -->
