fwdctl

command module
v1.2.0 Latest Latest
Warning

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

Go to latest
Published: Jul 10, 2026 License: Apache-2.0 Imports: 12 Imported by: 0

README

fwdctl

fwdctl

Go Reference Go Report Card Go Coverage Awesome

fwdctl is a simple and intuitive CLI to manage forwards in your Linux server.

How it works

It essentially provides commands to manage forwards, using iptables under the hood.

Let's do an example:

Suppose you have an hypervisor server that hosts some virtual machines inside itself. If you need to expose an internal service, managed by one of these VMs, you can use fwdctl from the hypervisor to add the forward to expose this service.

example

To do so, you have to type this easy command:

sudo fwdctl create --destination-port 3000 --source-address 192.168.199.105 --source-port 80

That's it.

Full documentation here.

Installation

Linux x86_64
curl -s https://raw.githubusercontent.com/alegrey91/fwdctl/main/install | sudo sh

Seccomp (experimental)

I've recently added a new functionality to trace the system calls used by fwdctl during the test pipeline.

This is done by using another project of mine: harpoon.

Thanks to this, at the end of the pipeline, we have a seccomp profile as artifact. You can use this to run fwdctl in a more secure way.

Find the seccomp profile here: fwdctl-seccomp.json.

Documentation

Overview

Copyright © 2022 Alessio Greggi

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Directories

Path Synopsis
internal
hooks
Package hooks runs the optional commands associated with a rule's create/delete lifecycle events.
Package hooks runs the optional commands associated with a rule's create/delete lifecycle events.
pkg

Jump to

Keyboard shortcuts

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