备案查询
供货方要求订阅方域名已备案时，用你自己选的备案查询接口（天行数据、ALAPI 或自定义 HTTP）核对，未备案的域名不能接入要求备案的报价。
能解决什么问题
国内节点上没有备案的域名会被运营商拦截，供货方的 IP 还可能因此被封。供货方可以在报价里勾选“要求订阅方域名已备案”，平台在订阅方主控、市场和供货方主控三处逐层核对，没有备案的域名不能接入这份报价；备案按主域名判断，子域名继承主域名的状态，之后还会定期复查。
怎么开通与启用
备案查询是官方免费模块，社区版和商业版都内置。查询接口由供货方自己选、自己付费，Key 只存在供货方主控本地，不上传市场。
- 在备案查询服务商（天行数据、ALAPI）开通接口并拿到 Key，或准备好其他服务商的 HTTP 接口。
- 在主控服务器上编辑
/etc/cdnca-control/optional.env，填写MARKET_ICP_PROVIDER（tianapi、alapi或custom_http）和MARKET_ICP_KEY_FILE（存放 Key 的文件路径），然后重启主控服务。 - 在“节点市场 → 我的上架”编辑报价，勾选要求备案。
也可以安装第三方备案查询插件，在“第三方服务商插件”里通过契约测试后启用。
主要设置
| 设置 | 说明 |
|---|---|
| 查询服务商 | 天行数据、ALAPI、自定义 HTTP（自定义地址不能指向内网） |
| Key 文件 | 只在本机读取，不进日志和错误信息 |
| 报价的备案要求 | 按节点组或报价勾选；报价含任何要求备案的部分，整个报价就带“需备案”标记 |
典型用法
- 卖国内节点：勾选要求备案，避免未备案的域名把节点 IP 拖累。
- 转售上游要求备案的节点：这个要求在转售时必须保留。
限制与注意事项
- 勾选了备案要求却没有配置可用的查询接口时，相关报价不能上架。
- 两家内置接口只核对过地址和返回结构，还没有用真实 Key 做端到端测试，使用前请先用一个已知已备案的域名试查。
- 查询结果有缓存（默认 7 天），到期自动刷新；发现备案失效时会通知订阅方。
- 管理员可以人工把某个域名标记为已备案或未备案，纠正误报。