{"id":28758783,"url":"https://github.com/juliandavidmr/tor-relay-docker","last_synced_at":"2026-04-21T05:31:53.535Z","repository":{"id":296475938,"uuid":"993523315","full_name":"juliandavidmr/tor-relay-docker","owner":"juliandavidmr","description":"Configura un nodo relay Tor usando Docker Compose","archived":false,"fork":false,"pushed_at":"2025-05-31T00:31:04.000Z","size":291,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-31T11:00:32.800Z","etag":null,"topics":["docker","docker-compose","docker-container","nyx","relay","tor"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/juliandavidmr.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,"zenodo":null}},"created_at":"2025-05-31T00:15:10.000Z","updated_at":"2025-05-31T00:56:44.000Z","dependencies_parsed_at":"2025-05-31T11:00:35.611Z","dependency_job_id":"2eb9eef9-feff-495a-aaa1-a83e05ef0581","html_url":"https://github.com/juliandavidmr/tor-relay-docker","commit_stats":null,"previous_names":["juliandavidmr/tor-relay-docker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/juliandavidmr/tor-relay-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliandavidmr%2Ftor-relay-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliandavidmr%2Ftor-relay-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliandavidmr%2Ftor-relay-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliandavidmr%2Ftor-relay-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juliandavidmr","download_url":"https://codeload.github.com/juliandavidmr/tor-relay-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliandavidmr%2Ftor-relay-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260288454,"owners_count":22986669,"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":["docker","docker-compose","docker-container","nyx","relay","tor"],"created_at":"2025-06-17T04:09:46.207Z","updated_at":"2026-04-21T05:31:48.507Z","avatar_url":"https://github.com/juliandavidmr.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nodo Relay Tor - relaycoldav\n\nEste proyecto configura un nodo relay Tor usando Docker Compose con las siguientes características:\n\n## Especificaciones\n\n- **Nombre del nodo**: `relaycoldav`\n- **Email de contacto**: `email@email.com`\n- **Puertos**: 9001 (OR), 9030 (Dir), 9051 (Control)\n- **Ancho de banda limitado**: 512 KB/s sostenido, 1 MB/s burst\n- **Herramientas incluidas**: Nyx para monitoreo interno\n\n![demo](./doc/Screenshot_2025-05-30_19-28-47.png)\n\n## Instalación y uso\n\n### 1. Clonar o crear el proyecto\n\n```bash\nmkdir tor-relay \u0026\u0026 cd tor-relay\n# Copiar todos los archivos proporcionados\n```\n\n### 2. Preparar el entorno\n\n```bash\n# Ejecutar script de preparación (requiere sudo)\nchmod +x setup.sh\n./setup.sh\n```\n\n### 3. Construir y ejecutar\n\n```bash\n# Construir e iniciar el contenedor\ndocker-compose up -d\n\n# Ver logs en tiempo real\ndocker-compose logs -f\n```\n\n### 3. Monitoreo con Nyx\n\n```bash\n# Acceder al contenedor y ejecutar Nyx\ndocker exec -it tor-relay-coldav nyx\n```\n\n### 4. Verificar el estado del relay\n\n```bash\n# Ver logs del relay\ndocker exec -it tor-relay-coldav tail -f /var/log/tor/notices.log\n\n# Verificar conectividad\ndocker exec -it tor-relay-coldav curl -s https://check.torproject.org/\n```\n\n## Configuración de ancho de banda\n\nEl relay está configurado con límites de ancho de banda bajos para minimizar el uso de recursos:\n\n- **RelayBandwidthRate**: 512 KB/s (velocidad sostenida)\n- **RelayBandwidthBurst**: 1 MB/s (velocidad máxima temporal)\n- **AccountingMax**: 10 GB por mes\n\n## Comandos útiles\n\n### Gestión del contenedor\n\n```bash\n# Iniciar el relay\ndocker-compose up -d\n\n# Detener el relay\ndocker-compose down\n\n# Reiniciar el relay\ndocker-compose restart\n\n# Ver estado\ndocker-compose ps\n```\n\n### Monitoreo y logs\n\n```bash\n# Ejecutar Nyx (monitor interactivo)\ndocker exec -it tor-relay-coldav nyx\n\n# Ver logs de Tor\ndocker exec -it tor-relay-coldav tail -f /var/log/tor/notices.log\n\n# Ver información del sistema\ndocker exec -it tor-relay-coldav ps aux\n```\n\n### Verificación externa\n\n```bash\n# Buscar tu relay en la red Tor (después de unas horas)\ncurl -s \"https://metrics.torproject.org/rs.html#search/relaycoldav\"\n```\n\n## Configuración de firewall\n\nAsegúrate de que los puertos estén abiertos en tu firewall:\n\n```bash\n# Para Ubuntu/Debian con ufw\nsudo ufw allow 9001\nsudo ufw allow 9030\n\n# Para CentOS/RHEL con firewalld\nsudo firewall-cmd --permanent --add-port=9001/tcp\nsudo firewall-cmd --permanent --add-port=9030/tcp\nsudo firewall-cmd --reload\n```\n\n## Seguridad\n\n- El contenedor ejecuta con usuario no privilegiado\n- Configuración de solo lectura en el sistema de archivos\n- Políticas de seguridad aplicadas (no-new-privileges)\n- Exit policy configurada para rechazar todo el tráfico de salida\n\n## Notas importantes\n\n1. **Tiempo de activación**: Los nuevos relays pueden tardar algunas horas o días en aparecer en el consenso de la red Tor.\n\n2. **Responsabilidad legal**: Ejecutar un relay Tor es legal en la mayoría de jurisdicciones, pero asegúrate de cumplir con las leyes locales.\n\n3. **Recursos**: Aunque está limitado el ancho de banda, el relay seguirá consumiendo CPU y memoria según el tráfico.\n\n4. **Actualizaciones**: Mantén actualizada la imagen de Tor para recibir parches de seguridad.\n\n## Troubleshooting\n\n### Error \"no se puede escribir en /var/lib/tor\"\n\nEste error indica problemas de permisos. Soluciones:\n\n```bash\n# Detener el contenedor si está corriendo\ndocker-compose down\n\n# Ejecutar el script de preparación\n./setup.sh\n\n# O configurar manualmente los permisos\nsudo chown -R 1001:1001 ./logs\nchmod 755 ./logs\n\n# Reiniciar el contenedor\ndocker-compose up -d\n```\n\n### El relay no aparece en la red\n\n- Verifica que los puertos estén abiertos y accesibles desde Internet\n- Revisa los logs para errores de configuración\n- Asegúrate de que la hora del sistema sea correcta\n\n### Problemas de conectividad\n\n```bash\n# Verificar conectividad de puertos\ndocker exec -it tor-relay-coldav netstat -tlnp\n\n# Probar conectividad externa\ndocker exec -it tor-relay-coldav curl -s https://check.torproject.org/\n```\n\n### Logs con errores\n\n```bash\n# Ver logs detallados\ndocker exec -it tor-relay-coldav tail -f /var/log/tor/info.log\n\n# Verificar configuración\ndocker exec -it tor-relay-coldav tor --verify-config -f /etc/tor/torrc\n```\n\n## Contribución\n\nPara contribuir al proyecto:\n1. Realiza un fork del repositorio\n2. Crea una rama para tu feature\n3. Realiza tus cambios\n4. Envía un pull request\n\n## Licencia\n\nEste proyecto está bajo la licencia MIT. Tor está bajo la licencia BSD de 3 cláusulas.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliandavidmr%2Ftor-relay-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuliandavidmr%2Ftor-relay-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliandavidmr%2Ftor-relay-docker/lists"}