Назад к обновлениям
New releaseSep 12, 2026

pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c

Pingtunnel — это инструмент, который передаёт TCP/UDP-трафик через ICMP.

Поделиться

Pingtunnel

codecov

Pingtunnel — это сетевой инструмент, который туннелирует трафик TCP/UDP/SOCKS5 через пакеты ICMP Echo (Ping), чтобы обходить строгие сетевые межсетевые экраны или ограничиваемый трафик TCP/UDP.

⚠️ Примечание: Этот инструмент строго предназначен для учебных и исследовательских целей. Не используйте его в каких-либо незаконных целях.

image


🌟 Возможности

  • Единая архитектура безопасности v3: старый числовой ключ и отдельные переключатели шифрования удалены. Единый общий пароль (-password) обеспечивает взаимную аутентификацию и сквозное AEAD-шифрование (по умолчанию chacha20-poly1305, опционально aes256/aes128).
  • Несколько режимов:
    • Прокси SOCKS5: запуск локального прокси SOCKS5 одной командой, с опциональной аутентификацией по имени пользователя и паролю;
    • Перенаправление TCP-портов: доступ к определённому удалённому TCP-порту (например, SSH, web, RDP);
    • Перенаправление UDP-портов: перенаправление игрового UDP-трафика, DNS 53 и т. д.;
    • Вторичное перенаправление на стороне сервера (-forward): сервер может передавать входящий трафик через вышестоящий прокси SOCKS5/HTTP.
  • Гибкая конфигурация (рекомендуется режим файла конфигурации):
    • Запуск напрямую с файлом конфигурации: pingtunnel config.json или pingtunnel -c config.json;
    • config.json в текущем каталоге загружается автоматически по умолчанию;
    • Флаги командной строки всегда переопределяют соответствующие значения из файла конфигурации.
  • Устойчивость в плохих сетях: встроенный алгоритм адаптивного к пропускной способности управления перегрузкой (bb) подавляет bufferbloat и задержки, вызванные потерей пакетов.

🚀 Быстрый старт

Вариант 1: Режим файла конфигурации (рекомендуется)

Примеры файлов поставляются вместе с репозиторием. Просто укажите IP-адрес вашего сервера и надёжный пароль:

1. Конфигурация сервера (config-server.json)

{
  "type": "server",
  "password": "YOUR_STRONG_PASSWORD_HERE",
  "encrypt": "chacha20",
  "icmp_listen": "0.0.0.0"
}

Запустите сервер (требуются права root / администратора):

sudo ./pingtunnel config-server.json
# or: sudo ./pingtunnel -c config-server.json

2. Конфигурация клиента (режим SOCKS5-прокси, config-client-socks5.json)

{
  "type": "client",
  "listen": "127.0.0.1:1080",
  "server": "YOUR_SERVER_IP",
  "socks5": true,
  "password": "YOUR_STRONG_PASSWORD_HERE",
  "encrypt": "chacha20"
}

Запустите клиент:

./pingtunnel config-client-socks5.json
# or: ./pingtunnel -c config-client-socks5.json

Затем настройте браузер или системный прокси на SOCKS5 127.0.0.1:1080.


Вариант 2: Командная строка (CLI)

1. Запустите сервер

Выполните на машине с публичным IP:

sudo ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE

(Необязательно) Отключите стандартные ответы на ICMP echo в ядре Linux, чтобы избежать помех:

echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all

2. Запуск клиента

  • Режим SOCKS5-прокси:
    ./pingtunnel -type client -l 127.0.0.1:1080 -s YOUR_SERVER_IP -socks5 -password YOUR_STRONG_PASSWORD_HERE
    
  • Перенаправление TCP-портов (режим по умолчанию, например, сопоставление удалённого внутреннего 192.168.1.100:22 с локальным портом 2222):
    ./pingtunnel -type client -l :2222 -s YOUR_SERVER_IP -t 192.168.1.100:22 -password YOUR_STRONG_PASSWORD_HERE
    
  • Перенаправление UDP (например, локальный порт 5353 на публичный DNS 8.8.8.8:53):
    ./pingtunnel -type client -l :5353 -s YOUR_SERVER_IP -t 8.8.8.8:53 -udp -password YOUR_STRONG_PASSWORD_HERE
    

🐳 Docker

Запуск сервера

docker run --name pingtunnel-server -d \
  --restart=always \
  --privileged \
  --network host \
  esrrhs/pingtunnel ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE

Запуск со смонтированным файлом конфигурации

docker run --name pingtunnel-server -d \
  --restart=always \
  --privileged \
  --network host \
  -v /etc/pingtunnel/server.json:/app/server.json:ro \
  esrrhs/pingtunnel ./pingtunnel /app/server.json

📖 Подробное руководство по использованию и настройке

Дополнительные параметры и топологии (серверный вторичный прокси, проброс портов, аутентификация SOCKS5, управление потоком и настройка перегрузки) см. в: 👉 USAGE.md — Руководство по использованию и настройке Pingtunnel

Категории