NoxcSERVICE DOCS
返回首页 控制台

NOXC · SERVICE DOCUMENTATION

Noxc 服务文档

关于这套软件的全部说明:它能做什么、怎么申请子域名、DNS 记录怎么管、怎样把名字委派给 DNSHE。按站点实际功能写,也如实写出还不完善的地方。

适用站点:nic.299282.xyz 语言:中文 / EN 手机适配
01

关于 Noxc

Noxc 是一套跑在 Cloudflare Workers + D1 上的二级域名分发与 DNS 管理系统:把一个根域名切成很多可申请的子域名,审核通过后把该名字的 DNS 管理权交还给申请人。

它只负责「名字 + 解析记录」,不托管网站内容、不提供 SLA、也不是通用顶级域注册商。这一点写在最前面,免得后面产生误会。

PRIMARY

正式更名为 Noxc,首推 noxc.uk:它排在后缀选择器第一位并标注「首推」。主域名仍是 meoy.top —— ROOT_DOMAIN 与默认 Cloudflare Zone 都没变,首推不需要更换 Zone ID,也不用重配主域名;其余已配置后缀仍可正常选用。

APPLY

申请与审核

名称可用性检查、AI 审核、待审每小时复核、邮箱白名单与第三方邮箱申请、提交注册时的滑块拼图验证。

DNS

DNS 管理

A / AAAA / CNAME / MX / TXT / NS 等记录可增删改,附 Vercel、Netlify、Cloudflare Pages、GitHub Pages、DNSHE 一键模板。

ACCOUNT

账号体系

邮箱注册、NodeLoc OAuth、用户配额、签到积分、域名转移、工单、WHOIS 查询、滥用举报、中英双语。

技术构成

全栈 TypeScript:控制台是 React 18 + Vite,接口层是 Cloudflare Workers 上的 Hono,数据存 D1、头像存 R2。仓库里不跟踪任何 .html 源文件 —— SPA 外壳、两个根域名落地页、以及你正在看的这一页,都由 TypeScript 模板输出。

视觉语言来自 Noxc 主 logo:冷白底、近黑几何无衬线、一颗 Noxc 蓝点、圆头节点线条与点阵底纹,以及只在真正跳转时出现的 Miku 过渡动画(刷新不播)。

02

快速开始

从新账号到一条生效的解析记录,一共五步。

  1. 用允许的邮箱注册,或用 NodeLoc 登录。已登录时首页顶栏会直接显示「→ 去往控制台」,不再出现登录按钮。
  2. 邮箱不在允许范围?注册页有「申请使用此邮箱注册」入口,填邮箱与理由提交;管理员在后台通过后,该邮箱会自动加入白名单。
  3. 进入注册页检查名称是否可用,点提交注册。滑块拼图只在提交后以弹窗出现,通过后自动接着提交,不会卡在「子域名不存在」的循环里。
  4. 提交即刻跑一次 AI 审核,待审申请每小时还会复核一次;通过后名字出现在「我的域名」。
  5. 打开「DNS 记录」添加 A / CNAME / MX 等,或用一键模板;把整个名字交给第三方解析,见第 05 节。

系统保留名称(ai / dash / nic 等)普通用户不可申请;管理员仍可手动开通,且后台设置无法删掉这份基线名单。

03

账号与额度

每个用户的可申请数量由「站点设置 → 新用户默认配额」决定:-1 不限量、0 禁止申请、默认 5。勾选「一键同步」会覆盖已有普通用户,管理员始终不限量;用户列表里也能单独给某个人改,或「填入全局默认」。

绑定 NodeLoc 账号会一次性增加 5 个配额;解绑再绑、换号、重复回调都不会叠加。首次用 NodeLoc 登录建号与旧账号补领同样发放,管理员与不限量账号跳过。

NodeLoc 资料只读取 email;对方没给 id 时用邮箱派生稳定标识。第三方邮箱不会被用来冒领已有本地账号。

其余配套:签到积分与奖励中心、域名转移、工单系统、个人资料与头像、通知中心、滥用举报。

修改密码不再需要原密码:验证码发到当前账号绑定的邮箱(独立的 password_change 场景),6 位、10 分钟有效、一次性;校验通过才写入新密码,并踢掉其它设备的登录状态。占位邮箱或 .local / .test 等保留 TLD 收不到信,会提示先在个人资料里更换邮箱。

04

DNS 记录

每个已开通的名字都有独立记录列表;所有记录类型共用同一套校验、TTL 选项与可编辑表格。

KEY RULE

NS 记录也是普通 DNS 记录:添加后出现在同一张列表里,能编辑、能删除,不存在另一套「托管表」或独立接口。把子域名交给第三方解析,本质就是在父区写两条 NS。

常用模板:Vercel CNAME、Netlify CNAME、Cloudflare Pages、GitHub Pages A、www 别名、SPF 拒绝全部、DMARC 拒绝、DNSHE 托管 NS。重复点不会生成重复记录。

WHOIS 查询、服务条款、滥用举报均公开,不需要登录。

05

服务文档 · DNSHE 托管接入

把 Noxc 子域名交给 DNSHE 解析,以 ksdk.noxc.uk 为例;下面 8 张图与文内编号一一对应。

ONE SENTENCE

托管 = 在父区(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
IMPORTANT

ns1.dnshe.com / ns2.dnshe.com 专属于在 DNSHE 注册的域名,不适用于从 Noxc 委派出去的子域名。本文全流程只用 .org:图 6(Noxc 写入)与图 7(DNSHE 分配)都是它。api005.dnshe.com 之类是 API / 控制台网关,不是权威 NS,别填进记录里。

顺序别反:先在 DNSHE 加域名拿到 NS → 再去父区写 NS → 最后回 DNSHE 加记录。

1

DNSHE 侧添加域名

左侧菜单点「DNS 解析」(进入 DNS Management,标了 Free),右侧点 Add domain。旁边的 API keys、Activity log 本次用不到。

图 1 DNSHE 左侧菜单 DNS 解析
图 1 · 左侧菜单「DNS 解析」
图 2 DNS Management 的 Add domain 按钮
图 2 · DNS Management 的 Add domain
图 3 填写域名的 Add domain 弹窗
图 3 · Add domain 弹窗:Domain name 填纯域名,如 ksdk.noxc.uk;不要带 https://、路径或末尾斜杠,然后点右下角 Add domain。
2

拿到分配的 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 写进去再回来。

图 7 New domain setup 给出两条 ns.dnshe.org
图 7 · New domain setup:两条 .org NS + 底部三个按钮(Check again / Add DNS records / Cancel)
3

Noxc 侧写入 NS 记录

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

图 4 我的域名列表里的 DNS 记录按钮
图 4 · 我的域名 →「DNS 记录」
图 5 常用模板 DNSHE 托管 NS 一键
图 5 · 常用模板「DNSHE 托管 NS(一键)」
图 6 生成的两条 NS 记录
图 6 · 两条 NS 记录已生成,主机名 ksdk.noxc.uk、值分别为 ns1.dnshe.org / ns2.dnshe.org,TTL 自动、状态正常
4

图 7 → 图 8 的关键一步

回到 New domain setup 弹窗(若已关掉,在域名列表该行点 Manage → 重新进入)。底部三个按钮作用完全不同:

按钮作用会不会跳到图 8
Check again重新检测父区 NS 是否已生效否 只原地刷新那句黄色提示
Add DNS records进入该域名的 DNS records 管理页是 就是它
Cancel关闭引导,回域名列表否
MUST READ

必须点中间蓝色的 Add DNS records,才会看到图 8 的界面。点 Check again 只会重新检测、不会跳转;点 Cancel 直接退出引导。记住:图 7 是「给你 NS、让你去改 NS」,图 8 是「进来加记录」,中间那座桥就是 Add DNS records。

图 8 点击 Add DNS records 后进入的 DNS records 空记录页
图 8 · 点图 7 的 Add DNS records 后才出现的 DNS records 页:域名标记 Active,停在 DNS records 标签,显示「0 records / No DNS records found.」—— 这是新区域刚建好的正常状态,不是报错、也不是 NS 没生效。点「Add the first DNS record」或右上「+ Add record」开始加记录。

生效与验证

  • 回图 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 ManagementDNS 解析管理
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 控制台界面若后续更新,以实际页面为准。

06

站点设置(管理员)

以下都在后台「站点设置」里改,保存即生效,不用重新部署。

  • 新用户默认配额、一键同步;保留域名是在内置基线(ai/dash/nic)上追加,基线删不掉。
  • 注册滑块验证:开关与图库子集;弹窗只在提交时出现,管理员手动开通豁免。
  • 页脚备案号、页脚联系方式:贴 <a> 链接即可,留空隐藏;两者首屏直出,不等接口。
  • AI 审核通道、根域名列表、首页公开统计、邮箱白名单与第三方邮箱申请、DNSHE NS 预设。
07

用户案例展示

/showcase 是公开的用户案例页:每张卡片展示图标、标题、站长、一句话描述与域名链接。

  • 预设不展示:所有域名默认不展示,必须在「域名详情 → 用户案例展示」里主动开启。
  • 只有已开通且账号正常的域名会出现;公开接口不返回邮箱与用户 ID,站长名优先取个人资料昵称。
  • 展示标题、描述与 emoji 都能改;标题留空回退到域名前缀,图标留空用地球。
  • 关掉开关即从公开页移除,不影响域名本身与 DNS 记录。
  • 首次把已开通域名开启展示会获得一次性积分奖励(默认 6000,可在站点设置里调整)。每个账号只发一次:关闭展示不回收,再开或展示更多域名都不叠加;管理员与无限积分账号不参与。

打开用户案例页 →

08

已知限制 / FAQ

以下是真实边界,不是「待优化」的客套话。

  • 两个根域名的 NS 分散在 Spaceship 与 Cloudflare,没有下发通配记录:只有显式创建或委派过的名字才解析,后台审核通过不等于 DNS 已生效。
  • 少数子域是 NS 委派给第三方的(例如 Vercel 项目),完全不经过本站 Worker,后台管不到。
  • 部分运营商到海外链路不稳,访问第三方项目可能需要代理;这是链路问题,不是 DNS 解析失败。
  • 没有 SLA、不托管网站内容;第三方邮箱申请提交后不会主动发邮件通知管理员,需进后台页签查看。

常见问题

问题回答
为什么刷新没有过渡动画?刻意如此:Miku 过渡只在侦测到跳转时出现;刷新、地址栏直接打开、外部进入都不播。
为什么慢页面切换会等更久?点击瞬间并行预取目标页数据,资料到手才换页,不会让你看到空壳慢慢填;快页约 0.7 秒,慢页才真的等。
以前滑块验证会说「子域名不存在」已修:验证走独立前缀,不再被域名 id 路由吃掉;通过后自动接着提交。
八张图的 DNSHE 完整文档在哪?上面第 05 节就是完整版,图 1–图 8 按顺序内嵌,含图 7 → 图 8 那一步。