指南

如何在 NoxHash 创建和管理 API 密钥

安全地生成、存储、轮换并吊销 NoxHash API 密钥。分步指南,涵盖自动化与第三方集成的安全最佳实践。

Updated May 01, 2026
如何在 NoxHash 创建和管理 API 密钥

NoxHash API 密钥是一个独一无二的秘密令牌,让外部脚本、仪表盘或机器人无需共享密码即可读取您的挖矿数据并在账户上执行操作。您可在个人资料页面生成密钥,为每个密钥命名,一次性复制该秘密,并可随时吊销任何密钥。

仅显示一次,之后哈希存储 一键吊销 每个集成一个密钥
展示数字 API 密钥连接开发者笔记本与 NoxHash 挖矿仪表盘的插图

为何您可能需要 NoxHash API 密钥

大多数用户其实不需要 — 仪表盘已经实时显示余额、矿机和收益。API 密钥的用处在于:当您希望让机器(而非浏览器)与账户交互时。可以把密钥理解为一个有名称、可吊销、仅用于程序化访问的密码 — 它在不交出登录凭证的前提下为脚本完成身份验证。

自动化脚本

在夜间 cron job 中拉取 hashrate 与收益,写入自己的数据库,或在矿机掉线时触发告警。

个人仪表盘

用 Grafana、Notion 或电子表格将 NoxHash 收益与您其他的加密数据聚合在一起 — 全部只读,完全属于您。

第三方监控

为自托管的 uptime monitor、您信任的移动应用,或需要只读挖矿支付数据源的会计工具提供数据。

如果以上场景都与您无关,完全可以跳过 API 密钥。它们会带来一个需要保护的新秘密,而不使用的秘密就是多余的负担。等真正需要那天再回来生成即可。

在 NoxHash 何处找到 API 密钥

API 密钥位于个人资料页面,在安全与活动区域下方。该面板标题为 API Keys,说明为 "Manage API keys for programmatic access."。如果您从未创建过任何密钥,会看到一个小的空状态图标并显示 "No API keys created yet." — 这就是起点。

如何创建 API 密钥 — 分步指南

创建密钥大约需要 30 秒。您会为它命名、生成密钥、一次性复制秘密,然后将其粘贴到集成需要的位置。请严格按照下面五个步骤执行 — 尤其是第四步,因为您只能看到完整秘密一次。

1

打开个人资料并滚动到 API Keys

点击右上角头像,选择个人资料,向下滚动直到看到 API Keys 面板。它靠近页面底部,就在账户注销区域的上方。

2

输入描述明确的 Key Name

Key Name 字段用于之后在列表中识别该密钥。请使用具体名称,如 laptop-hashrate-logger 或 notion-earnings-sync。用 "test" 或 "app" 这样的泛名,日后轮换时就成了猜谜游戏。

3

按下 Generate New Key

点击绿色的 Generate New Key 按钮。NoxHash 会立即生成密钥并显示绿色横幅:"Key created. Copy it now — it won't be shown again."。横幅中会在等宽代码块里显示完整的密钥字符串。

4

立即复制密钥

点击代码块旁的 Copy 按钮。屏幕会提示 "Copied!" 确认操作完成。这是您唯一一次能看到完整秘密的机会 — 之后 NoxHash 只保存哈希,一旦丢失,唯一的办法就是吊销并重新生成。

5

粘贴到您的密钥库中

直接将复制的值粘贴到密码管理器(1Password、Bitwarden)、一个被 git-ignored 的 .env 文件,或 CI/CD 的密钥保险库。切勿粘贴到 Slack、Discord、工单或截图中 — 那是最常见的泄露路径。

以安全方式命名、存储与轮换密钥

密钥一旦复制完成,剩下的风险大多来自人为因素。您如何命名、存储与轮换密钥,决定了未来一次失误是只损失几分钟,还是丢掉比特币。美国网络安全和基础设施安全局(CISA)将 API token 视同强密码对待 — 长、唯一、不跨服务复用。

每个集成一个密钥

切勿让两个脚本共用同一个密钥。一旦其中之一泄露,您可以只吊销该集成,而不影响其他集成。

存入 secret manager

密码管理器和 CI 保险库会对静态秘密加密,避免它们留在 shell 历史里。桌面上的纯文本文件不叫存储 — 那叫明信片。

按计划轮换

每 60–90 天吊销并重新生成密钥,设备丢失、出售或疑似被入侵后也应立即轮换。Last Used 一列帮助您发现可安全退役的闲置密钥。

绝不提交到 Git

公开仓库泄露是 API token 外泄的头号来源。请使用 .gitignore,借助 git-secrets 等扫描工具,一旦漏出立即吊销。

管理现有密钥

您创建过的每个密钥都会显示在一个有四列的表格中:Key Name、prefix(秘密的前几个字符 — 其余已哈希)、Last Used,以及创建日期。红色的 Revoke 操作位于每一行的右侧。

列 告诉您什么 如何使用
Key Name 哪个集成拥有它 吊销前将名称与对应的脚本或仪表盘核对清楚。
Key (prefix) 秘密的前几个公开字符 用来与保险库中存储的值交叉比对。
Last Used 最近一次 API 请求时间(或 "Never") 处于休眠的密钥("Never" 或几个月未动)是吊销的首选候选。
Date 密钥创建时间 用来驱动您 60–90 天的轮换排程。
Revoke 即时且永久的禁用 一键点击,密钥作废。任何使用它的脚本将立即停止工作。

要吊销某个密钥,找到其所在行,点击红色的 Revoke 操作并确认。吊销是即时且不可逆的。如果该密钥正在为一个线上脚本服务,脚本会在下一次请求时立即返回身份验证错误 — 当发生泄露时,这正是您所期望的。

5 步 · 一次性复制 · 随时吊销

安全地生成您的第一个密钥

您已看过完整的创建与管理流程。请在新标签页打开 NoxHash,前往个人资料,在密码管理器就绪的前提下按五步操作以捕获秘密。

创建您的 NoxHash 账户 探索 NoxHash
展示多个有名称的 API 密钥安全存储于数字保险库中的插图

应避免的 API 密钥常见错误

OWASP 项目每年都会发布 API Security Top 10 — 每年,泄露或处理不当的身份验证令牌都排在前列。您的 NoxHash 密钥并无例外。以下是在现实中造成损失最严重的四种错误:

  1. 把密钥贴在公开聊天或论坛里。Discord、Telegram、Reddit、GitHub issues,以及 "请帮我 debug" 的截图都足够公开,足以算作泄露。机器人会在数秒内自动爬取这些渠道寻找活跃密钥。
  2. 把秘密提交到版本控制。即便是私有仓库,之后也可能转为公开,或者被克隆到一台已经被入侵的笔记本上。请使用 .env + .gitignore,并对每次提交运行秘密扫描器。
  3. 在客户端应用中硬编码密钥。任何发送到浏览器、移动 App 或桌面二进制文件中的内容都等同于公开 — 逆向工程只需几分钟。应改为通过您自己的服务器中转 API 调用。
  4. 密钥停用很久仍未清理。Last Used 这一列正是为此而存在。如果一个密钥一个月后仍显示 Never,或连续 90 天未被触碰,就应吊销它。

好消息是:一旦上述任何一种情况发生,恢复方式都是同一套、同样快 — 吊销密钥、生成新密钥、更新集成即可。不需要重置密码,不用提工单,也不会丢失 BTC,除非该密钥授权的操作已经完成。

常见问题

仅仅正常使用 NoxHash,我需要 API 密钥吗?

不需要。网页仪表盘已实时显示您的余额、矿机和收益。只有当您希望接入外部脚本、仪表盘或监控工具时,才需要 API 密钥。大多数用户从不创建密钥 — 这完全没问题。

如果我弄丢了忘记保存的 API 密钥,会怎样?

NoxHash 仅保存密钥的哈希,因此任何人 — 包括您和客服 — 都无法还原原始秘密。请吊销丢失的密钥以将其禁用,并生成一个新的。用新值更新集成,一分钟内即可恢复运行。

我最多可以创建多少个 API 密钥?

您可以按需要创建任意数量。我们建议每个独立集成使用一个密钥 — 例如,服务器 cron job、Notion 仪表盘和本地测试脚本各用一个密钥。这样一次泄露不会迫使您一次轮换所有密钥。

吊销密钥会影响我的挖矿或钱包吗?

不会。吊销密钥仅会停止使用它的外部请求。您的矿机继续运行,BTC 余额保持不变,仍可用邮箱和密码照常登录。只有持有已吊销密钥的脚本会失效。

仅凭 API 密钥,有人能盗走我的 BTC 吗?

泄露的密钥是严重的安全事件 — 请按严重事件对待。只要您怀疑被曝光,就立即在个人资料中吊销它,然后生成替代密钥。结合登录的 2FA,迅速吊销是在造成损失之前将攻击者挡在门外的最快办法。

我应该多久轮换一次 API 密钥?

一个良好的基线是每 60 到 90 天一次,任何曾经持有密钥的笔记本或手机丢失、出售或被怀疑入侵时也应立刻轮换。Last Used 一列很有用:如果某个密钥数周未被触碰,就吊销它 — 活跃集成随时都能轻松重新生成。

安全提示,非投资建议

本指南仅涵盖 NoxHash API 密钥的创建与安全卫生。API 密钥授予账户访问权限 — 请以对待任何加密凭证同样的谨慎态度来处理它们。云挖矿涉及市场风险:Bitcoin 收益取决于波动的 BTC 价格与网络难度。仅投入您可承受损失的资金,并就本地相关问题咨询所在司法辖区的税务或法律顾问。