Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.americ.io.vn/llms.txt

Use this file to discover all available pages before exploring further.

SSH checklist

# What port is SSH listening on?
sudo ss -tlnp | grep sshd

# Review critical sshd config settings
grep -E "^(Port|PermitRootLogin|PasswordAuthentication|MaxAuthTries|AllowUsers)" /etc/ssh/sshd_config

# Quick count of failed attempts
sudo grep "Failed password" /var/log/auth.log | wc -l

# Top offending IPs
sudo grep "Failed password" /var/log/auth.log | awk '{print $(NF-3)}' | sort | uniq -c | sort -rn | head -20

# Recent 50 failures with timestamp
sudo grep "Failed password" /var/log/auth.log | tail -50

# Who is currently logged in
who

# More detail: IP, login time, idle
w

# All active SSH connections via socket
ss -tnp | grep :22

# SSH login history (recent)
last | grep "pts\|ssh" | head -20

# Check if installed
fail2ban-client status 2>/dev/null || echo "fail2ban NOT installed"

# Install it
sudo apt install fail2ban -y

# After install β€” check SSH jail status
sudo fail2ban-client status sshd

# List currently banned IPs
sudo fail2ban-client get sshd banip
⚑ One-liner Full Snapshot
# refs: https://gist.github.com/OliverKain/e784e9754d47ccafc3be1d8061e6f1ba
echo "=== SSH PORT ===" && sudo ss -tlnp | grep sshd && \
echo "" && \
echo "=== FAILED LOGINS (top IPs) ===" && sudo grep "Failed password" /var/log/auth.log | awk '{print $(NF-3)}' | sort | uniq -c | sort -rn | head -10 && \
echo "" && \
echo "=== ACTIVE SESSIONS ===" && w && \
echo "" && \
echo "=== FAIL2BAN ===" && sudo fail2ban-client status sshd 2>/dev/null || echo "fail2ban not running"

SSH via private keys

# Generate key pair (anywhere/at client)
ssh-keygen -t ed25519 -C "comment (email/action...)"

# Validate by ssh to host using private key file
ssh -i $PRIVATE_KEY_PATH $USER@$HOST -p $PORT

# View public key (for copying)
cat ~/.ssh/id_ed25519.pub
# Windows
type $env:USERPROFILE\.ssh\id_ed25519.pub
# Initialize .ssh folder
mkdir -p ~/.ssh
# Copy
echo "PASTE YOUR PUBLIC KEY HERE" >> ~/.ssh/authorized_keys
# Set permission (just in case)
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

# One-liner - Add public key to the authorized_keys of host's user, create path if not exist (process at client)
cat $PUBLIC_KEY_PATH | ssh $USER@$HOST -p $PORT "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"

Change SSH port

  • Prerequisites:
# Check ssh status
which sshd
# Install sshd
sudo systemctl status ssh
# Install
sudo apt update && sudo apt install openssh-server -y
  • Modified sshd_config
# Find/Check location
find / -name "sshd_config" 2>/dev/null
# Edit
sudo vi /etc/ssh/sshd_config
  • Search & uncomment Port 22, then change to the desired port.
  • Restart ssh service
# Ubuntu
# Disable ssh.socket
sudo systemctl disable --now ssh.socket
sudo systemctl enable --now ssh.service
#sudo service ssh restart
sudo systemctl restart ssh

# AlmaLinux
systemctl restart sshd

Quick setup script

#!/usr/bin/env bash
set -e

### ===== BASIC OPTIONS (always run) =====
CUSTOM_PORT=1993
ALLOW_PASSWORD_LOGIN=true
ALLOW_ROOT_LOGIN=true        # set to false to block root SSH login

NEWUSER="americio"
SSH_PUBLIC_KEY="ssh-ed25519 AAAA...your_key_here"
PASSWORDLESS_SUDO=false

BANTIME="1h"
FINDTIME="10m"
MAXRETRY=3

### ===== ADVANCED OPTIONS (only run if ADVANCED_SETUP=true) =====
# Gates: 2FA (Google Authenticator TOTP), auditd hardening rules, unattended-upgrades
ADVANCED_SETUP=false
### ========================================================

# ─── helpers ──────────────────────────────────────────────────────────────────
section() { echo; echo "===================================================================="; echo "  $*"; echo "===================================================================="; }
info()    { echo "  ℹ️  $*"; }
ok()      { echo "  βœ… $*"; }
warn()    { echo "  ⚠️  $*"; }

# Restart a service, validate it came up, exit on failure
restart_service() {
    local svc="$1"
    echo "πŸ”„ Restarting $svc..."
    if sudo systemctl restart "$svc"; then
        sleep 1
        if sudo systemctl is-active --quiet "$svc"; then
            ok "$svc is running."
        else
            warn "$svc failed to start β€” check: journalctl -u $svc -n 30"
            exit 1
        fi
    else
        warn "systemctl restart $svc failed."
        exit 1
    fi
}

# ─── 1. SSH HARDENING (always) ────────────────────────────────────────────────
section "SSH HARDENING"

FILE=/etc/ssh/sshd_config

echo "πŸ’Ύ Backing up original sshd_config"
sudo cp "$FILE" "$FILE.backup.$(date +%F-%H%M%S)"

echo "βœ’οΈ  Writing secure sshd_config..."
sudo tee "$FILE" >/dev/null <<EOF
# ===== SECURE SSH CONFIG =====

Port ${CUSTOM_PORT}
# Uncomment to disable IPv6: AddressFamily inet

PermitRootLogin $( [ "$ALLOW_ROOT_LOGIN" = true ] && echo "yes" || echo "no" )
PasswordAuthentication $( [ "$ALLOW_PASSWORD_LOGIN" = true ] && echo "yes" || echo "no" )
PermitEmptyPasswords no
KbdInteractiveAuthentication no
PubkeyAuthentication yes
AuthorizedKeysFile .ssh/authorized_keys

MaxAuthTries 3
LoginGraceTime 20
MaxSessions 2

ClientAliveInterval 120
ClientAliveCountMax 2

LogLevel VERBOSE

Include /etc/ssh/sshd_config.d/*.conf
EOF

echo "πŸ€” Validating SSH configuration..."
# Ubuntu 24.04 uses ssh.service; older distros use sshd.service
SSH_SERVICE=$(systemctl list-units --type=service --all | grep -oE 'ssh(d)?\.service' | head -1)
if sudo sshd -t; then
    restart_service "$SSH_SERVICE"
    ok "SSH hardened successfully (service: $SSH_SERVICE)."
else
    warn "SSH config ERROR β€” restoring backup..."
    sudo cp "$FILE.backup"* "$FILE"
    exit 1
fi

# ─── 2. USER SETUP (always) ───────────────────────────────────────────────────
section "USER SETUP"

echo "πŸͺ„ Creating user: $NEWUSER"
if id "$NEWUSER" >/dev/null 2>&1; then
    info "User already exists, skipping creation."
else
    sudo adduser --disabled-password --gecos "" "$NEWUSER"
    GENPASS=$(openssl rand -base64 16)
    echo "$NEWUSER:$GENPASS" | sudo chpasswd
    echo "πŸ” Temporary password for $NEWUSER: $GENPASS"
fi

sudo usermod -aG sudo "$NEWUSER"
sudo usermod -aG adm  "$NEWUSER"
sudo usermod -s /bin/bash "$NEWUSER"

echo "πŸ—ƒοΈ  Setting up SSH directory"
sudo mkdir -p /home/$NEWUSER/.ssh
echo "$SSH_PUBLIC_KEY" | sudo tee /home/$NEWUSER/.ssh/authorized_keys >/dev/null
sudo chmod 700  /home/$NEWUSER/.ssh
sudo chmod 600  /home/$NEWUSER/.ssh/authorized_keys
sudo chown -R "$NEWUSER:$NEWUSER" /home/$NEWUSER/.ssh

if [ "$PASSWORDLESS_SUDO" = true ]; then
    echo "πŸ”“ Enabling passwordless sudo for $NEWUSER"
    echo "$NEWUSER ALL=(ALL) NOPASSWD:ALL" | sudo tee /etc/sudoers.d/90-"$NEWUSER" >/dev/null
    sudo chmod 440 /etc/sudoers.d/90-"$NEWUSER"
fi

ok "User setup completed."

# ─── 3. UFW FIREWALL (always) ─────────────────────────────────────────────────
section "UFW FIREWALL"

sudo ufw --force reset
sudo ufw default deny incoming
sudo ufw default allow outgoing

sudo ufw limit "${CUSTOM_PORT}"/tcp
sudo ufw allow http
sudo ufw allow https

sudo ufw --force enable
sudo ufw status verbose
ok "UFW firewall configured."

# ─── 4. FAIL2BAN (always) ─────────────────────────────────────────────────────
section "FAIL2BAN"

sudo apt update -q
sudo apt install -y fail2ban

sudo tee /etc/fail2ban/jail.local >/dev/null <<EOF
[DEFAULT]
bantime  = ${BANTIME}
findtime = ${FINDTIME}
maxretry = ${MAXRETRY}
backend  = systemd
banaction = ufw
ignoreip = 127.0.0.1/8 ::1

[sshd]
enabled = true
port    = ${CUSTOM_PORT}
filter  = sshd
backend = systemd
logpath = journal
EOF

sudo systemctl enable --now fail2ban
restart_service fail2ban
sleep 2
sudo fail2ban-client status sshd
ok "Fail2ban installed & configured."

# ─── 5. ADVANCED SETUP (opt-in) ───────────────────────────────────────────────
if [ "$ADVANCED_SETUP" != true ]; then
    echo
    info "ADVANCED_SETUP=false β€” skipping 2FA, auditd, and unattended-upgrades."
    echo "  Set ADVANCED_SETUP=true at the top of this script to enable them."
    echo
    echo "πŸ’― Basic VPS hardening complete. Goodbye!"
    exit 0
fi

section "ADVANCED SETUP (ADVANCED_SETUP=true)"

# ── 5a. Lock root password ────────────────────────────────────────────────────
echo "πŸ”’ Locking root password"
sudo passwd -l root
ok "Root password locked."

# ── 5b. Unattended Security Updates ──────────────────────────────────────────
echo "πŸ“¦ Unattended Security Updates..."
sudo apt install -y unattended-upgrades
sudo dpkg-reconfigure -plow unattended-upgrades
ok "Unattended upgrades enabled."

# ── 5b. SSH 2FA (Google Authenticator TOTP) ───────────────────────────────────
section "SSH 2FA β€” Google Authenticator TOTP"

echo "πŸ“¦ Installing TOTP PAM module..."
sudo apt install -y libpam-google-authenticator

echo "πŸͺͺ Generating TOTP secret for user: $NEWUSER"
sudo -u "$NEWUSER" bash -c "google-authenticator -t -d -f -r 3 -R 30 -W --quiet"

echo "πŸ“ Backing up SSH PAM config..."
sudo cp /etc/pam.d/sshd /etc/pam.d/sshd.bak."$(date +%F-%H%M%S)"

echo "βœ’οΈ  Updating PAM rules for TOTP"
sudo sed -i '1i auth required pam_google_authenticator.so' /etc/pam.d/sshd

echo "πŸ“ Backing up sshd_config..."
sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak."$(date +%F-%H%M%S)"

echo "βš™οΈ  Configuring SSH to require publickey + TOTP"
sudo sed -i 's/^#\?ChallengeResponseAuthentication.*/ChallengeResponseAuthentication yes/' /etc/ssh/sshd_config
sudo sed -i 's/^#\?KbdInteractiveAuthentication.*/KbdInteractiveAuthentication yes/'       /etc/ssh/sshd_config

if grep -q "^AuthenticationMethods" /etc/ssh/sshd_config; then
    sudo sed -i 's/^AuthenticationMethods.*/AuthenticationMethods publickey,keyboard-interactive/' /etc/ssh/sshd_config
else
    echo "AuthenticationMethods publickey,keyboard-interactive" | sudo tee -a /etc/ssh/sshd_config >/dev/null
fi

echo "πŸ€” Validating SSH configuration with 2FA..."
if sudo sshd -t; then
    restart_service "$SSH_SERVICE"
    ok "SSH 2FA enabled successfully."
else
    warn "ERROR: Invalid SSH config β€” rolling back 2FA changes..."
    sudo cp /etc/ssh/sshd_config.bak.* /etc/ssh/sshd_config
    sudo cp /etc/pam.d/sshd.bak.*      /etc/pam.d/sshd
    restart_service "$SSH_SERVICE"
    exit 1
fi

echo
echo "  πŸ‘‰ IMPORTANT: Open a NEW terminal and test login before closing this session."
echo "  SSH now requires:"
echo "    1) SSH private key"
echo "    2) Google Authenticator 6-digit TOTP code"

# ── 5c. auditd Hardening Rules ────────────────────────────────────────────────
section "AUDITD HARDENING RULES"

echo "πŸ“œ Installing hardened auditd rules..."
sudo apt install -y auditd audispd-plugins

sudo tee /etc/audit/rules.d/hardening.rules >/dev/null <<'EOF'
## ===============================
## HARDENED AUDITD SECURITY RULES
## ===============================

# Track sudo log changes
-w /var/log/sudo.log -p wa -k sudo_logs

# Track privileged binary changes
-w /usr/bin  -p wa -k privileged-bins
-w /usr/sbin -p wa -k privileged-bins

# Track essential system config changes
-w /etc/passwd   -p wa -k passwd_changes
-w /etc/group    -p wa -k group_changes
-w /etc/shadow   -p wa -k shadow_changes
-w /etc/sudoers  -p wa -k sudoers_changes
-w /etc/sudoers.d/ -p wa -k sudoers_changes

# Track SSH config changes
-w /etc/ssh/sshd_config      -p wa -k ssh_config
-w /etc/ssh/sshd_config.d/   -p wa -k ssh_config

# Track login/auth events
-w /var/log/faillog  -p wa -k auth_failures
-w /var/log/lastlog  -p wa -k auth_changes
-w /var/log/tallylog -p wa -k auth_failures

# Track systemd service changes
-w /etc/systemd/system/      -p wa -k systemd_changes
-w /usr/lib/systemd/system/  -p wa -k systemd_changes

# Track kernel module loading
-w /sbin/modprobe     -p x -k kernel_modules
-w /usr/sbin/modprobe -p x -k kernel_modules

# Monitor root escalation
-w /bin/su -p x -k root_escalation

# File permission/ownership changes
-a always,exit -F arch=b64 -S chmod,chown,chgrp,fchmod,fchown -k perms
-a always,exit -F arch=b32 -S chmod,chown,chgrp,fchmod,fchown -k perms

# Root shell spawning
-a always,exit -F arch=b64 -S execve -F uid=0 -k root_shell
-a always,exit -F arch=b32 -S execve -F uid=0 -k root_shell

# Firewall rule changes
-w /etc/ufw/       -p wa -k ufw_changes
-w /etc/firewalld/ -p wa -k firewalld_changes

# Cron persistence tracking
-w /etc/crontab       -p wa -k cron_changes
-w /etc/cron.d/       -p wa -k cron_changes
-w /etc/cron.daily/   -p wa -k cron_changes
-w /etc/cron.hourly/  -p wa -k cron_changes

# Make audit config immutable (requires reboot to change rules after this)
-e 2
EOF

sudo augenrules --load
sudo systemctl enable --now auditd
restart_service auditd
ok "auditd hardening rules installed."

# ─── DONE ─────────────────────────────────────────────────────────────────────
echo
echo "πŸ’― Full VPS hardening complete (basic + advanced). Goodbye!"
  • Run:
curl -O https://gist.githubusercontent.com/username/abcdef1234567890/raw/harden.sh
chmod +x ./harden.sh
sudo ./harden.sh
# One-liner, no download
curl -sSL https://gist.githubusercontent.com/username/abcdef1234567890/raw/harden.sh | sudo bash

πŸ›‘οΈ SSH Protection Layers β€” Basic to Advanced

Layer 1 β€” Immediate Basics (Do These First) - sshd_config
No.ActionCommand/File
1Change default SSH portPort XXXX
2Disable root loginPermitRootLogin no
3Limit max auth triesMaxAuthTries 3
4Reduce login graceLoginGraceTime 30
5Restrict to specific userAllowUsers <<yourusername>>
Layer 2 β€” Key-Based Auth (Eliminates Brute Force)
No.ActionCommand/File
6Generate ed25519 keypairssh-keygen -t ed25519
7Copy key to serverssh-copy-id
8Disable password authPasswordAuthentication no
9Disable empty passwordsPermitEmptyPasswords no
Layer 3 β€” Firewall (UFW)
No.ActionCommand/File
10Default deny all incomingufw default deny incoming
11Allow only your SSH portufw allow [YOUR_PORT]/tcp
12Whitelist your IP for SSHufw allow from [YOUR_IP] to any port [YOUR_PORT]
13Enable UFWufw enable
Layer 4 β€” Auto-Blocking (fail2ban)
No.ActionCommand/File
14Install fail2bansudo apt install fail2ban
15Configure [sshd]jailmaxretry=5, bantime=1h
16Recidive jail (repeat offenders)bantime=-1 permanent ban
17Email alerts on bansaction = %(action_mwl)
Layer 5 β€” Log Monitoring (Visibility)
No.ActionCommand/File
18Check failed loginsgrep "Failed password" /var/log/auth.log
19Find top attacker IPssudo grep "Failed password" /var/log/auth.log | awk '{print \$(NF-3)}' | sort | uniq -c | sort -rn | head -20
20Verify successful loginsgrep β€œAccepted” /var/log/auth.log
21Watch live auth logtail -f /var/log/auth.log
Layer 6 β€” Advanced Hardening
No.ActionCommand/File
22Fix Docker bypassing UFWdaemon.json β†’ "iptables": false
23Bind services to localhostdocker-compose.yml β†’ 127.0.0.1:PORT
24Block Postgres publiclyufw deny 5432
25Nginx attack detection customfail2ban filter jail
26Block bot scannerprobesbotsearch-common, fail2ban jail
Layer 7 β€” Expert Level
No.ActionCommand/File
27Two-factor auth for SSHlibpam-google-authenticator
28Port knockingknockd
29Geo-blocking by countrygeoip-shell or nftables
30Intrusion detection systemOSSEC or Wazuh
31Centralized log monitoringGrafana + Loki + Promtail