Open-Awesome
CategoriesAlternativesStacksSelf-HostedExplore
Open-Awesome

© 2026 Open-Awesome. Curated for the developer elite.

TermsPrivacyAboutGitHubRSS
  1. Home
  2. SSH
  3. totp-ssh-fluxer

totp-ssh-fluxer

Go

A joke security tool that changes your SSH server's listening port every 30 seconds using TOTP codes.

GitHubGitHub
945 stars43 forks0 contributors

What is totp-ssh-fluxer?

totp-ssh-fluxer is a joke security tool that dynamically changes a server's SSH port every 30 seconds using Time-based One-Time Password (TOTP) codes. It uses iptables rules to redirect traffic to the current port, making it extremely difficult for automated bots to find the SSH service. The project is presented as a humorous experiment rather than a serious security solution.

Target Audience

Security researchers, system administrators, and developers interested in unconventional network security experiments or educational demonstrations about port obfuscation.

Value Proposition

It provides an extreme, automated implementation of port obfuscation that highlights the limitations of security-through-obscurity. The project is unique for its creative use of TOTP codes for port selection and its clear stance as a joke rather than a production tool.

Overview

Take security by obscurity to the next level (this is a bad idea, don't really use this please)

Use Cases

Best For

  • Demonstrating the absurdity of security-through-obscurity in educational settings
  • Creating a moving target for SSH brute-force attacks in lab environments
  • Experimenting with dynamic port allocation using TOTP algorithms
  • Testing iptables automation for port redirection scenarios
  • Building honeypot systems that constantly change network footprints
  • Educational projects about Linux networking and security concepts

Not Ideal For

  • Production environments requiring reliable and predictable SSH access
  • Systems with strict security compliance needs that mandate static configurations
  • Automated deployment pipelines that depend on consistent SSH port availability

Pros & Cons

Pros

Dynamic Port Obfuscation

Automatically changes the SSH port every 30 seconds using TOTP codes, effectively hiding the service from automated bots as demonstrated in the README.

Connection Persistence

Leverages iptables PREROUTING rules to keep established SSH connections alive even after port changes, preventing disruptions.

Simple Initial Setup

Generates a TOTP key on first run and saves it to /etc/ssh-flux-key, simplifying client configuration without manual key creation.

Educational Demonstration

Serves as a tongue-in-cheek example to critique security-through-obscurity, making it useful for learning about network security concepts.

Cons

Not Recommended for Use

The author explicitly states it was written as a joke and warns against running it seriously, indicating a lack of reliability and support.

Requires Root Access

Must run as root to edit iptables, which introduces security risks and limits deployment in restricted environments.

Iptables Management Risks

Manual insertion and removal of iptables rules can conflict with existing firewall setups and may not survive system reboots.

Cumbersome Client Integration

Users must manually input TOTP codes into SSH clients for each connection, lacking automation and increasing usability friction.

Frequently Asked Questions

Quick Stats

Stars945
Forks43
Contributors0
Open Issues2
Last commit4 years ago
CreatedSince 2016

Tags

#totp#ssh-security#honeypot#linux-networking#golang#iptables#ssh

Built With

G
Go

Included in

SSH2.8k
Auto-fetched 13 hours ago

Related Projects

krkr

DEPRECATED A dev tool for SSH auth + Git commit/tag signing using a key stored in Krypton.

Stars1,570
Forks108
Last commit3 years ago
authy-sshauthy-ssh

Easy two-factor authentication for ssh servers

Stars793
Forks67
Last commit8 years ago
github-authgithub-auth

SSH key management for GitHub users

Stars390
Forks17
Last commit8 years ago
HIBAHIBA

HIBA is a system built on top of regular OpenSSH certificate-based authentication that allows to manage flexible authorization of principals on pools of target hosts without the need to push customized authorized_users files periodically.

Stars390
Forks20
Last commit1 month ago
Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a projectStar on GitHub