ENScan_GO Cookie配置完全手册:AQC与TYC认证详解
在区块链域名分析工作中,你是否曾因Cookie配置错误导致ENS查询失败?是否在面对AQC(爱企查)和TYC(天眼查)的认证机制时感到困惑?本文将系统解决Cookie配置难题,让你5分钟内完成从环境准备到高级认证的全流程配置,确保ENScan_GO工具稳定高效运行。
环境准备与配置文件生成
首次启动与配置文件创建
使用ENScan_GO前需先生成配置文件,通过以下命令初始化环境:
./enscan -v
执行后程序会在当前目录生成配置文件,核心配置项位于common/config.go中,包含Cookie存储路径、超时设置等关键参数。配置文件生成后,可在程序根目录找到并进行编辑。
目录结构与配置文件位置
ENScan_GO的配置系统采用模块化设计,主要配置文件分布如下:
- 主配置:common/config.go - 定义全局配置结构体与默认值
- Cookie存储:程序运行目录下的配置文件(由
-v命令生成) - 参数解析:common/flag.go - 处理命令行参数与配置文件映射
AQC(爱企查)Cookie获取与配置
Cookie获取完整流程
AQC的Cookie获取需通过浏览器开发者工具完成,步骤如下:
- 访问爱企查网站并登录账号
- 打开浏览器开发者工具(F12),切换至Application标签
- 在左侧导航栏选择Storage > Cookies > aiqicha.baidu.com
- 复制BDUSS和PTOKEN字段的值,注意不要包含空格或特殊字符
配置文件写入规范
获取Cookie后,需按以下格式写入配置文件:
{
"aiqicha": {
"cookie": "BDUSS=xxxx; PTOKEN=yyyy",
"timeout": 30
}
}
其中cookie字段需严格按照浏览器中获取的键值对格式填写,多个Cookie用分号分隔。AQC模块的核心实现位于internal/aiqicha/aiqicha.go,包含Cookie验证与请求签名逻辑。
TYC(天眼查)双因素认证配置
tycid参数获取
TYC的认证需要配置tycid和auth_token两个关键参数,首先获取tycid:
- 登录天眼查后访问个人中心
- 右键页面查看源代码(Ctrl+U)
- 搜索tycid关键字,复制引号内的字符串值
auth_token实时认证
auth_token是TYC的短期有效认证令牌,获取方式如下:
- 在天眼查首页打开开发者工具(F12)
- 切换至Network标签,刷新页面
- 筛选XHR请求,查看任意API请求的Request Headers
- 复制Authorization字段的值(格式为
auth_token=xxxx)
TYC配置项完整示例
将获取的参数写入配置文件:
{
"tianyancha": {
"tycid": "your_tycid_value",
"auth_token": "your_auth_token_value",
"delay": 3
}
}
TYC模块的实现代码位于internal/tianyancha/tianyancha.go,其中包含令牌过期自动检测与重试逻辑。
配置验证与故障排除
快速验证命令
配置完成后,使用以下命令验证Cookie有效性:
./enscan -n 小米 -type aqc,tyc -debug
通过-debug参数可查看详细请求日志,若出现401 Unauthorized错误,需重新获取Cookie。
常见问题解决方案
| 错误现象 | 可能原因 | 解决方法 |
|---|---|---|
| 认证失败(401) | Cookie过期或不完整 | 重新获取完整Cookie,确保包含所有必填字段 |
| 请求频繁(429) | 未设置请求延迟 | 增加-delay 3参数,设置3秒请求间隔 |
| 配置不生效 | 配置文件路径错误 | 检查配置文件是否在程序运行目录,通过-v重新生成 |
高级配置与最佳实践
多账号轮换策略
对于大规模查询场景,可配置多组Cookie实现自动轮换,核心实现位于runner/runner.go的任务调度模块。配置格式示例:
{
"aiqicha": {
"cookies": [
"BDUSS=xxx1; PTOKEN=yyy1",
"BDUSS=xxx2; PTOKEN=yyy2"
],
"rotate_interval": 10
}
}
请求优化与反爬规避
为提高查询成功率,建议配置以下高级参数:
- 随机延迟:
-delay -1启用1-5秒随机延迟 - 代理设置:
-proxy http://127.0.0.1:8080配合Burp Suite使用 - 缓存控制:删除程序目录下的
enscan.gob文件可清除历史缓存
这些参数的处理逻辑位于common/utils/utils.go中的网络工具函数。
配置文件参考与模块路径
核心配置模块
- 配置定义:common/config.go
- 参数解析:common/flag.go
- AQC实现:internal/aiqicha/aiqicha.go
- TYC实现:internal/tianyancha/tianyancha.go
- 任务调度:runner/runner.go
完整配置示例
{
"timeout": 30,
"proxy": "",
"aiqicha": {
"cookie": "BDUSS=xxxx; PTOKEN=yyyy",
"timeout": 30
},
"tianyancha": {
"tycid": "zzzz",
"auth_token": "wwww",
"cookie": "auth=xxxx; token=yyyy"
}
}
通过本文档的配置指南,你已掌握ENScan_GO的Cookie配置全流程。如需进一步优化查询效率,可参考README.md中的高级用法章节,探索API模式与批量查询功能。配置过程中遇到问题,可提交Issue至项目仓库获取支持。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考






