Skip to content

Mihai-CMM/DockerizedWireshark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 

Repository files navigation

How to Dockerize Wireshark

Since last weekend was a rainy and boring one, in my part of the world, I decided to upgrade my laptop running Fedora 23 to Fedora 24. After encountering a few problems with the straight upgrade, I ended up reinstalling Fedora 24 from scratch. To save my old data I mounted /home directory to the old /home directory (without re-formatting the old partition) when prompted during installation. Long story short, after upgrading I discovered that Wireshark needed to be built from sources for this version of Fedora. So, I decided to take advantage of the powerful tool called Docker.

My idea was to build a Docker container that would run Wireshark inside, would be able to capture data on the host network interface and would forward GUI to my host machine. I was glad I remembered how X11 works and learned how can you actually use a GUI app inside a Docker container.

Here are some useful links I used to document this implementation:

http://www.linuxquestions.org/questions/linux-server-73/can't-open-display-no-protocol-specified-using-gdm-4175462031/

https://forums.docker.com/t/how-to-run-gui-app-inside-the-containers/2895/3

http://www.linuxquestions.org/questions/linux-server-73/can't-open-display-no-protocol-specified-using-gdm-4175462031/

http://www.yolinux.com/TUTORIALS/GDM_XDMCP.html

http://dustwell.com/how-x-over-ssh-really-works.html

https://blog.docker.com/2013/07/docker-desktop-your-desktop-over-ssh-running-inside-of-a-docker-container/

Containers

Let’s have a look at the Dockerfile used to build the wanted wireshark image:

From ubuntu:16.04
MAINTAINER Mihai <[email protected]>
# Installing required additional software
RUN apt-get update -y
RUN apt-get install wget bzip2 -y # needed for wireshark download
RUN apt-get install gcc python -y
RUN apt-get install perl pkg-config libglib2.0-dev libpcap-dev gtk2.0 -y
#Download and build latest wireshark
RUN wget https://1.eu.dl.wireshark.org/src/wireshark-2.2.1.tar.bz2
RUN tar -jxf wireshark-2.2.1.tar.bz2
RUN /wireshark-2.2.1/configure && make && make install
RUN ldconfig
ENTRYPOINT ["wireshark-gtk"]

Let’s break down the Dockerfile to see what’s going on.

I decided to install Wireshark on Ubuntu 16.04 (inside the container):

From ubuntu:16.04

After that I needed to update Ubuntu container and install some prerequisites to be able to install wireshark:

RUN apt-get install wget bzip2 -y # needed for wireshark download

RUN apt-get install gcc python -y

RUN apt-get install perl pkg-config libglib2.0-dev libpcap-dev gtk2.0 -y

Next step was to grab the wireshark sources archive; unzip it and execute the well known ./configure && make && make install procedure to build it from sources. Note that you need to provide the absolute path :

RUN wget https://1.eu.dl.wireshark.org/src/wireshark-2.2.1.tar.bz2

RUN tar -jxf wireshark-2.2.1.tar.bz2

RUN /wireshark-2.2.1/configure && make && make install

RUN ldconfig

The final step was to designate an entry point (a default action that will be execute when this image will be instantiated):

ENTRYPOINT ["wireshark-gtk"]

** How to use it**

To use this container you will need to have Docker up and running on your host machine:

$ service docker status

Redirecting to /bin/systemctl status  docker.service
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; disabled; vendor preset: disabled)
   Active: active (running) since Mon 2016-10-10 09:17:41 EEST; 42min ago
 	Docs: https://docs.docker.com

You then need to run below command to allow all X clients to connect to your X11 server:

$ sudo xhost +
access control disabled, clients can connect from any host

Go ahead and download the image with:

$ docker pull costache2mihai/dockerizedwiresharkformsources

Now you can run it (start a container based on that image) with:

$ docker run -ti --net=host --privileged -v /home/mcostache/Ezuce:/root -w /root -e DISPLAY=$DISPLAY costache2mihai/dockerizedwiresharkformsources

Note that I’ve mounted a volume (folder /home/mcostache/Ezuce ) where I have stored some pcap’s.

If all goes well, on your screen you will see a window like:

wireshark

Running container with “--net=host --privileged“ options allows us to capture traffic from host machine interfaces, and since we mounted a folder with pcap’s we can open those capture to analyze traffic.

If you decide to use this container and improve it, don’t forget to share back to the community. We at eZuce love open-source!

Blog article here: http://sipxcom.org/how-to-dockerize-wireshark/

READ these useful links:

http://www.linuxquestions.org/questions/linux-server-73/can't-open-display-no-protocol-specified-using-gdm-4175462031/ https://forums.docker.com/t/how-to-run-gui-app-inside-the-containers/2895/3 http://www.linuxquestions.org/questions/linux-server-73/can't-open-display-no-protocol-specified-using-gdm-4175462031/ http://www.yolinux.com/TUTORIALS/GDM_XDMCP.html http://dustwell.com/how-x-over-ssh-really-works.html https://blog.docker.com/2013/07/docker-desktop-your-desktop-over-ssh-running-inside-of-a-docker-container/

To use it :

docker build -t {your tagname for image} .

then on the host you need to :

$ sudo xhost + # at least on my fedora 24 $ XSOXK=/tmp/.X11-unix/X0

$ docker run -ti --net=host --privileged -v {Your pcap folders if you want to- noit necessary}:/root -w /root -v $XSOXK:$XSOXK -e DISPLAY=$DISPLAY wire2.2.1

Ex:docker run -ti --net=host --privileged -v /home/mihai/DOCUMENTELE_MELE/ezuce/6249:/root -w /root -v $XSOXK:$XSOXK -e DISPLAY=$DISPLAY -e XAUTHORITY=$XAUTHORITY wire2.2.1

About

Use wireshark inside a ubuntu 16:04 container

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published