Scapy3.0 Documentation ( Download and Installation )

 

说明：写到这里来，只是因为原文链接打开太慢了，至于翻译什么的就不误导大家了，还是原文好看

原文链接：http://phaethon.github.io/scapy/api/installation.html

 

Download and Installation

Overview

1. Install Python 3.x.
2. Install Scapy using pip or by cloning/installing from git.
3. (For non-Linux platforms): Install libpcap and libdnet and their Python wrappers.
4. (Optional): Install additional software for special features.
5. Run Scapy with root priviledges.

Each of these steps can be done in a different way dependent on your platform and on the version of Scapy you want to use.

This document is for scapy3k. It requires python 3.x. See original scapy homepage <http://www.secdev.org/projects/scapy/> for Scapy v2.x or earlier.

Note

In scapy3k and Scapy v2.x use from scapy.all import * instead of from scapyimport *.

Installing scapy3k

The following steps describe how to install (or update) Scapy itself. Dependent on your platform, some additional libraries might have to be installed to make it actually work. So please also have a look at the platform specific chapters on how to install those requirements.

Note

The following steps apply to Unix-like operating systems (Linux, BSD, Mac OS X). Windows, currently is under development.

Make sure you have Python installed before you go on. Depending on your system you may have to use python3 and pip3 or python and pip for python version 3.x.

Latest release

The easiest way to install the latest scapy3k package is using pip.

$ pip3 install scapy-python3

Current development version

Clone GitHub repository to a temporary directory and install it in the standard distutilsway:

$ cd /tmp
$ git clone https://github.com/phaethon/scapy
$ cd scapy
$ sudo python3 setup.py install

If you always want the latest version with all new features and bugfixes, use Scapy’s GitHub repository:

1. Install git version control system. For example, on Debian/Ubuntu use:

   $ sudo apt-get install git
   

2. Check out a clone of Scapy’s repository:

   $ git clone https://github.com/phaethon/scapy
   

3. Install Scapy in the standard distutils way:

   $ cd scapy
   $ sudo python3 setup.py install
   

Then you can always update to the latest version:

$ git pull
$ sudo python3 setup.py install

Optional software for special features

• WEP decryption. unwep() needs cryptography. Example using a Weplap test file:

  >>> enc=rdpcap("weplab-64bit-AA-managed.pcap")
  >>> enc.show()
  >>> enc[0]
   >>> conf.wepkey=b"AA\x00\x00\x00"
   >>> dec=Dot11PacketList(enc).toEthernet()
   >>> dec.show()
   >>> dec[0]
  

• ipython. For interactive sessions using ipython can be great advantage. Install using pip3 or from your package manager

• Graphviz. For some visualizations, e.g. traceroute graph, dot is required on the PATH

• Matplotlib. Required for interactive plot/graph viewing.

• Networkx. Conversations can be converted to Networkx graph if library is present.

• PyX. To create PostScript, PDF and SVG files.

• LaTeX. To create PostScript and PDF files.

Platform-specific instructions

Linux native

Scapy can run natively on Linux. I does not require libdnet and libpcap.

• Install python3 from your package manager if it is not already present
• Install tcpdump and make sure it is in the $PATH. (It’s only used to compile BPF filters (-ddd option))
• Make sure your kernel has Packet sockets selected (CONFIG_PACKET)
• If your kernel is < 2.6, make sure that Socket filtering is selected CONFIG_FILTER)

Debian/Ubuntu

Just use the standard packages:

$ sudo apt-get install tcpdump python3-crypto ipython3

Mac OS X

This section needs updating. In general installing python3, pip for python3, libpcap, libdnet, scapy3k using pip package scapy-python3 should do the job. Corrections are welcome...

Windows

Scapy works on Windows 8/2012 and newer version. Unlike earlier versions libdnet is not required. Testing is being done on following configuration: Windows 10/Anaconda 3.5/WinPcap 4.1.3

On Windows 7 (and possibly earlier) scapy can be used for offline packet crafting/dissection. Sniffing and sending requires manual setting of network interface information and routing as corresponding powershell cmdlets used to gather this information are not working on Windows 7.