EvilNFSClient

command module
v1.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 24, 2025 License: Apache-2.0 Imports: 11 Imported by: 0

README ΒΆ

EvilNFSClient

license last-commit repo-top-language

Built with the tools and technologies:

Go


A modern, fast, and pentester-friendly NFS client built for red teams, security researchers, and anyone who wants full control over remote NFS exports β€” without needing to mount them.

Repository: github.com/AnvithLobo/EvilNFSClient

image

πŸ“‘ Table of Contents


πŸš€ What it does

EvilNFSClient is a TUI-powered, and powerful NFS client designed for offensive security workflows and regular use.

Use it as:

  • A post-exploitation helper
  • A privilege escalation tool
  • A standalone NFS file manager (no mount needed!)
  • A fast recursive uploader/downloader

✨ Features at a glance:

  • Full file manipulation (read, write, delete)
  • Upload/download directories with -r
  • Set SUID/SGID/Sticky bit permissions
  • Interactive shell with history + scrolling

⚑ Quick start

πŸ”§ Build from source

git clone https://github.com/AnvithLobo/EvilNFSClient
cd EvilNFSClient
go build -o evilnfsclient
./evilnfsclient <server-ip> <export-path>

πŸ“₯ Download binaries

➑️ Pre-built releases: https://github.com/AnvithLobo/EvilNFSClient/releases


🧰 Features

image

🌐 Remote NFS operations

  • ls [path] β€” colorized directory listing
  • cd <path> β€” switch directories
  • tree [path] β€” recursive view
  • get [-r] <remote> [<local>] β€” download
  • mget <pattern> [<dest_dir>] β€” multi-download
  • put [-r] <local> [<remote>] β€” upload
  • mput <pattern> [<dest_path>] β€” multi-upload
  • rm [-r] <path> β€” delete files/folders
  • mkdir [-p] <path> β€” create directories
  • chmod <mode> <file> β€” permission editing w/ SUID/SGID

πŸ’» Local operations (prefix l)

  • lls [path], lcd <path>, lmkdir [-p] <path>

πŸŽ›οΈ Session control

  • help β†’ show commands
  • Arrow keys β†’ history
  • PgUp/PgDn β†’ scroll
  • Ctrl + C, exit, quit β†’ exit

πŸ“˜ Commands (high level)

πŸ”Ž Navigation

nfs> ls
nfs> cd public
nfs> tree

πŸ“€ Upload

nfs> put /tmp/shell.sh payload.sh
nfs> put -r ./tools /shared/tools

πŸ“₯ Download

nfs> get payload.sh ./downloaded.sh
nfs> get -r /shared/sensitive /tmp/data

πŸ“¦ Multi-file

nfs> mget *.log ./logs/
nfs> mput /tmp/*.elf /shared/payloads/

πŸ—‚ Directory mgmt

nfs> mkdir -p /shared/a/b/c
nfs> rm -r /shared/old_stuff

πŸ’» Local commands

nfs> lcd /tmp
nfs> lmkdir -p workspace/subdir
nfs> lls

πŸ§ͺ Examples

# Connect to NFS server with the export /shared
./evilnfsclient 192.168.1.100 /shared
# List available NFS exports on the server
./evilnfsclient --list 192.168.1.100
# Connect with overridden UID and GID
./evilnfsclient 192.168.1.100 /shared --uid 0 --gid 0
# Run a single command non-interactively
./evilnfsclient 192.168.1.100 /shared -c "ls /"

πŸ” Permissions & SUID/SGID Notes

Supported modes include full SUID, SGID, and sticky bit manipulation.

Examples:

  • chmod 4755 file β†’ SUID
  • chmod 2755 file β†’ SGID
  • chmod 6777 file β†’ SUID + SGID

Priv-Esc scenario

nfs> put ./shell /shared/shell
nfs> chmod 6755 /shared/shell

Then on the target:

/shared/shell

⚠️ Whether the target honors SUID/SGID over NFS depends on mount + OS settings.


πŸ“¦ Installation

πŸ›  Prerequisites

  • Go 1.24.x+
  • Access to NFS server/export

πŸ”¨ Build

git clone https://github.com/AnvithLobo/EvilNFSClient
cd EvilNFSClient
go build -o evilnfsclient

βš™οΈ Usage & options

./evilnfsclient <server> <export> [options]

Options:

  • --uid <uid> β€” override UID
  • --gid <gid> β€” override GID
  • -c <cmd> β€” run command (non-interactive)

πŸ’‘ Tips & behavior

  • Remote paths β†’ resolved against remote CWD
  • Local paths β†’ resolved against local CWD
  • ~ expansion supported
  • PgUp/PgDn scrolls output
  • Use -r with caution (recursive delete!)

πŸ“Œ Project Roadmap

  • Task 1: General NFS Commands.
  • Task 2: List NFS Exports.
  • Task 3: Check for Root File System Escape.

⚠️ Disclaimer

This tool is intended strictly for authorized security testing and penetration testing. Unauthorized access to computer systems, networks, or data is illegal. Use EvilNFSClient only on systems you own or for which you have explicit permission.

By using this software you accept responsibility for your actions.


πŸ‘€ Author

Anvith Lobo β€” https://github.com/AnvithLobo


πŸ“„ License

See LICENSE for details.


✨ Built for red teamers and power users who need full control over NFS exports.

Documentation ΒΆ

The Go Gopher

There is no documentation for this package.

Directories ΒΆ

Path Synopsis
pkg
nfs
ui

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL