{"id":13633215,"url":"https://github.com/bit4mind/anon-service","last_synced_at":"2025-04-18T10:34:21.327Z","repository":{"id":52801133,"uuid":"316360105","full_name":"bit4mind/anon-service","owner":"bit4mind","description":"Transparent proxy through Tor with optionally DNSCrypt and Anonymized-DNS feature enabled.","archived":false,"fork":false,"pushed_at":"2024-07-23T23:23:30.000Z","size":456,"stargazers_count":14,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-09T02:33:54.278Z","etag":null,"topics":["anonymity","anonymized","anonymized-dns","dns","dnscrypt","dnscrypt-proxy","iptables","privacy","proxy","security","shell","tor","transparent-proxy","unbound"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bit4mind.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"2020-11-26T23:58:19.000Z","updated_at":"2024-10-20T13:55:40.000Z","dependencies_parsed_at":"2024-08-01T23:37:14.151Z","dependency_job_id":null,"html_url":"https://github.com/bit4mind/anon-service","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bit4mind%2Fanon-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bit4mind%2Fanon-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bit4mind%2Fanon-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bit4mind%2Fanon-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bit4mind","download_url":"https://codeload.github.com/bit4mind/anon-service/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249479054,"owners_count":21279187,"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":["anonymity","anonymized","anonymized-dns","dns","dnscrypt","dnscrypt-proxy","iptables","privacy","proxy","security","shell","tor","transparent-proxy","unbound"],"created_at":"2024-08-01T23:00:30.822Z","updated_at":"2025-04-18T10:34:21.055Z","avatar_url":"https://github.com/bit4mind.png","language":"Shell","readme":"# anon-service\n\nTransparent proxy through Tor with optionally DNSCrypt and Anonymized-DNS feature enabled.\n\nFrom Wikipedia: Tor is free and open-source software for enabling anonymous\ncommunication by directing Internet traffic through a free, worldwide, volunteer\noverlay network consisting of more than seven thousand relays in order to \nconceal a user's location and usage from anyone conducting network surveillance\nor traffic analysis. Using Tor makes it more difficult to trace Internet\nactivity to the user: this includes \"visits to Web sites, online posts, instant \nmessages, and other communication forms\".\nThe task of this script is to redirect outgoing connections through \"The Onion \nRouter\" network and optionally to provide encryption/authentication to DNS traffic \nin the clearnet via dnscrycpt/DNSSEC, leaving the resolution of onion domains to the \nTor DNS resolvers.\nAll applications will use the TOR network even if they do not support SOCKS.\nThe script supports Anonymized-DNS feature and is able to find the correct \nversion for your distribution by downloading it directly from the TOR Project \nrepository.\n\n\n\n## REQUIREMENTS\n\n\nThe script should work on many debian-based distros (desktop and server) with the Unbound package present \nin the repositories. Tested on Debian, Ubuntu, Mint.\n\n\n\n## HOW IT WORKS\nYou can execute all tasks via command-line or via the interactive menu.\nThe default mode (starting the script without any options) is the interactive menu.\nThe interactive menu works as a launcher: after installing the necessary software, you can select\nthe transparent proxy type or reconfigure resolvers/relays before each \nreactivation of the service; you can stop the service without deleting the data\nand then reactivate it faster.\nYou can install it to start automatically at boot: in this case you could restart\nservice simply restarting your connection and continue to use the script for\nediting configuration file, configuring dnscrypt servers and relays, viewing logs or removing all things.\nEditing torrc file you can customize your tor configuration (https://tor.void.gr/docs/tor-manual.html.en).\nEditing iptables rules you can grant yourself ssh access from remote machines, enable logging and other stuff.\nViewing the log file you can retrieve information about the activity of the Tor process.\n\nUsage:\n\n```\nchmod +x anon-service.sh\n```\n```\nsudo ./anon-service.sh --help\n\n ./anon-service.sh [option] \u003cvalue\u003e \u003cserver1\u003e \u003cserver2\u003e \u003crelay1\u003e \u003crelay2\u003e \u003crelay3\u003e \u003crelay4\u003e\n\nOptions:\n --download  \u003cvalue\u003e  check dependencies and download them\n                      \u003cvalue\u003e Tor from: -1 Tor Project repository\n                      -2 OS repository -3 already installed\n --configure \u003cvalue\u003e  choose transparent proxy type\n                      \u003cvalue\u003e -1 standard -2 with DNSCrypt\n --start              start service\n --stop               exit without removing service files and settings\n --restart            restart service\n --status             display status service\n --menu               display interactive menu\n --install            install this script\n --permanent          enable service to start automatically at boot\n --remove             exit removing files and settings from system\n --edit      \u003cvalue\u003e  edit configuraion files\n                      \u003cvalue\u003e torrc or iptables\n --restore            restore original files and settings\n \n --help               display this help\n --version            display version\n  --log      \u003cvalue\u003e  view Tor log file\n                      \u003cvalue\u003e cached or realtime\n```\nExamples:\n\n```\nsudo ./anon-service.sh --download -1 \u0026\u0026 sudo ./anon-service.sh --configure -1 \u0026\u0026 sudo ./anon-service.sh --start\n```\n\nThis will start the service in standard transparent proxy mode getting Tor from the official project repository.\n```\nsudo ./anon-service.sh --download -1 \u0026\u0026 sudo ./anon-service.sh --configure -2 dnscrypt-de-blahdns-ipv4 meganerd anon-v.dnscrypt.uk-ipv4 anon-openinternet anon-v.dnscrypt.uk-ipv4 anon-sth-se \u0026\u0026 sudo ./anon-service.sh --start\n```\nThis will start the service with DNSCrypt and the Anonymized-DNS feature enabled by obtaining Tor from the official\nproject repository. \nChange servers and relays to whatever you want based on the updated list of public resolvers \nand relays provided by the dnscrypt-proxy project.\n\n### Important: \nIf you want to update the script, first remove all files and settings using the \nappropriate option in the same script.\n\nNOTES:\nThe command-line download option will install the software required to run without \na graphical environment: some interactive menu options may not work.\nIf you install the script to start automatically at boot, be aware that the service \nwill start with a small delay after the host has established the connection to the \nnetwork. \nBefore the service is fully loaded, the connection will not work: you can \ncheck status via syslog with the command:\n\n```\ntail -f /var/log/syslog\n```\n\nIf you enable service to start automatically at boot, will be configured\nthe last type of trasparent proxy used.\n\n### WARNING\n\nThis is NOT a solution that grants strong anonymity and the developers themselves \ndo not recommend using tor as a transparent proxy\n(https://trac.torproject.org/projects/tor/wiki/doc/TransparentProxy).\nWhen you browse the web even if you do not use personal data and hide your IP address,\ntraces are left that can uniquely identify your machine such as the hostname and mac \naddress of the network device. Your browser itself can uniquely identify you: from \nthe point of view of tracking/fingerprinting Tor browser guarantees greater security \nbecause it already comes with built-in fixes and extensions like Noscript and HTTPS \nEverywhere, useful to avoid some attacks and tracking methods.\nHowever you could still use Tor browser (without DNSCrypt/DNSSEC) even while the\nservice is running, but this scenario is also not recommended\n(https://trac.torproject.org/projects/tor/wiki/doc/TorifyHOWTO#ToroverTor).\nIf you are looking for a strong anonymity solution, switch to Linux distributions \nfocused on security and privacy like Whomix or Tails.\n\n## TROUBLESHOTTING\n\nSystem update may create permissions issues with Unbound: first remove Unbound package purging\nthe configuration files, then reinstall it and reconfigure the service via the \ndedicated option.\nIf something goes wrong (e.g. electrical blackout) restore the original data and settings\nusing the dedicated option or remove the service.\n","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbit4mind%2Fanon-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbit4mind%2Fanon-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbit4mind%2Fanon-service/lists"}