极安代理 - 隧道代理Go语言接入指南

## 概述

本文档将指引你进行隧道代理的接入，在此文档中使用到的术语将会在下方进行列出。

| 术语     | 解释                                       |
| :------- | :----------------------------------------- |
| 隧道     | 自动更换代理 IP 的代理服务                 |
| 固定时长 | 服务器将在固定时长后自动切换IP，例如1分钟  |
| 通道     | 使用多个通道同时发起请求，每个通道的IP不同 |

隧道代理有多种使用方式，具体行为取决于套餐及模式。

- **普通模式**：每次请求都自动切换IP
- **普通模式打标记**：普通模式下，希望多个HTTP请求保证代理IP相同，可以给多个请求的代理协议打上相同的标记，并标记这个代理IP的存活时间

## 前置知识

在 go 语言中，通常使用 http.Client 进行 http/s 代理的设定与请求的发送，使用 http.NewRequest 进行请求的构建。

### Proxy Url Scheme

由协议、用户名、密码、域名、端口几部分组成。

例如 http 协议的代理 url：

```
http://[user:password@]hostname:port
```

## 使用 GO 接入

**以下内容假设读者具备基本的 Go 语言编程能力和对网络协议具有一定的了解。**

### 生成 url

**普通模式**

```go
link := fmt.Sprintf("http://%s:%s@%s", authKey, password, proxyServer)
proxyURL, _ := url.Parse(link)
```

**普通模式打标记**

```go
link := fmt.Sprintf("http://%s:%s:%s:%d@%s", authKey, password, "channel-1", 20, proxyServer)
proxyURL, _ := url.Parse(link)
```

### 构建 
Client后续将使用该 client 发起 request。

```go
client := http.Client{
    Transport: &http.Transport{
        Proxy: http.ProxyURL(proxyURL),
    },
}
```

### 构建 HTTP/s GET 请求

以 https://api.ipify.org 为例。

因为已确认参数合法，因此构建不会发生错误，无需处理错误。

```go
request, _ := http.NewRequest("GET", "https://test.ipw.cn", nil)
// 如果上面目标站不可用，请使用ip.sb、ipinfo.io、ip-api.com、64.ipcheck.ing
```

### 执行已构建的 HTTP/s 请求
```
response, err := client.Do(request)
if err != nil {
    panic(err)
}

defer response.Body.Close()
```
### 读取响应实体

```
response.Body 是 io.Reader 类型，需要手动进行读取。
body, err := io.ReadAll(response.Body)
if err != nil {
    panic(err)
}

fmt.Println(string(body))
```

### 示例代码
```
package main

import (
    "fmt"
    "io"
    "log"
    "net/http"
    "net/url"
)

const (
    authKey  = ""
    password = ""
    server   = ""
    channel  = "channel-1"
)

func main() {
    var link string
    if channel == "" {
        link = fmt.Sprintf("http://%s:%s@%s", authKey, password, server)
    } else {
        link = fmt.Sprintf("http://%s:%s:%s@%s", authKey, password, channel, server)
    }
    proxyURL, _ := url.Parse(link)

client := http.Client{
        Transport: &http.Transport{
            Proxy: http.ProxyURL(proxyURL),
        },
    }

request, _ := http.NewRequest("GET", "https://test.ipw.cn", nil)
    // 如果上面目标站不可用，请使用ip.sb、ipinfo.io、ip-api.com、64.ipcheck.ing
    response, err := client.Do(request)
    if err != nil {
        panic(err)
    }
    defer response.Body.Close()

body, err := io.ReadAll(response.Body)
    if err != nil {
        panic(err)
    }

log.Println("response body", string(body))
}
```