# google_translate_scanner

**Repository Path**: aihei007/google_translate_scanner

## Basic Information

- **Project Name**: google_translate_scanner
- **Description**: 谷歌翻译ip扫描工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-02
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Google Translate IP 扫描工具 (Auto-Update Edition)

[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Status](https://img.shields.io/badge/status-stable-brightgreen)]()

## 📖 项目简介

**Google Translate IP 扫描工具 (自动更新版)** 是一个专为优化 Google 翻译服务访问体验而设计的高性能网络探测工具。

与传统扫描器不同，本版本**内置了智能 IP 获取引擎**。启动时会自动从全球 6+ 个权威数据源（BGPView, HackerTarget, Ripe Stat 等）实时获取最新的 Google ASN (AS15169) IP 段，智能采样后直接进行并发测速。

**无需手动维护 IP 列表，无需额外脚本，一行命令即可获取当前网络环境下最快的可用 IP。**

### ✨ 核心特性

*   **🚀 真正的零配置 (Zero-Config)**：
    *   内置多源 IP 获取引擎，启动自动更新。
    *   无需手动下载 `ip.txt`，无需运行额外的更新脚本。
*   **🌍 多源容错机制**：
    *   集成 **BGPView, HackerTarget, IPDeny, Ripe Stat, Dataplane** 等 6 个数据源。
    *   自动轮询，一旦某个源不可用（如被墙），毫秒级切换至备用源。
    *   内置静态保底网段，确保极端网络环境下仍能运行。
*   **⚡ 高性能异步扫描**：
    *   基于 `asyncio` + `aiohttp`，支持高并发探测。
    *   智能采样算法：小网段全取，大网段步进抽样，平衡速度与覆盖率。
*   **📊 双重报告输出**：
    *   **详细测速版**：按域名分组，展示 Top 3 IP 及延迟。
    *   **纯净配置版**：仅展示每个域名最快 IP，一键复制用于 SwitchHosts 或系统 hosts。
*   **🛡️ 代理友好**：原生支持 HTTP/SOCKS5 代理，适应各种网络环境。

---

## 🚀 快速开始

### 1. 环境要求

*   Python 3.8 或更高版本
*   pip (Python 包管理工具)

### 2. 安装依赖

克隆项目或下载代码后，进入目录安装依赖：

```bash
pip install -r requirements.txt
```

**依赖说明 (`requirements.txt`)：**
```text
aiohttp>=3.9.0      # 异步 HTTP 客户端
netaddr>=0.8.0      # IP 地址处理与 CIDR 解析
colorama>=0.4.6     # 跨平台彩色终端输出
```

### 3. 一键运行 (推荐)

无需准备 IP 文件，程序会自动获取最新 IP 并扫描。

**请确保你的代理软件已开启**（如果直连 Google 困难），然后运行：

```bash
# 默认使用 http://127.0.0.1:7890 代理 (请根据实际情况修改端口)
python main.py -p http://127.0.0.1:7890
```

**运行流程：**
1.  🔄 **自动更新**：连接全球数据源，获取最新 Google IP 段 (~2 秒)。
2.  🧠 **智能采样**：生成 2000 个高质量候选 IP。
3.  ⚡ **并发扫描**：测试所有候选 IP 的延迟。
4.  📝 **输出结果**：生成详细报告和纯净版 hosts 配置。

---

## ⚙️ 参数说明

| 参数 | 简写 | 默认值 | 说明 |
| :--- | :--- | :--- | :--- |
| `--proxy` | `-p` | `None` | **必填 (国内用户)**。代理服务器地址。格式：`http://host:port` 或 `socks5://host:port`。 |
| `--timeout` | `-t` | `5` | 单个请求的超时时间（秒）。网络较差时可适当调大 (如 8 或 10)。 |
| `--ips` | `-i` | `ip.txt` | (可选) 指定已有的 IP 列表文件。若不提供，程序会自动生成新的。 |

### 使用示例

#### 场景 A：使用 HTTP 代理 (最常见)
```bash
python main.py -p http://127.0.0.1:7890
```

#### 场景 B：使用 SOCKS5 代理
```bash
python main.py -p socks5://127.0.0.1:1080
```

#### 场景 C：调整超时时间 (网络极差时)
```bash
python main.py -p http://127.0.0.1:7890 -t 10
```

#### 场景 D：使用本地已有的 IP 文件 (跳过自动更新)
*注：虽然程序默认会尝试更新，但如果提供此参数且更新失败，会优先使用此文件。*
```bash
python main.py -i my_custom_ips.txt -p http://127.0.0.1:7890
```

---

## 📤 输出示例

程序运行结束后，控制台将输出两部分内容：

### 1. 详细测速报告
```text
============================================================
生成 hosts 配置 (按域名分组 - 取最快前3个IP)
============================================================

# --- Domain: translate.google.com ---
142.251.222.13 translate.google.com # Latency: 343.21ms
142.251.222.23 translate.google.com # Latency: 364.76ms
...

扫描结束，总耗时：1分 25.43秒
```

### 2. 纯净版 Hosts 配置 (推荐复制)
```text
=== 纯净版 Hosts 配置 (直接复制可用) ===
------------------------------------------------------------
142.251.222.13 translate.google.com
142.251.222.13 translate.googleapis.com
142.250.205.23 translate-pa.googleapis.com
142.251.222.23 jnn-pa.googleapis.com
------------------------------------------------------------
```

---

## 🛠️ 高级配置 (可选)

### 修改采样数量
默认每次扫描生成 **2000** 个 IP。如需修改，可编辑 `main.py` 头部常量：

```python
# 在 main.py 中找到以下行并修改数值
SAMPLE_SIZE = 2000  # 改为 3000 或 5000
```
*注意：数量越大，扫描耗时越长，但找到优质 IP 的概率略增。通常 2000 已足够。*

### 修改目标 ASN
本工具专为 Google (AS15169) 优化。如需扫描其他服务，可修改：
```python
TARGET_ASN = "15169"  # 改为其他 ASN 号码
```
*注意：需确保内置的数据源 API 支持该 ASN 查询。*

---

## ⚠️ 注意事项

1.  **代理依赖**：
    *   在中国大陆地区，**必须**使用 `-p` 参数指定代理，否则无法获取 IP 列表（API 被墙）且扫描会全部超时。
    *   扫描出的 IP 是用于**直连**优化的。即使扫描时使用了代理，生成的 IP 填入 hosts 后也是直连流量（不经过代理）。

2.  **SSL 证书验证**：
    *   工具内部禁用了 SSL 证书验证 (`ssl=False`)。这是因为我们直接连接 IP 地址，而 SSL 证书是颁发给域名的，直接连 IP 会触发证书不匹配错误。这是正常行为，不影响连通性判断。

3.  **IP 时效性**：
    *   由于程序每次启动都会**自动获取最新 IP**，因此无需担心 IP 过期问题。建议每次使用前都运行一次本工具。

4.  **合规使用**：
    *   本工具仅供网络研究与学习使用。请遵守当地法律法规及 Google 的服务条款。

---

## 📄 许可证

本项目采用 **MIT** 许可证。详见 [LICENSE](LICENSE) 文件。

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！
代码风格遵循 **阿里巴巴 Python 开发规范**。

*   保持异步逻辑的整洁。
*   新增功能请确保有完善的异常处理。
*   提交前请测试自动更新功能在不同网络环境下的表现。

---

**Author**: YourName  
**Last Updated**: 2026-03-02  
**Version**: 2.0 (Auto-Update Integrated)