aws-builder-id的config.yaml完全详解:一个文件看懂邮箱、地区、代理与浏览器全部参数

原创2026-10-26 15:03:421,454 阅读

aws-builder-id的config.yaml完全详解:一个文件看懂邮箱、地区、代理与浏览器全部参数

aws-builder-id 是一款自动化注册 AWS Builder ID 账号的工具,它的全部行为都由一个配置文件控制——config/config.yaml。这篇文章把这个文件的邮箱服务、地区环境、代理接入和浏览器行为四大块参数逐一讲清楚,让你改完配置就能直接跑。

📁 config.yaml 在哪里,又被谁读取

主配置文件位于项目根目录的 config/config.yaml,共分为 4 个配置块:

  • email:临时邮箱服务
  • browser:浏览器运行行为
  • region:地区、设备与代理
  • http:网络请求超时

程序启动时,src/config.py 会用 PyYAML 一次性读取整份文件并转成全局常量,然后被各个模块按需引用:

配置块 主要使用方
email src/services/email_service.py 负责创建临时邮箱、轮询验证码
region / 代理参数 src/managers/proxy_manager.py 负责获取静态或动态代理
browser / http 浏览器启动与 HTTP 会话超时控制

💡 新手提示:配置写错了程序通常不会报错,而是静默回退到默认值。改完后建议运行辅助脚本验证,见文末「常用改动速查」。

📧 email 块:临时邮箱服务(必填项)

本工具依赖 Cloudflare 上的临时邮箱(cloudflare_temp_email)来接收 AWS 发来的验证码。这是配置中最需要你先准备好的部分。

参数 作用 示例值
worker_url 你部署的临时邮箱 Worker 服务地址 https://your-worker.workers.dev
domain 收信域名(Cloudflare Email Routing 中配置的域名) your-domain.com
prefix_length 随机邮箱前缀的长度(数字 + 小写字母) 10
wait_timeout 等待验证邮件的超时时间(秒) 120
poll_interval 轮询邮箱的间隔时间(秒) 3
admin_password 临时邮箱管理员 API 的密码 你的密码

逐条理解一下:

  • worker_url + domain:前者是服务地址,后者是你自己的收信域名,两者都要换成自己部署后的值,否则注册流程在第一步就会失败。
  • prefix_length:每次注册都会随机生成 前缀 + @domain 形式的邮箱,前缀越长越不容易撞号,一般保持 10 即可。
  • wait_timeout 与 poll_interval:程序每隔 poll_interval 秒检查一次邮箱,最长等 wait_timeout 秒。如果经常收不到验证码,先调大 wait_timeout,再检查 Email Routing 是否配置正确。

🌐 region 块:地区、设备类型与代理

region 是整个文件的核心,它决定了浏览器"假装"身处哪个地区、用什么设备、走不走代理。

顶层开关

参数 可选值 说明
current usa / germany / japan 当前使用的地区
device_type desktop / mobile 设备类型,决定选哪组 User-Agent
use_proxy true / false 是否启用代理(强烈建议开启)
proxy_mode static / dynamic 代理模式:静态代理 或 动态 API

静态代理(proxy_mode: static)

适合你手里有一个固定的代理地址:

use_proxy: true
proxy_mode: "static"
proxy_url: "http://host:port"   # 或 socks5://host:port

proxy_url 支持 http://、https://、socks5:// 等协议,也可以写成 http://用户名:密码@host:port 带认证的格式。

动态代理 API(proxy_mode: dynamic)

适合批量场景:每次运行都向代理厂商的 API 请求一个新的 IP,由 src/managers/proxy_manager.py 负责调用。

参数 说明 示例
proxy_api.url 代理 API 地址,返回格式为 ip:port http://your-proxy-api.com/get?key=KEY
proxy_api.timeout 请求代理 API 的超时时间(秒) 10
proxy_api.protocol 代理协议:http 或 socks5 http
proxy_api.auth_required 是否需要账号认证 false
proxy_api.username / password 认证账号密码 空字符串

更完整的代理选型说明可以查阅 docs/PROXY_GUIDE.md。

profiles:每个地区的详细环境

region.profiles 为美、德、日三地预置了完整的环境参数,程序会根据 current 自动套用对应的一套:

地区 语言 时区
🇺🇸 usa en-US America/New_York
🇩🇪 germany de-DE Europe/Berlin
🇯🇵 japan ja-JP Asia/Tokyo

每个地区 profile 包含 4 类参数:

  • locale / timezone / accept_language:浏览器语言、时区和 HTTP 请求头的语言偏好,保证"说英语、用纽约时区、发德语请求头"这类细节自洽。
  • desktop_user_agents:桌面设备的 User-Agent 候选列表(Windows / macOS / Linux 的 Chrome)。
  • mobile_user_agents:移动设备的 User-Agent 候选列表(iPhone、iPad、Android)。程序按 device_type 选对应列表并随机取一个。

这些参数不需要手动维护,一般保持原样;如果你被风控,切换地区比改 UA 更有效。地区配置的原理详见 docs/README_REGION.md。

🖥️ browser 块:浏览器行为

只有两个参数,但很实用:

参数 默认值 说明
headless false 是否无头模式(不弹出浏览器窗口)
slow_mo 100 每步操作之间的延迟(毫秒)
  • 想"看着它跑"调试时保持 headless: false;
  • 批量无人值守时改为 true;
  • slow_mo 调大可以放慢操作节奏,让行为更像真人,但会拖慢整体速度。

⏱️ http 块:请求超时

http:
  timeout: 30   # 所有 HTTP 请求的超时时间(秒)

邮箱 API、代理 API 等网络请求共用这个超时。网络环境较差时可以适当调大。

🚀 常用改动速查

改完配置后,用辅助脚本快速验证:

# 查看/切换地区
python scripts/switch_region.py show
python scripts/switch_region.py germany

# 切换设备类型
python scripts/switch_device.py mobile

# 测试代理是否可用
python scripts/check_proxy.py

# 检查浏览器指纹
python scripts/check_fingerprint.py

然后运行 src/runners/main.py 单次执行,或 src/runners/batch_run.py 批量执行。注册成功的账号会保存到 accounts.jsonl。

❓ 常见问题

Q1:验证码一直收不到?

  1. 确认 email.worker_url 和 email.domain 是自己的服务;
  2. 调大 wait_timeout(如 180);
  3. 检查 Cloudflare Email Routing 是否把该域名的邮件转发到了 Worker。

Q2:被判定为机器人?

  1. 开启 use_proxy: true,并让代理 IP 与 current 地区一致;
  2. 用 scripts/switch_device.py 切换到 mobile;
  3. 换一个地区(usa → japan → germany)再试。

Q3:代理连接失败?

先运行 python scripts/check_proxy.py 定位问题,再检查 proxy_url / proxy_api.url 的格式与协议是否正确。

⚠️ 本项目仅供学习与自动化技术研究使用,请遵守 AWS 服务条款及相关法律法规,合理使用。

登录后查看全文
aws-builder-id