Installation Guide

This guide will walk you through the process of installing and setting up GoSpoof on your system.

Prerequisites

Before installing GoSpoof, ensure you have:

• Go 1.16 or later installed
• Root/Administrator privileges
• Basic understanding of networking concepts

Installation Steps

1. Clone the Repository

git clone https://github.com/blackhillsinfosec/GoSpoof.git
cd GoSpoof

2. Build GoSpoof

Navigate to the source directory and build the executable:

cd src
go build -o goSpoof

3. Setup iptables (Linux)

To redirect traffic to GoSpoof, run either:

./goSpoof -sT 4444

Or manually:

sudo iptables -t nat -A PREROUTING -p tcp -m tcp --dport 1:65535 -j REDIRECT --to-ports 4444

4. Move to Bin Directory

cp ./goSpoof /usr/local/bin/

5. WebUI Setup (Optional)

If you plan to use the WebUI interface, you’ll need to set up the web server components:

1. Navigate back to the root directory:

cd ..

2. Run the WebUI startup script:

go run startup.go

This step is only required if you want to use the --WebUI flag to launch the GoSpoof Command Center. The WebUI provides a graphical interface for monitoring and managing GoSpoof.

For more information about using the WebUI, see the WebUI documentation.

Configuration

After installation, you’ll need to configure GoSpoof. See the Configuration Guide for detailed instructions.

Verification

To verify your installation:

1. Start GoSpoof:

./goSpoof

2. Test with a port scan (must be done from a separate machine):

nmap -sV IP

Common Issues

If you encounter any issues during installation, check the Troubleshooting Guide.

Next Steps

• Try the Quick Start Guide for immediate testing
• Learn Basic Usage commands and workflows
• Set up YAML Configuration for custom deployments

Additional Reading

• Troubleshooting Guide for installation issues
• Command Line Options for all available flags