holehe配置迁移工具：从旧版到新版的设置自动转换

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个已废弃的代理设置（详见警告日志）

迁移流程可视化

常见问题解决方案

配置文件找不到？

工具默认搜索路径优先级：

1. 命令行指定路径
2. 环境变量HOLEHE_CONFIG
3. 用户主目录.holehe文件夹

可通过holehe/instruments.py的ConfigLocator类自定义搜索逻辑。

模块规则迁移失败？

打开生成的migration_report.txt，查找类似：

❌ [social_media/instagram.py] 规则格式不支持

需手动更新holehe/modules/social_media/instagram.py的check_config方法。

最佳实践建议

1. 迁移前通过--dry-run参数预览转换效果
2. 定期使用--backup创建配置快照（保存路径holehe/config_backups/）
3. 新版配置支持热加载，修改后无需重启即可生效（实现见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