# openai-register-java

**Repository Path**: deviling/openai-register-java

## Basic Information

- **Project Name**: openai-register-java
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-06
- **Last Updated**: 2026-03-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenAiRegister

基于 Spring Boot 的 OpenAI 账号自动注册工具。

## 功能特性

- **临时邮箱**: 使用 Mail.tm API 自动创建临时邮箱接收验证码
- **代理支持**: 自动检测本地代理（支持 Clash、V2Ray 等主流代理工具）
- **浏览器指纹**: 模拟真实浏览器指纹，降低被 Cloudflare 拦截风险
- **自动注册**: 全流程自动化完成 OpenAI 账号注册
- **Token 保存**: 自动保存注册获得的 Access Token 和 Refresh Token

## 技术栈

- Java 17
- Spring Boot 3.2.2
- OkHttp 4.12.0
- Lombok
- Jackson

## 快速开始

### 1. 配置代理

在 `src/main/resources/application.yml` 中配置代理端口：

```yaml
proxy:
  ports: 7897,1080,10809,10808,8888
```

工具会自动检测列表中的可用代理。

### 2. 配置并发数

```yaml
app:
  threads: 1
```

> **注意**: 建议保持为 1，以降低被 Cloudflare 拦截的概率。

### 3. 运行项目

```bash
# Windows
start.bat

# 或手动运行
mvn spring-boot:run
```

## 运行原理

1. **获取临时邮箱**: 调用 Mail.tm API 创建临时邮箱
2. **初始化 OAuth**: 模拟浏览器访问 OpenAI 授权页面
3. **获取 Sentinel Token**: 通过 Cloudflare 检测获取令牌
4. **提交注册**: 填写邮箱地址
5. **接收验证码**: 从临时邮箱获取 OTP 验证码
6. **验证邮箱**: 提交验证码完成邮箱验证
7. **完善信息**: 自动填写用户名和生日
8. **选择工作空间**: 选择默认个人工作空间
9. **Token 交换**: 完成 OAuth 流程获取最终 Token

## 输出文件

注册成功后，结果会保存到 `output/` 目录：

- `token_xxx.json`: 完整的 OAuth Token JSON
- `accounts.txt`: 账号记录，格式为 `邮箱----密码----RefreshToken`

## 注意事项

1. 请确保代理能够访问 OpenAI 服务
2. 建议使用国外代理以提高注册成功率
3. 过度频繁注册可能导致 IP 被封禁
4. 本工具仅供学习研究使用，请遵守 OpenAI 服务条款

## 项目结构

```
src/
├── main/
│   ├── java/com/openai/register/
│   │   ├── OpenAiRegisterApplication.java  # 启动类
│   │   ├── config/
│   │   │   └── FingerprintInterceptor.java # 浏览器指纹拦截器
│   │   ├── model/
│   │   │   └── TempMailbox.java             # 临时邮箱模型
│   │   ├── runner/
│   │   │   └── RegistrationRunner.java      # 注册任务调度器
│   │   ├── service/
│   │   │   ├── MailTmService.java            # 临时邮箱服务
│   │   │   ├── OpenAiService.java            # OpenAI 注册服务
│   │   │   └── ProxyService.java             # 代理检测服务
│   │   └── util/
│   │       └── PkceUtil.java                 # PKCE 工具类
│   └── resources/
│       └── application.yml                   # 配置文件
```