NOXC · SERVICE DOCUMENTATION
Noxc 服务文档
关于这套软件的全部说明:它能做什么、怎么申请子域名、DNS 记录怎么管、怎样把名字委派给 DNSHE。按站点实际功能写,也如实写出还不完善的地方。
关于 Noxc
Noxc 是一套跑在 Cloudflare Workers + D1 上的二级域名分发与 DNS 管理系统:把一个根域名切成很多可申请的子域名,审核通过后把该名字的 DNS 管理权交还给申请人。
它只负责「名字 + 解析记录」,不托管网站内容、不提供 SLA、也不是通用顶级域注册商。这一点写在最前面,免得后面产生误会。
正式更名为 Noxc,首推 noxc.uk:它排在后缀选择器第一位并标注「首推」。主域名仍是 meoy.top —— ROOT_DOMAIN 与默认 Cloudflare Zone 都没变,首推不需要更换 Zone ID,也不用重配主域名;其余已配置后缀仍可正常选用。
申请与审核
名称可用性检查、AI 审核、待审每小时复核、邮箱白名单与第三方邮箱申请、提交注册时的滑块拼图验证。
DNS 管理
A / AAAA / CNAME / MX / TXT / NS 等记录可增删改,附 Vercel、Netlify、Cloudflare Pages、GitHub Pages、DNSHE 一键模板。
账号体系
邮箱注册、NodeLoc OAuth、用户配额、签到积分、域名转移、工单、WHOIS 查询、滥用举报、中英双语。
技术构成
全栈 TypeScript:控制台是 React 18 + Vite,接口层是 Cloudflare Workers 上的 Hono,数据存 D1、头像存 R2。仓库里不跟踪任何 .html 源文件 —— SPA 外壳、两个根域名落地页、以及你正在看的这一页,都由 TypeScript 模板输出。
视觉语言来自 Noxc 主 logo:冷白底、近黑几何无衬线、一颗 Noxc 蓝点、圆头节点线条与点阵底纹,以及只在真正跳转时出现的 Miku 过渡动画(刷新不播)。
快速开始
从新账号到一条生效的解析记录,一共五步。
- 用允许的邮箱注册,或用 NodeLoc 登录。已登录时首页顶栏会直接显示「→ 去往控制台」,不再出现登录按钮。
- 邮箱不在允许范围?注册页有「申请使用此邮箱注册」入口,填邮箱与理由提交;管理员在后台通过后,该邮箱会自动加入白名单。
- 进入注册页检查名称是否可用,点提交注册。滑块拼图只在提交后以弹窗出现,通过后自动接着提交,不会卡在「子域名不存在」的循环里。
- 提交即刻跑一次 AI 审核,待审申请每小时还会复核一次;通过后名字出现在「我的域名」。
- 打开「DNS 记录」添加 A / CNAME / MX 等,或用一键模板;把整个名字交给第三方解析,见第 05 节。
系统保留名称(ai / dash / nic 等)普通用户不可申请;管理员仍可手动开通,且后台设置无法删掉这份基线名单。
账号与额度
每个用户的可申请数量由「站点设置 → 新用户默认配额」决定:-1 不限量、0 禁止申请、默认 5。勾选「一键同步」会覆盖已有普通用户,管理员始终不限量;用户列表里也能单独给某个人改,或「填入全局默认」。
绑定 NodeLoc 账号会一次性增加 5 个配额;解绑再绑、换号、重复回调都不会叠加。首次用 NodeLoc 登录建号与旧账号补领同样发放,管理员与不限量账号跳过。
NodeLoc 资料只读取 email;对方没给 id 时用邮箱派生稳定标识。第三方邮箱不会被用来冒领已有本地账号。
其余配套:签到积分与奖励中心、域名转移、工单系统、个人资料与头像、通知中心、滥用举报。
修改密码不再需要原密码:验证码发到当前账号绑定的邮箱(独立的 password_change 场景),6 位、10 分钟有效、一次性;校验通过才写入新密码,并踢掉其它设备的登录状态。占位邮箱或 .local / .test 等保留 TLD 收不到信,会提示先在个人资料里更换邮箱。
DNS 记录
每个已开通的名字都有独立记录列表;所有记录类型共用同一套校验、TTL 选项与可编辑表格。
NS 记录也是普通 DNS 记录:添加后出现在同一张列表里,能编辑、能删除,不存在另一套「托管表」或独立接口。把子域名交给第三方解析,本质就是在父区写两条 NS。
常用模板:Vercel CNAME、Netlify CNAME、Cloudflare Pages、GitHub Pages A、www 别名、SPF 拒绝全部、DMARC 拒绝、DNSHE 托管 NS。重复点不会生成重复记录。
WHOIS 查询、服务条款、滥用举报均公开,不需要登录。
服务文档 · DNSHE 托管接入
把 Noxc 子域名交给 DNSHE 解析,以 ksdk.noxc.uk 为例;下面 8 张图与文内编号一一对应。
托管 = 在父区(Noxc)写两条 NS 记录,把解析权交出去;之后该名字下所有 A / AAAA / CNAME / MX / TXT 都在 DNSHE 里管。
两套 NS 别搞混(最容易错的地方)
| 用途 | 正确的 NS |
|---|---|
| 从 Noxc 等外部把域名「添加」进 DNSHE DNS Management 托管 | ns1.dnshe.org / ns2.dnshe.org |
| 直接在 DNSHE 注册的域名自带的 NS 伺服器 | ns1.dnshe.com / ns2.dnshe.com |
ns1.dnshe.com / ns2.dnshe.com 专属于在 DNSHE 注册的域名,不适用于从 Noxc 委派出去的子域名。本文全流程只用 .org:图 6(Noxc 写入)与图 7(DNSHE 分配)都是它。api005.dnshe.com 之类是 API / 控制台网关,不是权威 NS,别填进记录里。
顺序别反:先在 DNSHE 加域名拿到 NS → 再去父区写 NS → 最后回 DNSHE 加记录。
DNSHE 侧添加域名
左侧菜单点「DNS 解析」(进入 DNS Management,标了 Free),右侧点 Add domain。旁边的 API keys、Activity log 本次用不到。



ksdk.noxc.uk;不要带 https://、路径或末尾斜杠,然后点右下角 Add domain。拿到分配的 NS(先看图 7)
创建后弹出 New domain setup,步骤条为 1. Add domain(已完成)→ 2. Add DNS records(当前)→ 3. Update nameservers;正文列出 ns1.dnshe.org / ns2.dnshe.org,右侧有 Copy、Copy all。黄色提示「尚未检测到 NS 变更」是正常的,改完等一会儿再复查。
注意:步骤条里的 Update nameservers 指「到上级去改 NS」,对 Noxc 用户就是下面第 3 步的一键模板,不是在 DNSHE 里改。先别点底部任何按钮,切到 Noxc 把 NS 写进去再回来。

.org NS + 底部三个按钮(Check again / Add DNS records / Cancel)Noxc 侧写入 NS 记录
域名管理 →「我的域名」,找到该名字(此时记录数为 0),点右侧「DNS 记录」;页面下方「常用模板」点「DNSHE 托管 NS(一键)」,重复点不会生成重复记录。列表出现两条 NS,每行都有「编辑 / 删除」—— 核对值是 .org 不是 .com、两条都在且状态正常。



ksdk.noxc.uk、值分别为 ns1.dnshe.org / ns2.dnshe.org,TTL 自动、状态正常图 7 → 图 8 的关键一步
回到 New domain setup 弹窗(若已关掉,在域名列表该行点 Manage → 重新进入)。底部三个按钮作用完全不同:
| 按钮 | 作用 | 会不会跳到图 8 |
|---|---|---|
Check again | 重新检测父区 NS 是否已生效 | 否 只原地刷新那句黄色提示 |
Add DNS records | 进入该域名的 DNS records 管理页 | 是 就是它 |
Cancel | 关闭引导,回域名列表 | 否 |
必须点中间蓝色的 Add DNS records,才会看到图 8 的界面。点 Check again 只会重新检测、不会跳转;点 Cancel 直接退出引导。记住:图 7 是「给你 NS、让你去改 NS」,图 8 是「进来加记录」,中间那座桥就是 Add DNS records。

生效与验证
- 回图 7 点 Check again,黄色提示消失即代表 DNSHE 检测到委派。
- DNS 传播通常几分钟,最长可能到 24–48 小时;期间别反复删改。
- 生效后,该名字下的所有记录以 DNSHE 图 8 页面为准,Noxc 里那两条 NS 不再管具体解析。
- 验证:
dig ksdk.noxc.uk NS看是否返回ns1/ns2.dnshe.org,再dig <主机名> A看预期 IP。
常见误区 / 排错
| 现象 | 原因 / 处理 |
|---|---|
写成 ns1.dnshe.com / ns2.dnshe.com | 那是 DNSHE 自家注册域名专用 NS;托管一律改回 .org,在图 6 直接「编辑」 |
把 api005.dnshe.com 当 NS | 那是 API 网关,不是权威 NS |
旧版「托管到 DNSHE」已写入 .com | 到「DNS 记录」把两条编辑成 .org,或删除后重点一键模板;已写入的旧值不会自动改 |
Check again 一直不通过 | 核对图 6 两条都在、拼写无误、状态正常,再等传播 |
| 图 8 显示 0 records | 正常,点 Add the first DNS record |
| 找不到图 7 弹窗 | 域名列表该行 Manage → 重新进入 |
| 想取消托管 | 在 Noxc 删掉那两条 NS 即可,DNSHE 侧区域留着不影响 |
界面英文按钮对照
| 界面原文 | 中文 |
|---|---|
| DNS 解析 / DNS Management | DNS 解析管理 |
| Add domain | 添加域名 |
| New domain setup | 新域名设置引导 |
| Copy / Copy all | 复制 / 复制全部 |
| Check again | 重新检测 NS 是否生效 |
| Add DNS records | 进入 DNS 记录页(图 7 → 图 8) |
| Update nameservers | 到注册商 / 上级改 NS |
| Overview / Nameservers / DNSSEC / Domain settings | 概览 / NS / DNSSEC / 域名设置 |
| Manage → / Active | 管理该域名 / 已激活 |
本文按截图实写;DNSHE 控制台界面若后续更新,以实际页面为准。
站点设置(管理员)
以下都在后台「站点设置」里改,保存即生效,不用重新部署。
- 新用户默认配额、一键同步;保留域名是在内置基线(
ai/dash/nic)上追加,基线删不掉。 - 注册滑块验证:开关与图库子集;弹窗只在提交时出现,管理员手动开通豁免。
- 页脚备案号、页脚联系方式:贴
<a>链接即可,留空隐藏;两者首屏直出,不等接口。 - AI 审核通道、根域名列表、首页公开统计、邮箱白名单与第三方邮箱申请、DNSHE NS 预设。
用户案例展示
/showcase 是公开的用户案例页:每张卡片展示图标、标题、站长、一句话描述与域名链接。
- 预设不展示:所有域名默认不展示,必须在「域名详情 → 用户案例展示」里主动开启。
- 只有已开通且账号正常的域名会出现;公开接口不返回邮箱与用户 ID,站长名优先取个人资料昵称。
- 展示标题、描述与 emoji 都能改;标题留空回退到域名前缀,图标留空用地球。
- 关掉开关即从公开页移除,不影响域名本身与 DNS 记录。
- 首次把已开通域名开启展示会获得一次性积分奖励(默认 6000,可在站点设置里调整)。每个账号只发一次:关闭展示不回收,再开或展示更多域名都不叠加;管理员与无限积分账号不参与。
已知限制 / FAQ
以下是真实边界,不是「待优化」的客套话。
- 两个根域名的 NS 分散在 Spaceship 与 Cloudflare,没有下发通配记录:只有显式创建或委派过的名字才解析,后台审核通过不等于 DNS 已生效。
- 少数子域是 NS 委派给第三方的(例如 Vercel 项目),完全不经过本站 Worker,后台管不到。
- 部分运营商到海外链路不稳,访问第三方项目可能需要代理;这是链路问题,不是 DNS 解析失败。
- 没有 SLA、不托管网站内容;第三方邮箱申请提交后不会主动发邮件通知管理员,需进后台页签查看。
常见问题
| 问题 | 回答 |
|---|---|
| 为什么刷新没有过渡动画? | 刻意如此:Miku 过渡只在侦测到跳转时出现;刷新、地址栏直接打开、外部进入都不播。 |
| 为什么慢页面切换会等更久? | 点击瞬间并行预取目标页数据,资料到手才换页,不会让你看到空壳慢慢填;快页约 0.7 秒,慢页才真的等。 |
| 以前滑块验证会说「子域名不存在」 | 已修:验证走独立前缀,不再被域名 id 路由吃掉;通过后自动接着提交。 |
| 八张图的 DNSHE 完整文档在哪? | 上面第 05 节就是完整版,图 1–图 8 按顺序内嵌,含图 7 → 图 8 那一步。 |