{"id":22880637,"url":"https://github.com/elliotsecops/ghost-tunnel","last_synced_at":"2025-05-07T02:22:17.855Z","repository":{"id":188806695,"uuid":"679465483","full_name":"elliotsecops/Ghost-Tunnel","owner":"elliotsecops","description":"Este proyecto implementa un poderoso túnel SSH totalmente anónimo utilizando la red Tor y múltiples proxies intermedios. Permite enrutar cualquier tráfico de red a través de este túnel de forma altamente privada y anónima.","archived":false,"fork":false,"pushed_at":"2023-08-17T13:56:21.000Z","size":12,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T05:23:28.095Z","etag":null,"topics":["network-security","privacy","security-tools","tor-browser","tor-network","tor-proxy"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elliotsecops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-16T23:03:57.000Z","updated_at":"2024-10-02T14:17:39.000Z","dependencies_parsed_at":"2023-08-18T21:26:33.828Z","dependency_job_id":null,"html_url":"https://github.com/elliotsecops/Ghost-Tunnel","commit_stats":null,"previous_names":["elliott-fibonacci/ghost-tunnel","elliotsecops/ghost-tunnel"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elliotsecops%2FGhost-Tunnel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elliotsecops%2FGhost-Tunnel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elliotsecops%2FGhost-Tunnel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elliotsecops%2FGhost-Tunnel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elliotsecops","download_url":"https://codeload.github.com/elliotsecops/Ghost-Tunnel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252799235,"owners_count":21805957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["network-security","privacy","security-tools","tor-browser","tor-network","tor-proxy"],"created_at":"2024-12-13T17:20:29.377Z","updated_at":"2025-05-07T02:22:17.822Z","avatar_url":"https://github.com/elliotsecops.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Túnel SSH Anónimo sobre Tor \n\nEste proyecto implementa un poderoso túnel SSH totalmente anónimo utilizando la red Tor y múltiples proxies intermedios. Permite enrutar cualquier tráfico de red a través de este túnel de forma altamente privada y anónima.\n\n## Características Principales\n\n- **Rotación automática de servidores SSH intermediarios** - La conexión se establece cada vez a través de un servidor SSH diferente de una lista rotativa. Esto maximiza el anonimato al no utilizar el mismo servidor dos veces.\n\n- **Obtención de nuevas identidades Tor** - Se obtienen periódicamente nuevas identidades y circuitos Tor para prevenir el rastreo de la dirección IP de salida. La IP de salida se rota constantemente.\n\n- **Autenticación con proxies** - Soporta la autenticación con credenciales en los proxies SOCKS5 intermedios para permitir el uso de proxies privados.\n\n- **Totalmente enrutado a través de SSH** - Todo el tráfico se enruta automáticamente a través del túnel SSH utilizando PySocks. No es necesaria ninguna configuración especial en las aplicaciones.\n\n- **Funciona con cualquier aplicación** - Al enrutar el tráfico a nivel de sistema, cualquier aplicación que utilice sockets funcionará directamente a través del túnel SSH. No se requiere soporte explícito de proxies.\n\n- **Scripts para rotar identidad y proxy** - Se incluyen scripts simples para obtener una nueva identidad Tor o proxy intermediario bajo demanda. Útil para rotar periodicamente.\n\n## Requisitos Previos\n\nPara utilizar este túnel SSH anónimo se requiere tener instalado:\n\n- **Python 3** - El intérprete de Python 3.6 o superior.\n- **Stem** - Biblioteca Python para interactuar con Tor.\n- **PySocks** - Permite enrutar tráfico a través de proxies SOCKS.\n- **Paramiko** - Módulo SSH para Python.\n\nAdemás se debe tener:\n\n- Acceso a servidores **SSH** que permitan tunneling (ej: en la nube).\n- El servicio **Tor** corriendo y accesible en localhost:9050 (mediante Tor Browser Bundle o tor).\n- Proxies **SOCKS5** compatibles con autenticación (opcional).\n\n## Configuración\n\nAntes de ejecutar el script se deben configurar los siguientes valores:\n\n- `ssh_hosts` - Lista de servidores SSH intermediarios\n- `ssh_user` - Usuario para conectar a los servidores SSH\n- `ssh_password` - Contraseña asociada\n- `proxies_user` - Usuario para autenticarse con los proxies\n- `proxies_password` - Contraseña para los proxies\n\nUn ejemplo de configuración sería:\n\n```python\nssh_hosts = ['servidor1.com', 'servidor2.net']\nssh_user = 'tuneluser'\nssh_password = 'contraseñaSegura' \nproxies_user = 'proxiusuario'\nproxies_password = 'secreta123'\n```\n\n## Uso\n\nUna vez configurado, para iniciar el túnel SSH simplemente ejecutar el script Python:\n\n```bash\npython tunelssh.py\n```\n\nEsto establecerá el túnel a través de un servidor SSH intermediario elegido al azar y configurará el sistema para enrutar todo el tráfico a través de él.\n\nLuego se puede verificar que el tráfico sale a través de Tor utilizando un servicio como [OnionCheck ↗](https://onioncheck.com/).\n\n## Rotación de Identidad y Proxy\n\nPara rotar la IP de salida de Tor se puede ejecutar el siguiente script:\n\n```bash\npython nueva_identidad.py\n```\n\nEsto forzará la obtención de un nuevo circuito y dirección IP de salida.\n\nDe forma similar, para cambiar el proxy SOCKS5 intermediario:\n\n```bash\npython nuevo_proxy.py\n```\n\nSe recomienda rotar periodicamente tanto la IP de Tor como el proxy para maximizar el anonimato.\n\n## Contribuciones\n\nEste proyecto es de código abierto, así que son bienvenidas las contribuciones vía pull requests:\n\n- Mejoras de rendimiento y estabilidad.\n- Soporte para otras plataformas.\n- Compatibilidad con otras bibliotecas.\n- Características de seguridad adicionales.\n\n(English)\n\n# Anonymous Tor SSH Tunnel\n\nThis project implements a powerful, fully anonymous SSH tunnel using the Tor network and multiple proxy servers. It allows routing any network traffic through this tunnel in a highly private and anonymous way.\n\n## Main Features\n\n- **Rotating SSH proxies** - The connection is established each time through a different SSH server from a rotating list. This maximizes anonymity by not using the same server twice.\n\n- **Getting new Tor identities** - New Tor identities and circuits are periodically obtained to prevent tracking of the exit IP address. The exit IP rotates constantly.\n\n- **Proxy authentication** - Supports credential-based authentication with SOCKS5 proxy servers to allow the use of private proxies.\n\n- **Fully SSH-routed** - All traffic is automatically routed through the SSH tunnel using PySocks. No special configuration required in applications.\n\n- **Works with any app** - By routing at the system level, any socket-using app will work directly through the SSH tunnel. No explicit proxy support needed.\n\n- **Scripts for rotating** - Includes simple scripts to get a new Tor identity or proxy on demand. Useful for periodic rotation.\n\n## Requirements\n\nTo use this anonymous SSH tunnel you need to have installed:\n\n- **Python 3** - The Python 3.6 or later interpreter.\n- **Stem** - Python library for interacting with Tor.\n- **PySocks** - Allows routing traffic through SOCKS proxies.\n- **Paramiko** - SSH module for Python.\n\nAdditionally required:\n\n- Access to **SSH** servers allowing tunneling (e.g. in the cloud).\n- The **Tor** service running and accessible on localhost:9050 (via Tor Browser Bundle or tor).\n- **SOCKS5** proxies compatible with authentication (optional).\n\n## Configuration\n\nBefore running the script, the following values must be configured:\n\n- `ssh_hosts` - List of intermediate SSH servers\n- `ssh_user` - Username for connecting to SSH servers\n- `ssh_password` - Associated password\n- `proxies_user` - Username for proxy authentication\n- `proxies_password` - Password for proxies\n\nA configuration example:\n\n```python\nssh_hosts = ['server1.com', 'server2.net']\nssh_user = 'tunneluser' \nssh_password = 'securePassword'\nproxies_user = 'proxyuser'\nproxies_password = 'secret123'\n```\n\n## Usage\n\nOnce configured, to start the SSH tunnel simply run the Python script:\n\n```bash\npython ssh_tunnel.py\n```\n\nThis will establish the tunnel through a randomly chosen intermediate SSH server and configure the system to route all traffic through it.\n\nYou can then check that traffic is exiting through Tor using a service like [OnionCheck](https://onioncheck.com/).\n\n## Identity and Proxy Rotation\n\nTo rotate the Tor exit IP, run the following script:\n\n```bash\npython new_identity.py\n```\n\nThis will force a new circuit and exit IP address.\n\nSimilarly, to change the intermediate SOCKS5 proxy:\n\n```bash\npython new_proxy.py \n```\n\nIt's recommended to periodically rotate both the Tor IP and proxy for maximum anonymity.\n\n## Contributing\n\nThis is an open source project, so contributions are welcome via pull requests:\n\n- Performance and stability improvements.\n- Support for other platforms.\n- Compatibility with other libraries.\n- Additional security features.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felliotsecops%2Fghost-tunnel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felliotsecops%2Fghost-tunnel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felliotsecops%2Fghost-tunnel/lists"}