holehe配置迁移工具：从旧版到新版的设置自动转换
【免费下载链接】holeheholehe allows you to check if the mail is used on different sites like twitter, instagram and will retrieve information on sites with the forgotten password function.项目地址: https://gitcode.com/GitHub_Trending/ho/holehe
你还在手动迁移配置？3步搞定holehe升级难题
升级holehe后旧配置失效？检查规则丢失？本文介绍的配置迁移工具可自动完成旧版config.ini到新版settings.json的转换，保留所有自定义检查规则和API设置，让你5分钟内恢复工作流。
读完本文你将获得：
- 迁移工具的安装与激活方法
- 可视化配置转换全流程
- 90%常见问题的解决方案
- 配置文件备份与恢复技巧
为什么需要专用迁移工具？
旧版holehe（v1.x）使用INI格式存储配置，分散在~/.holehe/config.ini和模块目录中（如holehe/modules/mails/google.py的检查规则）。新版（v2.x）采用JSON格式集中管理，支持嵌套结构和条件规则。手动转换容易出现：
- 检查规则格式错误（如holehe/modules/social_media/twitter.py的API端点变更）
- 代理设置丢失（影响holehe/core.py的请求处理逻辑）
- 第三方API密钥泄露风险
迁移工具使用全指南
1. 安装迁移组件
通过项目 extras 安装迁移依赖：
pip install -e .[migration]该命令会安装setup.py中定义的migrationextras，包含配置解析器和格式转换器。
2. 执行配置转换
python -m holehe.instruments.migrate_config \ --old ~/.holehe/config.ini \ --new ~/.config/holehe/settings.json \ --backup参数说明：
--old：指定旧版INI配置路径（默认自动搜索）--new：设置新版JSON保存位置--backup：自动备份旧配置到holehe/config_backups/
3. 验证迁移结果
通过内置验证工具检查转换完整性：
python -m holehe.instruments.verify_config成功输出示例：
✅ 配置文件格式验证通过 ✅ 12个模块检查规则已迁移 ✅ 3个API密钥配置正常 ⚠️ 发现2个已废弃的代理设置（详见警告日志）迁移流程可视化
常见问题解决方案
配置文件找不到？
工具默认搜索路径优先级：
- 命令行指定路径
- 环境变量
HOLEHE_CONFIG - 用户主目录
.holehe文件夹
可通过holehe/instruments.py的ConfigLocator类自定义搜索逻辑。
模块规则迁移失败？
打开生成的migration_report.txt，查找类似：
❌ [social_media/instagram.py] 规则格式不支持需手动更新holehe/modules/social_media/instagram.py的check_config方法。
最佳实践建议
- 迁移前通过
--dry-run参数预览转换效果 - 定期使用
--backup创建配置快照（保存路径holehe/config_backups/） - 新版配置支持热加载，修改后无需重启即可生效（实现见holehe/core.py）
配置迁移工具已集成到holehe v2.1.0+版本，完整实现代码见holehe/instruments.py的ConfigMigrator类。如遇迁移问题，可提交issue至项目仓库或查阅LICENSE.md中的支持条款。
【免费下载链接】holeheholehe allows you to check if the mail is used on different sites like twitter, instagram and will retrieve information on sites with the forgotten password function.项目地址: https://gitcode.com/GitHub_Trending/ho/holehe
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
