# go-gmail

**Repository Path**: violet27chen/go-gmail

## Basic Information

- **Project Name**: go-gmail
- **Description**: 使用接码平台完成注册谷歌账号
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 谷歌邮箱注册专用接码助手 快速指南

欢迎使用本工具。本工具专为辅助注册谷歌账号而设计，对接了「豪猪网」的短信接收平台，可快速获取真实的国内移动手机号并提取谷歌短信验证码。

> [!IMPORTANT]
> ## ⚠️ 使用声明与法律责任
>
> **适用对象**：本工具仅面向**因网络环境限制而无法正常完成谷歌账号手机验证的个人用户**，帮助其完成合法的个人账号注册。
>
> **明确禁止以下行为**：
> - 🚫 **批量注册**：禁止利用本工具进行任何形式的批量、自动化或程序化注册账号行为。
> - 🚫 **商业滥用**：禁止将注册所得账号用于垃圾邮件、欺诈、网络攻击或其他违法商业用途。
> - 🚫 **倒卖账号**：禁止将通过本工具注册的账号进行转卖或批量出售牟利。
>
> **安全风险说明**：
> - 接码平台涉及临时手机号的使用，所获号码**非永久绑定**，平台可能在一定时效后回收。
> - 请勿将接码平台的 API 凭证泄露给任何第三方，以防余额被盗用。
> - 本工具**不存储任何数据于云端**，所有数据仅保存于本地浏览器/设备，由用户自行保管。
>
> **隐私保护说明**：
> - 🔒 **零遥测**：本工具不含任何统计、埋点、崩溃上报或行为追踪代码，开发者**无法且不会**收集你的任何使用数据。
> - 🔒 **本地存储**：你的 API 账号、密码、Token、历史号码及短信记录**全部存储在本地**（浏览器 `localStorage` 或 Electron 应用本地存储），不会上传至任何服务器。
> - 🔒 **网络请求最小化**：本工具发出的唯一外部请求是向豪猪网官方 API（`api.haozhuma.com`）拉取号码和短信，不经过任何中间代理服务器。
> - 🔒 **开源可审计**：本项目完全开源，你可以在 [GitHub](https://github.com/violettoolssite/go-gmail) 上自行审查所有源代码，验证上述承诺。
>
> **免责声明**：本工具为开源辅助性工具，开发者不对用户因违反上述禁止行为或违反谷歌服务条款所导致的账号封禁、财产损失或法律责任承担任何责任。**使用即代表你已阅读并同意上述条款。**

![软件界面](public/软件界面.png)

## 1. 注册与充值

首先，你需要拥有一个豪猪网账号并确保内有余额。

> **为什么选择 3.3元的单价？**
> 平台上可能存在几毛钱甚至更便宜的线路，但经过测试，**3.3元/次的高级线路收码成功率最高、最稳定**。为了不浪费时间在低价死号上反复重试，本工具已默认对接了最稳定的高级通道。

[点击注册豪猪网账号](https://h5.haozhuma.com/reg.html?action=violet27chen) | [点击前往充值中心进行充值 (h5.haozhuma.com)](https://h5.haozhuma.com/index.php)

![充值进行接码](public/充值进行接码.png)

## 2. 获取 API 凭证

为了让本工具能够自动调用你的额度获取号码，我们需要配置 API 交互凭证。你需要在豪猪网的用户中心找到这些信息。

![API获取](public/API获取.png)
![加入对接码](public/加入对接码.png)

## 3. 运行与配置

本项目支持两种运行方式，请按需选择：

### 🚀 最简单：直接下载 .exe（无需任何环境）

前往 [GitHub Releases](https://github.com/violettoolssite/go-gmail/releases/latest) 下载最新版 **`谷歌邮箱接码助手.exe`**，解压后双击即可运行，无需安装 Node.js 或任何其他依赖。

---

### 方式一：浏览器模式（推荐，无需构建）
1. 进入本工具文件夹目录。
2. 双击运行 **`一键启动服务.bat`**。
   - 脚本会自动安装依赖并启动本地服务器。
   - 启动后自动打开浏览器并跳转到 `http://127.0.0.1:5173/`。

*(Mac / Linux 系统请在终端依次执行 `npm install` 然后 `npm run dev`)*

### 方式二：构建为原生桌面软件（Windows .exe）
如果你有 Node.js 环境，可以将本工具一次性打包为独立的 Windows 桌面程序，无需保持命令行窗口打开：

```bash
npm install
npm run electron:build:win
```

构建完成后，将 `release/win-unpacked/` 整个文件夹复制到任意位置，双击 **`谷歌邮箱接码助手.exe`** 即可启动，无需浏览器。

> **提示**：如需构建为单文件安装包（.exe 安装程序），请先在 Windows **设置 → 开发者选项** 中开启**开发者模式**，再执行构建命令。

### 填写 API 配置
首次运行时，系统会自动弹出**平台 API 配置**窗口（随时可点击左上角"配置"修改）：

1. **API 账号名**：填入你在豪猪网获取的 API 用户名（并非手机号登录名）。
2. **API 密码**：填入对应的 API 通讯密钥。
3. **项目对接码（可选）**：已内置对接码 `28209-YJI2QSFH3R`，有自己业务码可覆盖填入；没有则**留空即可**。

![信息填写](public/信息填写.png)

---

## 4. 开始使用

配置成功后，页面右上角将显示你当前可用的余额。

1. 点击 **[获取新号码]**，系统将消耗你的计费并发请求，并返回一个国内移动号码。
2. 请在弹窗中**填写你正在注册的谷歌邮箱名（只需填写前缀，系统自动补全 @gmail.com）**，方便以后回溯。
3. 去谷歌注册页面填入该号码。
4. 回到本工具等待，通常在 5 ~ 30 秒内会自动出现验证码，点击该粗体验证码即可自动复制。

![注册谷歌成功截图](public/注册谷歌成功截图.png)

### 使用技巧与进阶
*   **指定号码获取**：在「当前可用号码」标题下方，你可以填写特定手机号后再点击【获取新号码】，程序会优先向平台请求该指定号码。
*   **历史短信隔离**：每条短信记录都会与其归属的手机号自动绑定，当你切换不同的号码时，只会看到属于该号码的短信，互不干扰。
*   **灵活修改绑定**：在「历史已绑号码」列表中，你可以随时点击【修改】来更正该号码对应的邮箱前缀。
*   **号码数据备份**：在「历史已绑号码」标题旁，你可以点击**「导出备份」**按钮一键将所有的手机号与邮箱绑定关系导出为 JSON 文件，方便你离线保存和资产盘点。
*   **找回号码**：如果你曾给号码绑定过邮箱，该号码会出现在「历史已绑号码」中。点击【载入】可尝试向平台发送请求，如果该号码仍在你的有效时限内且未被系统回收，你即可重新监听该号码的后续短信。
*   **全局释放**：当你获取新号码时，为了防止扣费浪费，本工具会自动向服务端发送全局释放指令，清理你后台可能遗留挂载的其余号码，确保当前只服务一个并发号码。

### 注册成功后必做：绑定个人手机和辅助邮箱

> [!IMPORTANT]
> **注册成功后如果没有立刻被封停，请务必第一时间完成以下操作，确保账号归属权完全属于你自己：**
>
> 1. **立即绑定你自己的手机号**：进入 Google 账号 → **安全性** → **辅助电话号码**，绑定你个人的真实手机号码（不是接码平台的号码）。
> 2. **立即绑定辅助邮箱**：在同一页面的 **辅助邮箱** 栏，绑定你自己的常用邮箱（如 QQ 邮箱、Outlook 等）。
> 3. **替换掉接码号码**：如果注册时使用的接码号码仍然显示为账号的主手机号，请在 **个人信息 → 手机号** 中将其替换为你自己的号码，或直接删除。
>
> **为什么必须这样做？**
> - 接码平台的号码是临时的，一段时间后会被回收，届时任何人都可能获取到同一个号码。
> - 如果你不替换绑定，他人可能通过该号码接收到你的验证码，甚至找回你的账号。
> - 完成绑定后，以后该邮箱的所有验证码都会发送到**你自己的手机和邮箱**，彻底脱离接码平台。

---

## 5. 经验与网络环境防封技巧

> **模拟器免验证码大法**
> 强烈建议使用 **MuMu 模拟器** 进行谷歌账号的注册。在安卓真机环境模拟下，大概率可以跳过繁琐的"发送短信验证"环节，直接进入接码流程，成功率极高。
>
> ![模拟器分辨率设置](public/模拟器分辨率设置.png)

> **网络环境与代理选择 (重点)**
> 谷歌对注册 IP 的风控级别不同，请根据你的用途选择：
>
> *   **基础需求（看视频、下资源、普通使用）**：使用**普通机房 IP (VPS)** 配合 MuMu 模拟器，注册成功率就已经很大了，不需要额外消费。
> *   **高级需求（电商、长期养号、海外业务）**：推荐使用 **[Cliproxy](https://cliproxy.com/zh/)** 的【静态住宅 IP】（约 30 元/条的美国原生 IP）。纯净的住宅 IP 能提供极佳的初始权重。
>
> *注意：*
> 1. ISP 静态住宅代理在国内无法直接直连使用，需要通过你自己的常规翻墙节点作为前置进行**链式代理 (Chain Proxy)** 才能连通。
> 2. **强烈建议不要使用常规 VPN 线路**。尤其是那些使用人数众多（如单节点过千人使用）的公共 VPN，此类 IP 几乎全部被谷歌拉黑，注册成功率极低。
>
> ![cliproxy官网页面](public/cliproxy官网页面.png)
>
> 配置好代理后，请务必先打开 [Ping0.cc](https://ping0.cc/) 检查你的伪装度。确保显示为原生住宅 IP、无不良历史，这是不被秒封的核心前提。

---

## 6. 桌面软件安装方案

### 方案一：Electron 原生应用（推荐）

通过 `npm run electron:build:win` 构建的桌面版（详见第 3 节），将 `release/win-unpacked/` 文件夹复制到任意位置后即可直接双击 `谷歌邮箱接码助手.exe` 使用，完全脱离浏览器和命令行。

### 方案二：PWA 浏览器安装（备选）

在浏览器模式运行（`http://127.0.0.1:5173/`）时，可通过浏览器将本工具安装为拥有独立窗口的桌面应用：

1. 使用 Chrome 或 Edge 打开项目网址。
2. 点击**地址栏右侧**出现的「安装应用」图标。
3. 也可通过菜单 **`...`** → **`应用`** → **`安装此站点`** 手动安装。

> **注意**：PWA 方案需要本地服务持续运行（`一键启动服务.bat` 窗口不能关闭），Electron 桌面版则完全独立无此依赖。

---

> **刚注册就被封停怎么办？**
> 如果注册后账号立刻被提示封禁，**不要慌张，这是谷歌的常规机器风控**。
> 1. 直接点击页面的**申诉**按钮。
> 2. 在申诉理由里随便写几句话（例如："正常个人注册使用，请查明解封"）。
> 3. 通常在 **一天之内** 就能顺利解封。解封后的账号只要**保持节点环境固定不变**，就可以一直稳定使用了。

---

## 7. 推荐虚拟卡平台

注册谷歌账号后，如果你需要一张海外虚拟信用卡来订阅 Google Play、YouTube Premium 等服务，推荐使用 **Roogoo**：

🎁 [**点击注册 Roogoo 享免费开卡 + 7天0费率试用**](https://wap.roogoo.money/register?inviteCode=zd9kgv)

![Roogoo虚拟卡平台](public/roogoo.png)

> **费用说明**：
> - 💳 **开卡费用 5 USDT**，首次使用需存入 **10 USDT** 即可激活
> - 🪙 **支持加密货币支付** — 可使用 USDT 等主流加密货币充值，方便快捷
>
> **专属福利**：通过本链接注册即可享受：
> - ✅ **7天0费率试用** — 充分体验再决定
> - ✅ **可升级终身0费率** — 卡片升级后永久免手续费
> - ✅ **余额赚币收益** — 闲置余额也能产生收益
> - ✅ **消费挖矿** — 每笔消费获得额外奖励
> - ✅ **邀请返佣** — 邀请好友注册享丰厚佣金

### 加密货币购买渠道

Roogoo 虚拟卡需要使用 USDT 充值，如果你还没有加密货币，可以通过以下平台购买：

| 平台 | 注册链接 | 新人福利 |
| --- | --- | --- |
| **币安 Binance** | 🔗 [点击注册](https://www.bsmkweb.cc/referral/earn-together/refer2earn-usdc/claim?hl=zh-CN&ref=GRO_28502_NJ0AX&utm_source=default) | 全球最大交易所 |
| **欧易 OKX** | 🔗 [点击注册](https://www.bvhgkzmywxf.com/join/50645266) | 限时活动，注册立享新人专属 **10,000+ USDT** 礼包 |
| **Gate.io** | 🔗 [点击注册](https://www.gateport.business/zh/referral/registry?ref=VQCRBF5DBQ&ref_type=103&page=earnVoucher&utm_cmp=PEYEQdSb) | 注册领取新人奖励 |

> [!CAUTION]
> ## ⚠️ 重要安全警告
>
> **强烈建议在以上平台只进行充值（买入），不要进行提现操作！**
>
> 在国内环境下，加密货币的提现（卖出变现）可能涉及复杂的合规与法律风险，严重情况下**可能导致银行卡冻结甚至刑事责任**。
>
> 建议仅将交易所作为 **购买 USDT → 充值到 Roogoo 虚拟卡** 的中转工具，不要参与任何提现、OTC 交易或场外变现行为。