Aller au contenu

Sshuttle

Copier toutes les commandes Générer PDF

Commandes et flux de travail complets pour l'administration du système sur toutes les plateformes.

Commandes de base

Command Description
sshuttle --version Show sshuttle version
sshuttle --help Display help information
sshuttle init Initialize sshuttle in current directory
sshuttle status Check current status
sshuttle list List available options
sshuttle info Display system information
sshuttle config Show configuration settings
sshuttle update Update to latest version
sshuttle start Start sshuttle service
sshuttle stop Stop sshuttle service
sshuttle restart Restart sshuttle service
sshuttle reload Reload configuration

Installation

Linux/Ubuntu

# Package manager installation
sudo apt update
sudo apt install sshuttle

# Alternative installation
wget https://github.com/example/sshuttle/releases/latest/download/sshuttle-linux
chmod +x sshuttle-linux
sudo mv sshuttle-linux /usr/local/bin/sshuttle

# Build from source
git clone https://github.com/example/sshuttle.git
cd sshuttle
make && sudo make install

MACOS

# Homebrew installation
brew install sshuttle

# MacPorts installation
sudo port install sshuttle

# Manual installation
curl -L -o sshuttle https://github.com/example/sshuttle/releases/latest/download/sshuttle-macos
chmod +x sshuttle
sudo mv sshuttle /usr/local/bin/
```_

### Fenêtres
```powershell
# Chocolatey installation
choco install sshuttle

# Scoop installation
scoop install sshuttle

# Winget installation
winget install sshuttle

# Manual installation
# Download from https://github.com/example/sshuttle/releases
# Extract and add to PATH
```_

## Configuration

|Command|Description|
|---------|-------------|
|`sshuttle config show`|Display current configuration|
|`sshuttle config list`|List all configuration options|
|`sshuttle config set <key> <value>`|Set configuration value|
|`sshuttle config get <key>`|Get configuration value|
|`sshuttle config unset <key>`|Remove configuration value|
|`sshuttle config reset`|Reset to default configuration|
|`sshuttle config validate`|Validate configuration file|
|`sshuttle config export`|Export configuration to file|

## Opérations avancées

### Opérations de fichiers
```bash
# Create new file/resource
sshuttle create <name>

# Read file/resource
sshuttle read <name>

# Update existing file/resource
sshuttle update <name>

# Delete file/resource
sshuttle delete <name>

# Copy file/resource
sshuttle copy <source> <destination>

# Move file/resource
sshuttle move <source> <destination>

# List all files/resources
sshuttle list --all

# Search for files/resources
sshuttle search <pattern>

Opérations réseau

# Connect to remote host
sshuttle connect <host>:<port>

# Listen on specific port
sshuttle listen --port <port>

# Send data to target
sshuttle send --target <host> --data "<data>"

# Receive data from source
sshuttle receive --source <host>

# Test connectivity
sshuttle ping <host>

# Scan network range
sshuttle scan <network>

# Monitor network traffic
sshuttle monitor --interface <interface>

# Proxy connections
sshuttle proxy --listen <port> --target <host>:<port>

Gestion des processus

# Start background process
sshuttle start --daemon

# Stop running process
sshuttle stop --force

# Restart with new configuration
sshuttle restart --config <file>

# Check process status
sshuttle status --verbose

# Monitor process performance
sshuttle monitor --metrics

# Kill all processes
sshuttle killall

# Show running processes
sshuttle ps

# Manage process priority
sshuttle priority --pid <pid> --level <level>

Caractéristiques de sécurité

Authentification

# Login with username/password
sshuttle login --user <username>

# Login with API key
sshuttle login --api-key <key>

# Login with certificate
sshuttle login --cert <cert_file>

# Logout current session
sshuttle logout

# Change password
sshuttle passwd

# Generate new API key
sshuttle generate-key --name <key_name>

# List active sessions
sshuttle sessions

# Revoke session
sshuttle revoke --session <session_id>

Chiffrement

# Encrypt file
sshuttle encrypt --input <file> --output <encrypted_file>

# Decrypt file
sshuttle decrypt --input <encrypted_file> --output <file>

# Generate encryption key
sshuttle keygen --type <type> --size <size>

# Sign file
sshuttle sign --input <file> --key <private_key>

# Verify signature
sshuttle verify --input <file> --signature <sig_file>

# Hash file
sshuttle hash --algorithm <algo> --input <file>

# Generate certificate
sshuttle cert generate --name <name> --days <days>

# Verify certificate
sshuttle cert verify --cert <cert_file>

Surveillance et exploitation forestière

Surveillance du système

# Monitor system resources
sshuttle monitor --system

# Monitor specific process
sshuttle monitor --pid <pid>

# Monitor network activity
sshuttle monitor --network

# Monitor file changes
sshuttle monitor --files <directory>

# Real-time monitoring
sshuttle monitor --real-time --interval 1

# Generate monitoring report
sshuttle report --type monitoring --output <file>

# Set monitoring alerts
sshuttle alert --threshold <value> --action <action>

# View monitoring history
sshuttle history --type monitoring

Exploitation forestière

# View logs
sshuttle logs

# View logs with filter
sshuttle logs --filter <pattern>

# Follow logs in real-time
sshuttle logs --follow

# Set log level
sshuttle logs --level <level>

# Rotate logs
sshuttle logs --rotate

# Export logs
sshuttle logs --export <file>

# Clear logs
sshuttle logs --clear

# Archive logs
sshuttle logs --archive <archive_file>

Dépannage

Questions communes

Numéro : Commande non trouvée

# Check if sshuttle is installed
which sshuttle
sshuttle --version

# Check PATH variable
echo $PATH

# Reinstall if necessary
sudo apt reinstall sshuttle
# or
brew reinstall sshuttle

Émission : autorisation refusée

# Run with elevated privileges
sudo sshuttle <command>

# Check file permissions
ls -la $(which sshuttle)

# Fix permissions
chmod +x /usr/local/bin/sshuttle

# Check ownership
sudo chown $USER:$USER /usr/local/bin/sshuttle

Question : Erreurs de configuration

# Validate configuration
sshuttle config validate

# Reset to default configuration
sshuttle config reset

# Check configuration file location
sshuttle config show --file

# Backup current configuration
sshuttle config export > backup.conf

# Restore from backup
sshuttle config import backup.conf

*Numéro: Le service ne démarre pas *

# Check service status
sshuttle status --detailed

# Check system logs
journalctl -u sshuttle

# Start in debug mode
sshuttle start --debug

# Check port availability
netstat -tulpn|grep <port>

# Kill conflicting processes
sshuttle killall --force

Déboguer les commandes

Command Description
sshuttle --debug Enable debug output
sshuttle --verbose Enable verbose logging
sshuttle --trace Enable trace logging
sshuttle test Run built-in tests
sshuttle doctor Run system health check
sshuttle diagnose Generate diagnostic report
sshuttle benchmark Run performance benchmarks
sshuttle validate Validate installation and configuration

Optimisation des performances

Gestion des ressources

# Set memory limit
sshuttle --max-memory 1G <command>

# Set CPU limit
sshuttle --max-cpu 2 <command>

# Enable caching
sshuttle --cache-enabled <command>

# Set cache size
sshuttle --cache-size 100M <command>

# Clear cache
sshuttle cache clear

# Show cache statistics
sshuttle cache stats

# Optimize performance
sshuttle optimize --profile <profile>

# Show performance metrics
sshuttle metrics

Traitement parallèle

# Enable parallel processing
sshuttle --parallel <command>

# Set number of workers
sshuttle --workers 4 <command>

# Process in batches
sshuttle --batch-size 100 <command>

# Queue management
sshuttle queue add <item>
sshuttle queue process
sshuttle queue status
sshuttle queue clear

Intégration

Scénario

#!/bin/bash
# Example script using sshuttle

set -euo pipefail

# Configuration
CONFIG_FILE="config.yaml"
LOG_FILE="sshuttle.log"

# Check if sshuttle is available
if ! command -v sshuttle &> /dev/null; then
    echo "Error: sshuttle is not installed" >&2
    exit 1
fi

# Function to log messages
log() \\\\{
    echo "$(date '+%Y-%m-%d %H:%M:%S') - $1"|tee -a "$LOG_FILE"
\\\\}

# Main operation
main() \\\\{
    log "Starting sshuttle operation"

    if sshuttle --config "$CONFIG_FILE" run; then
        log "Operation completed successfully"
        exit 0
    else
        log "Operation failed with exit code $?"
        exit 1
    fi
\\\\}

# Cleanup function
cleanup() \\\\{
    log "Cleaning up"
    sshuttle cleanup
\\\\}

# Set trap for cleanup
trap cleanup EXIT

# Run main function
main "$@"

Intégration de l'API

#!/usr/bin/env python3
"""
Python wrapper for the tool
"""

import subprocess
import json
import logging
from pathlib import Path
from typing import Dict, List, Optional

class ToolWrapper:
    def __init__(self, config_file: Optional[str] = None):
        self.config_file = config_file
        self.logger = logging.getLogger(__name__)

    def run_command(self, args: List[str]) -> Dict:
        """Run command and return parsed output"""
        cmd = ['tool_name']

        if self.config_file:
            cmd.extend(['--config', self.config_file])

        cmd.extend(args)

        try:
            result = subprocess.run(
                cmd,
                capture_output=True,
                text=True,
                check=True
            )
            return \\\\{'stdout': result.stdout, 'stderr': result.stderr\\\\}
        except subprocess.CalledProcessError as e:
            self.logger.error(f"Command failed: \\\\{e\\\\}")
            raise

    def status(self) -> Dict:
        """Get current status"""
        return self.run_command(['status'])

    def start(self) -> Dict:
        """Start service"""
        return self.run_command(['start'])

    def stop(self) -> Dict:
        """Stop service"""
        return self.run_command(['stop'])

# Example usage
if __name__ == "__main__":
    wrapper = ToolWrapper()
    status = wrapper.status()
    print(json.dumps(status, indent=2))

Variables d'environnement

Variable Description Default
SSHUTTLE_CONFIG Configuration file path ~/.sshuttle/config.yaml
SSHUTTLE_HOME Home directory ~/.sshuttle
SSHUTTLE_LOG_LEVEL Logging level INFO
SSHUTTLE_LOG_FILE Log file path ~/.sshuttle/logs/sshuttle.log
SSHUTTLE_CACHE_DIR Cache directory ~/.sshuttle/cache
SSHUTTLE_DATA_DIR Data directory ~/.sshuttle/data
SSHUTTLE_TIMEOUT Default timeout 30s
SSHUTTLE_MAX_WORKERS Maximum workers 4

Fichier de configuration

# ~/.sshuttle/config.yaml
version: "1.0"

# General settings
settings:
  debug: false
  verbose: false
  log_level: "INFO"
  log_file: "~/.sshuttle/logs/sshuttle.log"
  timeout: 30
  max_workers: 4

# Network configuration
network:
  host: "localhost"
  port: 8080
  ssl: true
  timeout: 30
  retries: 3

# Security settings
security:
  auth_required: true
  api_key: ""
  encryption: "AES256"
  verify_ssl: true

# Performance settings
performance:
  cache_enabled: true
  cache_size: "100M"
  cache_dir: "~/.sshuttle/cache"
  max_memory: "1G"

# Monitoring settings
monitoring:
  enabled: true
  interval: 60
  metrics_enabled: true
  alerts_enabled: true

Exemples

Flux de travail de base

# 1. Initialize sshuttle
sshuttle init

# 2. Configure basic settings
sshuttle config set host example.com
sshuttle config set port 8080

# 3. Start service
sshuttle start

# 4. Check status
sshuttle status

# 5. Perform operations
sshuttle run --target example.com

# 6. View results
sshuttle results

# 7. Stop service
sshuttle stop

Flux de travail avancé

# Comprehensive operation with monitoring
sshuttle run \
  --config production.yaml \
  --parallel \
  --workers 8 \
  --verbose \
  --timeout 300 \
  --output json \
  --log-file operation.log

# Monitor in real-time
sshuttle monitor --real-time --interval 5

# Generate report
sshuttle report --type comprehensive --output report.html

Exemple d'automatisation

#!/bin/bash
# Automated sshuttle workflow

# Configuration
TARGETS_FILE="targets.txt"
RESULTS_DIR="results/$(date +%Y-%m-%d)"
CONFIG_FILE="automation.yaml"

# Create results directory
mkdir -p "$RESULTS_DIR"

# Process each target
while IFS= read -r target; do
    echo "Processing $target..."

    sshuttle \
        --config "$CONFIG_FILE" \
        --output json \
        --output-file "$RESULTS_DIR/$\\\\{target\\\\}.json" \
        run "$target"

done < "$TARGETS_FILE"

# Generate summary report
sshuttle report summary \
    --input "$RESULTS_DIR/*.json" \
    --output "$RESULTS_DIR/summary.html"

Meilleures pratiques

Sécurité

  • Vérifiez toujours les comptes de chèques lors du téléchargement des binaires
  • Utiliser des méthodes d'authentification fortes (clés API, certificats)
  • Mise à jour régulière de la dernière version
  • Suivre le principe du moindre privilège
  • Activer l'enregistrement des audits pour assurer la conformité
  • Utiliser des connexions chiffrées lorsque c'est possible
  • Valider toutes les entrées et configurations
  • Mettre en place des contrôles d'accès appropriés

Rendement

  • Utiliser des limites de ressources appropriées pour votre environnement
  • Surveiller régulièrement les performances du système
  • Optimisez la configuration pour votre cas d'utilisation
  • Utiliser le traitement parallèle lorsque bénéfique
  • Mettre en œuvre des stratégies de mise en cache appropriées
  • Entretien et nettoyage réguliers
  • Goulets d'étranglement de performance du profil
  • Utiliser des algorithmes et des structures de données efficaces

Opérations

  • Tenir une documentation complète
  • Mettre en œuvre des stratégies de sauvegarde appropriées
  • Utiliser le contrôle de version pour les configurations
  • Surveiller et alerter les mesures critiques
  • Mettre en œuvre un traitement approprié des erreurs
  • Utiliser l'automatisation pour les tâches répétitives
  • Vérifications et mises à jour régulières de la sécurité
  • Plan de reprise après sinistre

Développement

  • Suivre les normes et conventions de codage
  • Écrire des tests complets
  • Utiliser l'intégration/déploiement continu
  • Mettre en œuvre une exploitation et un suivi appropriés
  • Documenter les API et les interfaces
  • Utiliser efficacement le contrôle de version
  • Révision régulière du code
  • Maintenir la compatibilité arrière

Ressources

Documentation officielle

  • [Site Web officiel] (LINK_18)
  • [Documentation] (LINK_18)
  • [Référence API] (LINK_18)
  • [Guide d'installation] (LINK_18)
  • [Référence de configuration] (LINK_18)

Ressources communautaires

  • [Répertoire GitHub] (LINK_18)
  • [Suivi d'émission] (LINK_18)
  • [Forum communautaire] (LINK_18)
  • [Serveur de discorde] (LINK_18)
  • [Communauté Reddit] (LINK_18)
  • [Débordement de la pile] (LINK_18)

Ressources pédagogiques

  • [Guide de démarrage] (LINK_18)
  • [Série turque] (LINK_18)
  • [Guide des meilleures pratiques] (LINK_18)
  • [Tutoriels vidéo] (LINK_18)
  • [Cours de formation] (LINK_18)
  • [Programme de certification] (LINK_18)

Outils connexes

  • Git - Fonctionnalité complémentaire
  • [Docker] (LINK_18) - Solution alternative
  • Kubernetes - Partenaire d'intégration

*Dernière mise à jour : 2025-07-06.