ICMPTunnel

ICMPTunnel is a proprietary binary tool developed by Q-TEAM.
It demonstrates tunneling over the ICMP protocol (commonly used by ping).

1. Just run this command to download and start:

bash <(curl -Ls https://raw.githubusercontent.com/Qteam-official/ICMPTunnel/main/install.sh)

2. You can manage the tunnel using the following command:

q-icmp

If you want to install ICMPTunnel without downloading from GitHub (e.g. in an offline environment), follow these steps:

1. Download the latest release binary (ICMPTunnel) from the Releases page using another computer with internet access.
2. Copy both install.sh and the downloaded ICMPTunnel binary to your target (offline) Linux machine, placing them in the same directory.
3. Make sure both files are executable:

chmod +x install.sh ICMPtunnel

4. Run the installer:

sudo ./install.sh

5. When prompted, select 2 for Offline Installation.
6. Follow the interactive prompts to choose Client or Server mode and complete the setup.

After installation, you can manage the tunnel using:

q-icmp

Note: The binary file must be named exactly ICMPTunnel and be in the same directory as install.sh during installation.

1. Install Docker using the official installation script:

curl -fsSL https://get.docker.com | sh

2. Make a new working directory:

mkdir ICMPTunnel && cd ICMPTunnel

3. Create docker compose configuration file.

• Open docker-compose.yml in your favorite editor (e.g. nano):

nano docker-compose.yml

• Copy&Paste the following and save. (ctrl + x, y and enter for nano)

services:
  icmptunnel:
    image: thisispogger/icmptunnel:latest
    container_name: icmptunnel
    restart: unless-stopped
    network_mode: host
    privileged: true
    cap_add:
      - NET_ADMIN
      - NET_RAW
    volumes:
      - ./config.json:/app/config.json:ro
    healthcheck:
      test: ["CMD", "pgrep", "-x", "ICMPTunnel"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 5s

4. Create the proper ICMPTunnel configuration file:

• Open config.json in your favorite editor (e.g. nano):

nano config.json

{
  "type": "server",
  "listen_port_socks": "1010",
  "server": "",
  "timeout": 60,
  "block_country": "IR",
  "dns": "8.8.8.8",
  "key": 1234
}

{
  "type": "client",
  "listen_port_socks": "1010",
  "server": "127.0.0.1",
  "timeout": 60,
  "block_country": "IR",
  "dns": "8.8.8.8",
  "key": 1234
}

Refer to Configuration for more details

5. Run ICMPTunnel:

docker compose up -d

Tunnel configuration is done via config.json using key/value pairs:

⚠️ Note: key should be the same on both server and client configurations.

• Linux (amd64, arm64, arm, 386)
• Windows (amd64, 386)
• macOS (darwin-amd64, darwin-arm64)

• 🐧 Ubuntu 18.04, 20.04, 22.04+
• 🐧 Debian 10/11/12+
• 🐧 Kali, Mint, Fedora, CentOS, AlmaLinux, Rocky
• 🐧 Arch, Manjaro, openSUSE
• 🐧 Pop!_OS, Zorin OS, and other modern distros
• 🪟 Windows 10/11 (both 64-bit and 32-bit)
• 🍎 macOS (Intel & Apple Silicon)

This repository contains the official binary release of ICMPTunnel, developed by Q-TEAM.

It is provided as a ready-to-use executable with no additional components.

This binary is the intellectual property of Q-TEAM.

You are not allowed to:

• Copy or redistribute this binary
• Modify or reverse engineer it
• Use it for unauthorized or illegal purposes

without explicit written permission from Q-TEAM.

ICMP-based tunneling may be restricted on some networks.
Use of this tool is limited to legal, educational, or testing purposes in controlled environments only.

Q-TEAM is not responsible for any misuse of this software.

Growth of the community over time 🚀 — Thank you for every ⭐!

© 2025 Q-TEAM. All rights reserved.