secubox-openwrt/package/secubox/luci-app-tor-shield/README.fr.md

English | Francais | 中文

Tor Shield - Routage anonyme simplifie

Protection de la vie privee a l'echelle du reseau via le reseau Tor avec activation en un clic.

Fonctionnalites

Modes de protection

Mode	Description	Cas d'usage
Proxy transparent	Tout le trafic reseau route automatiquement via Tor	Anonymat reseau complet
Proxy SOCKS	Applications se connectent via SOCKS5 (127.0.0.1:9050)	Protection selective des applications
Mode Bridge	Utilise les bridges obfs4/meek pour contourner la censure	Reseaux restrictifs

Presets de demarrage rapide

Preset	Icone	Configuration
Anonymat complet	Protection	Transparent + DNS sur Tor + Kill Switch
Applications selectives	Cible	SOCKS uniquement, pas de kill switch
Contourner la censure	Deverrouillage	Bridges actives + obfs4

Fonctionnalites de securite

• Kill Switch - Bloque tout le trafic si Tor se deconnecte
• DNS sur Tor - Previent les fuites DNS
• Nouvelle identite - Demander de nouveaux circuits instantanement
• Test de fuite - Verifier que votre protection fonctionne
• Services caches - Heberger des sites .onion

Tableau de bord

Le tableau de bord fournit une surveillance en temps reel :

+--------------------------------------------------+
|  Tor Shield                           Protege    |
+--------------------------------------------------+
|                                                  |
|  +------------+    Votre statut de protection    |
|  |   Onion    |    --------------------------    |
|  |   Toggle   |    IP reelle:    192.168.x.x     |
|  |            |    Sortie Tor:   185.220.x.x DE  |
|  +------------+                                  |
|                                                  |
|  +---------------------------------------------+ |
|  | Anonymat    | Apps        | Contournement  | |
|  | complet     | selectives  | censure        | |
|  +---------------------------------------------+ |
|                                                  |
|  Circuits: 5  | 45 KB/s  | 2h 15m                |
|  DL: 125 MB   | UL: 45 MB|                       |
|                                                  |
|  +---------+---------+---------+---------+       |
|  | Service | Boot    | DNS     | Kill    |       |
|  | Running | 100%    | Protege | Actif   |       |
|  +---------+---------+---------+---------+       |
+--------------------------------------------------+

Services caches

Hebergez vos services sur le reseau Tor avec des adresses .onion :

# Via LuCI
Services -> Tor Shield -> Services caches -> Ajouter

# Via CLI
ubus call luci.tor-shield add_hidden_service '{"name":"monsite","local_port":80,"virtual_port":80}'

# Obtenir l'adresse onion
cat /var/lib/tor/hidden_service_monsite/hostname

Exemples de services caches

Service	Port local	Port Onion	Cas d'usage
Serveur web	80	80	Site web anonyme
SSH	22	22	Acces distant securise
API	8080	80	Point d'acces API anonyme

Bridges

Contournez la censure reseau en utilisant les bridges Tor :

Types de bridge

Type	Description	Quand l'utiliser
obfs4	Protocole obfusque	La plupart des reseaux censures
meek-azure	Domain fronting via Azure	Reseaux tres restrictifs
snowflake	Base sur WebRTC	Decouverte dynamique de bridges

Detection automatique des bridges

# Activer la selection automatique des bridges
uci set tor-shield.main.auto_bridges=1
uci commit tor-shield
/etc/init.d/tor-shield restart

Configuration

Parametres UCI

# /etc/config/tor-shield

config tor-shield 'main'
    option enabled '1'
    option mode 'transparent'      # transparent | socks
    option dns_over_tor '1'        # Router DNS via Tor
    option kill_switch '1'         # Bloquer trafic si Tor echoue
    option auto_bridges '0'        # Auto-detecter la censure

config socks 'socks'
    option port '9050'
    option address '127.0.0.1'

config trans 'trans'
    option port '9040'
    option dns_port '9053'
    list excluded_ips '192.168.255.0/24'  # Bypass LAN

config bridges 'bridges'
    option enabled '0'
    option type 'obfs4'

config security 'security'
    option exit_nodes ''           # Codes pays : {us},{de}
    option exclude_exit_nodes ''   # Eviter : {ru},{cn}
    option strict_nodes '0'

config hidden_service 'hs_monsite'
    option enabled '1'
    option name 'monsite'
    option local_port '80'
    option virtual_port '80'

API RPCD

Statut et controle

# Obtenir le statut
ubus call luci.tor-shield status

# Activer avec preset
ubus call luci.tor-shield enable '{"preset":"anonymous"}'

# Desactiver
ubus call luci.tor-shield disable

# Redemarrer
ubus call luci.tor-shield restart

# Demander une nouvelle identite
ubus call luci.tor-shield new_identity

# Verifier les fuites
ubus call luci.tor-shield check_leaks

Gestion des circuits

# Obtenir les circuits actifs
ubus call luci.tor-shield circuits

# Reponse :
{
  "circuits": [{
    "id": "123",
    "status": "BUILT",
    "path": "$A~Guard,$B~Middle,$C~Exit",
    "purpose": "GENERAL",
    "nodes": [
      {"fingerprint": "ABC123", "name": "Guard"},
      {"fingerprint": "DEF456", "name": "Middle"},
      {"fingerprint": "GHI789", "name": "Exit"}
    ]
  }]
}

Services caches

# Lister les services caches
ubus call luci.tor-shield hidden_services

# Ajouter un service cache
ubus call luci.tor-shield add_hidden_service '{"name":"web","local_port":80,"virtual_port":80}'

# Supprimer un service cache
ubus call luci.tor-shield remove_hidden_service '{"name":"web"}'

Statistiques de bande passante

# Obtenir la bande passante
ubus call luci.tor-shield bandwidth

# Reponse :
{
  "read": 125000000,      # Total octets telecharges
  "written": 45000000,    # Total octets uploades
  "read_rate": 45000,     # Taux de telechargement actuel (octets/sec)
  "write_rate": 12000     # Taux d'upload actuel (octets/sec)
}

Depannage

Tor ne demarre pas

# Verifier les logs
logread | grep -i tor

# Verifier la config
tor --verify-config -f /var/run/tor/torrc

# Verifier le socket de controle
ls -la /var/run/tor/control

Connexions lentes

1. Verifier le bootstrap - Attendre 100% de completion
2. Essayer les bridges - Le reseau peut throttler Tor
3. Changer de circuits - Cliquer "Nouvelle identite"
4. Verifier les noeuds de sortie - Certaines sorties sont lentes

Fuites DNS

# Verifier que DNS passe par Tor
nslookup check.torproject.org

# Devrait resoudre via Tor DNS (127.0.0.1:9053)

Problemes de Kill Switch

# Verifier les regles firewall
iptables -L -n | grep -i tor

# Verifier la config du kill switch
uci get tor-shield.main.kill_switch

Emplacements des fichiers

Chemin	Description
/etc/config/tor-shield	Configuration UCI
/var/run/tor/torrc	Config Tor generee
/var/run/tor/control	Socket de controle
/var/lib/tor/	Repertoire de donnees Tor
/var/lib/tor/hidden_service_*/	Cles des services caches
/tmp/tor_exit_ip	IP de sortie en cache
/tmp/tor_real_ip	IP reelle en cache

Notes de securite

1. Kill Switch - Toujours activer pour une protection maximale
2. Fuites DNS - Activer DNS sur Tor pour prevenir les fuites
3. Services caches - Les cles dans /var/lib/tor/ sont sensibles - sauvegardez-les en securite
4. Noeuds de sortie - Envisagez d'exclure certains pays pour un usage sensible
5. Bridges - Utilisez-les si votre FAI bloque ou throttle Tor

Licence

Licence MIT - Copyright (C) 2025 CyberMind.fr