
pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c
Pingtunnel — это инструмент, который передаёт TCP/UDP-трафик через ICMP.
Pingtunnel
Pingtunnel — это сетевой инструмент, который туннелирует трафик TCP/UDP/SOCKS5 через пакеты ICMP Echo (Ping), чтобы обходить строгие сетевые межсетевые экраны или ограничиваемый трафик TCP/UDP.
⚠️ Примечание: Этот инструмент строго предназначен для учебных и исследовательских целей. Не используйте его в каких-либо незаконных целях.

🌟 Возможности
- Единая архитектура безопасности 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