aws-builder-id的config.yaml完全详解:一个文件看懂邮箱、地区、代理与浏览器全部参数
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:验证码一直收不到?
- 确认
email.worker_url和email.domain是自己的服务; - 调大
wait_timeout(如180); - 检查 Cloudflare Email Routing 是否把该域名的邮件转发到了 Worker。
Q2:被判定为机器人?
- 开启
use_proxy: true,并让代理 IP 与current地区一致; - 用 scripts/switch_device.py 切换到
mobile; - 换一个地区(
usa→japan→germany)再试。
Q3:代理连接失败?
先运行 python scripts/check_proxy.py 定位问题,再检查 proxy_url / proxy_api.url 的格式与协议是否正确。
⚠️ 本项目仅供学习与自动化技术研究使用,请遵守 AWS 服务条款及相关法律法规,合理使用。