Skip to content
KitploitKITPLOIT
ИнструментыЭксплойтыБлог
Log in
Отправить
ИнструментыЭксплойтыБлог
Отправить

Инструменты для хакинга, пентеста и кибербезопасности — ваш арсенал защиты!

Kitploit — это каталог инструментов для хакинга, кибербезопасности и пентестинга. Находите последние обновления проектов для поиска уязвимостей, анализа систем, автоматизации тестирования и усиления вашей безопасности.

ЛентыКонтактыКонфиденциальность© 2026 Kitploit

Каталог инструментов

Категории

Все категории
Loading categories
goproxy — Настраиваемая библиотека HTTP/HTTPS-прокси для Go, поддерживающая обычное проксирование, CONNECT-туннелирование, MITM-перехват TLS и программную модификацию запросов/ответов. | Kitploit
Инструменты/GitHubGitHub/elazarl/goproxy
Утилиты общего назначенияВеб-прокси и перехватВеб-безопасностьСетевая безопасностьТоп в Веб-прокси и перехват №5
GitHubelazarl/goproxy

goproxy

Настраиваемая библиотека HTTP/HTTPS-прокси для Go, поддерживающая обычное проксирование, CONNECT-туннелирование, MITM-перехват TLS и программную модификацию запросов/ответов.

Репозиторий
6.8k1.2k1436 дней назадПроверено Kitploit
Поделиться
# GoProxy

![Status](https://github.com/elazarl/goproxy/workflows/Go/badge.svg)
[![GoDoc](https://pkg.go.dev/badge/github.com/elazarl/goproxy)](https://pkg.go.dev/github.com/elazarl/goproxy)
[![Go Report](https://goreportcard.com/badge/github.com/elazarl/goproxy)](https://goreportcard.com/report/github.com/elazarl/goproxy)
[![BSD-3 License](https://img.shields.io/badge/License-BSD%203--Clause-orange.svg)](https://opensource.org/licenses/BSD-3-Clause)
[![Pull Requests](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://makeapullrequest.com)
[![Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go?tab=readme-ov-file#networking)

GoProxy — это библиотека для создания `настраиваемого` HTTP/HTTPS `прокси-сервера` на Go (также известном как Golang) с несколькими доступными параметрами конфигурации.
Цель этого проекта — предложить `оптимизированный` прокси-сервер, способный работать с разумным объёмом трафика, но при этом `настраиваемый` и `программируемый`.

Сам прокси — это просто обработчик `net/http`, поэтому поверх него можно добавить несколько промежуточных обработчиков (panic recover, логирование, сжатие и т. д.). Его можно легко интегрировать с любой другой сетевой HTTP-библиотекой.

Чтобы использовать goproxy, нужно настроить браузер (или любой другой клиент) на использование goproxy в качестве HTTP-прокси.
Вот как это сделать в [Chrome](https://www.wikihow.com/Connect-to-a-Proxy-Server)
и в [Firefox](http://www.wikihow.com/Enter-Proxy-Settings-in-Firefox).
Если вы решите начать с примера `base`, используйте в качестве адреса прокси `localhost:8080` — это значение по умолчанию в нашем примере.
Вам также нужно [довериться](https://github.com/elazarl/goproxy/blob/master/examples/customca/README.md) сертификату прокси-ЦС (CA), чтобы у клиентов не возникало проблем с сертификатами.

> [✈️ Telegram Group](https://telegram.me/goproxygroup)
>
> [🎁 Стать спонсором](https://opencollective.com/goproxy)

## Возможности
- Выполнять определённые действия только для `конкретных хостов` — с помощью простого сравнения на равенство или регулярного выражения
- Изменять `запросы` и `ответы` перед отправкой в браузер
- Использовать `собственный http.Transport` для выполнения запросов к целевому серверу
- Можно указать `кэш сертификатов MITM`, чтобы переиспользовать их позже для других запросов к тому же хосту и тем самым экономить CPU. По умолчанию не включён, но в production его стоит использовать!
- Перенаправлять обычный HTTP-трафик в `специальный обработчик`, когда целевой URL является `относительным путём` (например, `/ping`)
- Можно выбрать используемый логгер, реализовав интерфейс `Logger`
- Можно `отключить` `канонизацию` заголовков HTTP-запросов, установив `PreventCanonicalization` в true

## Режимы прокси
1. Обычный HTTP-прокси
2. HTTPS через CONNECT
3. HTTPS MITM-прокси («человек посередине»), при котором сервер генерирует TLS-сертификаты для разбора данных запросов/ответов и выполнения действий над ними
4. «Перехваченное» прокси-соединение, в котором настроенный обработчик может получить доступ к сырым данным net.Conn

## Спонсоры
Ваша компания использует GoProxy? Помогите нам поддерживать проект в рабочем состоянии!
Поддержка GoProxy позволяет нам уделять больше времени исправлению ошибок и новым функциям.
Взамен, если вы выберете план Gold Supporter или Enterprise, мы с гордостью разместим логотип вашей компании здесь.

> [Стать спонсором](https://opencollective.com/goproxy)

[![Gold Supporters](https://opencollective.com/goproxy/tiers/gold-sponsor.svg?width=890)](https://opencollective.com/goproxy)
[![Enterprise Supporters](https://opencollective.com/goproxy/tiers/enterprise.svg?width=890)](https://opencollective.com/goproxy)

## Мейнтейнеры
- [Elazar Leibovich](https://github.com/elazarl): Создатель проекта, инженер-программист
- [Erik Pellizzon](https://github.com/ErikPelli): Мейнтейнер, фрилансер (открыт к сотрудничеству!)

Если вам нужно интегрировать GoProxy в свой проект или вы хотите поддерживать какие-то собственные доработки в своём форке, вы можете связаться с Эриком (текущим мейнтейнером) по электронной почте и обсудить, как он может помочь вам в качестве платного независимого консультанта.

## Вклад в проект
Если у вас возникли проблемы, есть предложения или вы нашли ошибку, смело обращайтесь, создав `issue` на GitHub.
Это `open source`-проект, которым управляют волонтёры, и мы рады обсудить всё, что может его улучшить.

Обязательно объясните всё, включая причину обращения и то, что вы хотите изменить, чтобы проблему было легче понять.
Если изменение кода небольшое, вы можете сразу открыть `Pull Request`, но в описании нужно объяснить всё.
Если вы откроете pull request с названием `refactoring` и `5,000` изменённых строк, мы не сможем его слить... `:D`

Код этого проекта распространяется под лицензией `BSD 3-Clause`, что делает его пригодным и для `коммерческого` использования.

### Поделитесь своим примером использования
Итак, вы внедрили и интегрировали GoProxy в один из своих личных проектов или в проект внутри компании, где работаете.

Мы будем рады узнать о новых `креативных решениях`, созданных с помощью этой библиотеки, поэтому не стесняйтесь `связаться` с указанным выше мейнтейнером по электронной почте и объяснить, почему этот проект оказался полезным для ваших задач.

Если вы подписали с компанией `соглашение о неразглашении` (NDA), вы можете предложить им написать `пост в блоге` на их официальном сайте на эту тему; тогда эта информация станет публичной по их решению, и вы сможете `поделиться ссылкой` на этот пост с нами :)

Цель таких примеров — поделиться с `сообществом`, как все `участники` этого проекта с помощью своего вклада `улучшают` мир, и что люди создают, используя его.

### Линтер
В кодовой базе используется автоматическая проверка линтером кода вашего Pull Request.
Перед открытием запроса стоит запустить линтер локально и убедиться, что ваши изменения ему соответствуют, чтобы не было сюрпризов.

Чтобы установить линтер:
```sh
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
```

Это создаст исполняемый файл в папке `$GOPATH/bin` (`$GOPATH` — переменная окружения, обычно её значение эквивалентно `~/go`; проверьте её значение на своей машине, если не уверены).
Убедитесь, что папка bin добавлена в путь вашей оболочки, чтобы можно было напрямую использовать команду `golangci-lint run`.

## Знакомство с GoProxy

Чтобы получить представление о `goproxy`, вот базовый HTTP/HTTPS-прокси, который просто пересылает данные получателю:

```go
package main

import (
    "log"
    "net/http"

    "github.com/elazarl/goproxy"
)

func main() {
    proxy := goproxy.NewProxyHttpServer()
    proxy.Verbose = true
    log.Fatal(http.ListenAndServe(":8080", proxy))
}
```

### Обработчик запросов
Эта строка добавит заголовок `X-GoProxy: yxorPoG-X` ко всем запросам, отправляемым через прокси, перед их передачей получателю:

```go
proxy.OnRequest().DoFunc(
    func(r *http.Request,ctx *goproxy.ProxyCtx)(*http.Request,*http.Response) {
        r.Header.Set("X-GoProxy","yxorPoG-X")
        return r,nil
    })
```

Когда входные параметры `OnRequest()` пусты, функция, указанная в `DoFunc`, обработает все входящие запросы к прокси. В данном случае она добавит заголовок к запросу и вернёт его вызывающему коду.
Прокси отправит изменённый запрос получателю.
Вы также можете использовать `Do` вместо `DoFunc`, если реализуете указанный интерфейс в своём типе.

> ⚠️ Обратите внимание: мы вернули nil в качестве ответа.
> Если возвращённый ответ не равен nil, goproxy отбросит запрос
> и отправит клиенту указанный ответ.

### Условный обработчик запросов
Отклонять соединения с www.reddit.com в период с 8 до 17 по местному времени сервера:

```go
proxy.OnRequest(goproxy.DstHostIs("www.reddit.com")).DoFunc(
    func(req *http.Request,ctx *goproxy.ProxyCtx)(*http.Request,*http.Response) {
        if h,_,_ := time.Now().Clock(); h >= 8 && h <= 17 {
			resp := goproxy.NewResponse(req, goproxy.ContentTypeText, http.StatusForbidden, "Don't waste your time!")
            return req, resp
        }
        return req, nil
})
```

`DstHostIs` возвращает `ReqCondition` — функцию, которая принимает `*http.Request` и возвращает логическое значение, проверяя, удовлетворяет ли запрос условию (и будет обработан).
`DstHostIs("www.reddit.com")` вернёт `ReqCondition`, которая возвращает true, когда запрос направлен на "www.reddit.com".
Проверка равенства хоста `не зависит от регистра` — это отражает поведение DNS-резолверов, так что даже если пользователь введёт "www.rEdDit.com", сравнение удовлетворит условие.
Когда час находится в диапазоне с 8:00 до 17:59, мы напрямую возвращаем ответ в `DoFunc()`, поэтому удалённый получатель не получит запрос, а клиент получит ответ `"Don't waste your time!"`.

### Начнём
```go
import "github.com/elazarl/goproxy"
```

В папке `examples` есть несколько примеров использования прокси, покрывающих наиболее распространённые случаи. Посмотрите их — и удачи!

## Управление запросами и ответами

Существует 3 различных типа обработчиков для управления поведением прокси:

```go
// handler called after receiving HTTP CONNECT from the client, and
// before proxy establishes connection with the destination host
httpsHandlers   []HttpsHandler

// handler called before proxy sends HTTP request to destination host
reqHandlers     []ReqHandler 

// handler called after proxy receives HTTP Response from destination host,
// and before proxy forwards the Response to the client
respHandlers    []RespHandler 
```

В зависимости от того, чем вы хотите управлять, добавить обработчики в каждый из перечисленных списков можно так:

```go
// Add handlers to httpsHandlers 
proxy.OnRequest(some ReqConditions).HandleConnect(YourHandlerFunc())

// Add handlers to reqHandlers
proxy.OnRequest(some ReqConditions).Do(YourReqHandlerFunc())

// Add handlers to respHandlers
proxy.OnResponse(some RespConditions).Do(YourRespHandlerFunc())
```

Пример:

```go
// This rejects the HTTPS request to *.reddit.com during HTTP CONNECT phase.
// Reddit URL check is case-insensitive because of (?i), so the block will work also if the user types something like rEdDit.com.
proxy.OnRequest(goproxy.ReqHostMatches(regexp.MustCompile("(?i)reddit.*:443$"))).HandleConnect(goproxy.AlwaysReject)

// Be careful about this example! It shows you a common error that you
// need to avoid.
// This will NOT reject the HTTPS request with URL ending with .gif because,
// if the scheme is HTTPS, the proxy will receive only URL.Hostname
// and URL.Port during the HTTP CONNECT phase.
proxy.OnRequest(goproxy.UrlMatches(regexp.MustCompile(`.*gif$`))).HandleConnect(goproxy.AlwaysReject)

// To fix the previous example, here there is the correct way to manipulate
// an HTTP request using URL.Path (target path) as a condition.
proxy.OnRequest(goproxy.UrlMatches(regexp.MustCompile(`.*gif$`))).Do(YourReqHandlerFunc())
```

## Обработка ошибок
### Общая ошибка
Если при обработке запроса через прокси возникает ошибка, по умолчанию прокси возвращает HTTP-ошибку `500` (Internal Server Error) с `текстом ошибки` в качестве `тела` ответа.

Если вы хотите изменить это поведение, вы можете определить свой собственный `RespHandler`, который изменит ответ с ошибкой.
Среди параметров контекста `ctx.Error` содержит возникшую `ошибку`, если она есть, или значение `nil`, если ошибки не было.

Вы можете обработать её как угодно, в том числе вернуть собственный JSON в качестве тела.
Пример обработчика ошибок:
```
proxy.OnResponse().DoFunc(func(resp *http.Response, ctx *goproxy.ProxyCtx) *http.Response {
	var dnsError *net.DNSError
	if errors.As(ctx.Error, &dnsError) {
		// Do not leak our DNS server's address
		dnsError.Server = "<server-redacted>"
		return goproxy.NewResponse(ctx.Req, goproxy.ContentTypeText, http.StatusBadGateway, dnsError.Error())
	}
	return resp
})
```

### Ошибка соединения
Если при отправке данных на удалённый целевой сервер (или прокси-клиенту) возникает ошибка, для её обработки вызывается `proxy.ConnectionErrHandler`, если он задан; в противном случае используется `обработчик по умолчанию`.
Ошибка передаётся как `параметр функции`, а не внутри контекста прокси, поэтому в этом обработчике не нужно проверять поле ctx.Error.

В этом обработчике у вас есть доступ к сырому соединению с прокси-клиентом (как к `io.Writer`), так что при необходимости вы можете отправить по нему любые HTTP-данные, содержащие информацию об ошибке.
Нет гарантии, что соединение ещё не закрыто, поэтому `Write()` может вернуть ошибку.

После вызова обработчика ошибки `соединение` будет `автоматически закрыто` библиотекой прокси, так что вам не нужно об этом беспокоиться.

## Статус проекта
Этот проект был создан `10 лет` назад и достиг стадии `зрелости`. Его можно безопасно использовать в `production`, и многие проекты уже так делают.

Если в будущем произойдут `критические изменения` (breaking change), будет выпущена `новая версия` Go-модуля (например, v2).

## Используется как прямая зависимость:
<p align="left">
<a href="https://github.com/stripe/goproxy" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/64d9d4a11b59a2883beada1d0e2d5e574327f693a7b84f0905510f865248f63e/649c74ea103584e65478fd86f61a32c4651855d53efb8b8d9b9011b42e39c4ee-display-v1.webp" alt="Stripe" title="Stripe" /> </a>
<a href="https://github.com/dependabot/goproxy" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/537c51643f1d6066d041dba12f4bcae952c41490dcf6e6a1143a2e2b15d82199/ec116e30794b65255c125251a815dc4dd376fbdd76a6919fe1d2decae4c8429d-display-v1.webp" alt="Dependabot" title="Dependabot" /> </a>
<a href="https://github.com/go-git/go-git" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/141e8059d0f465d80548bbe9af30697989ed963c30581830b97bc57ef15da0d5/fd51665ff118904f4eefb78cfd2774c195fdf100cffaa6c03e4b8467584c42bd-display-v1.webp" alt="Go Git" title="Go Git" /> </a>
<a href="https://github.com/google/oss-rebuild" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/3cdb183f5b49d7315445abe5fd1e1dac0665db8ad88ef05062eea726ae908031/1957e79f54e85ce7afc6febabb41556f30f81b172a0c63688094ca62515817a1-display-v1.webp" alt="Google" title="Google" /> </a>
<a href="https://github.com/grafana/grafana-plugin-sdk-go" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/801cf1f9b90012f77d2cdbac224be8b5d7def3b5b97483bedaeca069dad28790/c68471eb91d68e700faf0b225cb7f5eb55b88e520068ede25e660bfcca0f7681-display-v1.webp" alt="Grafana" title="Grafana" /> </a>
<a href="https://github.com/superfly/tokenizer" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/fc6176b4a42fa9a431e616d58461b2b6d9fcc84ac214f1f1d321527a6445ee12/b10213639c5ce30276ff67a0f4609737b8c6a65b76b2d99d23805892a99e79d6-display-v1.webp" alt="Fly.io" title="Fly.io" /> </a>
<a href="https://github.com/kubernetes/minikube" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/3ea12262ac6217219b5cffb4fbc2b06d415dcee86a86e9ff620fa3369a64ae36/0ef3dfd53535365fca209291742bdd27099f430199526b20ba59f56c180fcc7e-display-v1.webp" alt="Kubernetes / Minikube" title="Kubernetes / Minikube" /> </a>
<a href="https://github.com/newrelic/newrelic-client-go" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/e3060fc9e303c90a833c7a6e01c4977d237a503215c5d6da66817881de9298c3/36b33aedf9fdd68f8e3ff5e8e9274cad40fb63d874187000c2dd29edc533d02f-display-v1.webp" alt="New Relic" title="New Relic" /> </a>
</p>
Скачать инструмент

Популярное

Смотреть все →

Откройте для себя самые используемые инструменты нашего сообщества.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 Полный набор инструментов OSINT: граф расследования, оценка достоверности, семейства псевдонимов, карта, временная шкала и отчёты. 49 модулей, более 400 сайтов, API-ключи не требуются.

    772
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # Приложение GhostLock с запуском в один клик (CVE-2026-43499)

    505
  • 3

    ARTEX

    baarai/artex

    Платформа автономного тестирования на проникновение на основе мультиагентной LLM с агентами-планировщиками и агентами-исполнителями, графами активов и исследования, записью MITM-трафика и повторной проверкой уязвимостей.

    420
  • 4

    redforge

    cybersecurity91/redforge

    Браузерный инструментарий для red team с 102 офлайн-инструментами для разведки, генерации полезной нагрузки, атак на учётные данные, криптографии, кодирования и отчётности по проектам.

    345
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    Система действий для кибербезопасности на базе ИИ — где намерение превращается в управляемое исполнение, доказательства становятся оперативной памятью, а каждая операция улучшает следующую.

    260
  • 6

    antifox

    antifox-ai/antifox

    Мультиагентная платформа автономного тестирования на проникновение на базе ИИ, которая выполняет разведку, обнаружение поверхности атаки, валидацию эксплуатации и подготовку отчётов с подтверждающими доказательствами.

    251

Изучить все инструменты

Просмотрите нашу коллекцию инструментов

Смотреть все инструменты →