{"id":13580698,"url":"https://github.com/PeterDaveHello/tor-socks-proxy","last_synced_at":"2025-04-06T02:32:29.959Z","repository":{"id":37432205,"uuid":"78484832","full_name":"PeterDaveHello/tor-socks-proxy","owner":"PeterDaveHello","description":"🐳 Tiny Docker image (🤏 10MB) as 🧅 Tor SOCKS5 proxy 🛡","archived":false,"fork":false,"pushed_at":"2024-12-11T17:28:49.000Z","size":54,"stargazers_count":561,"open_issues_count":19,"forks_count":123,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-02-13T08:22:19.724Z","etag":null,"topics":["hacktoberfest","onion","privacy","proxy","proxy-server","socks","socks-proxy","socks5","tor","tor-socks-proxy","web"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/peterdavehello/tor-socks-proxy/","language":"Dockerfile","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/PeterDaveHello.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"PeterDaveHello","open_collective":"peterdavehello","ko_fi":"peterdavehello","liberapay":"PeterDaveHello","issuehunt":"peterdavehello"}},"created_at":"2017-01-10T01:17:36.000Z","updated_at":"2025-02-10T14:56:34.000Z","dependencies_parsed_at":"2024-12-20T15:48:53.110Z","dependency_job_id":null,"html_url":"https://github.com/PeterDaveHello/tor-socks-proxy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterDaveHello%2Ftor-socks-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterDaveHello%2Ftor-socks-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterDaveHello%2Ftor-socks-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeterDaveHello%2Ftor-socks-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PeterDaveHello","download_url":"https://codeload.github.com/PeterDaveHello/tor-socks-proxy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247426386,"owners_count":20937112,"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":["hacktoberfest","onion","privacy","proxy","proxy-server","socks","socks-proxy","socks5","tor","tor-socks-proxy","web"],"created_at":"2024-08-01T15:01:54.342Z","updated_at":"2025-04-06T02:32:29.681Z","avatar_url":"https://github.com/PeterDaveHello.png","language":"Dockerfile","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"300px\" src=\"https://upload.wikimedia.org/wikipedia/commons/8/8f/Tor_project_logo_hq.png\"\u003e\n\u003c/p\u003e\n\n# Tor-socks-proxy\n\n![license](https://img.shields.io/badge/license-GPLv3.0-brightgreen.svg?style=flat)\n[![Build Status](https://app.travis-ci.com/PeterDaveHello/tor-socks-proxy.svg?branch=master)](https://app.travis-ci.com/PeterDaveHello/tor-socks-proxy)\n[![Docker Hub pulls](https://img.shields.io/docker/pulls/peterdavehello/tor-socks-proxy.svg)](https://hub.docker.com/r/peterdavehello/tor-socks-proxy/)\n\n[![Docker Hub badge](http://dockeri.co/image/peterdavehello/tor-socks-proxy)](https://hub.docker.com/r/peterdavehello/tor-socks-proxy/)\n\nThe super easy way to set up a [Tor](https://www.torproject.org) [SOCKS5](https://en.wikipedia.org/wiki/SOCKS#SOCKS5) [proxy server](https://en.wikipedia.org/wiki/Proxy_server) inside a [Docker](https://en.wikipedia.org/wiki/Docker_(software)) [container](https://en.wikipedia.org/wiki/Container_(virtualization)), without Tor relay/exit node function enabled.\n\n## Docker image Repository\n\nWe push the built image to Docker Hub and GitHub Container Registry:\n\n- GitHub Container Registry:\n  - `ghcr.io/peterdavehello/tor-socks-proxy`\n  - \u003chttps://github.com/PeterDaveHello/tor-socks-proxy/pkgs/container/tor-socks-proxy\u003e\n- Docker Hub:\n  - `peterdavehello/tor-socks-proxy`\n  - \u003chttps://hub.docker.com/r/peterdavehello/tor-socks-proxy/\u003e\n\nUse the prefix `ghcr.io/` if you prefer to use GitHub Container Registry.\n\n## Usage\n\n### First-Time Setup\n\n```sh\ndocker run -d --restart=always --name tor-socks-proxy -p 127.0.0.1:9150:9150/tcp peterdavehello/tor-socks-proxy:latest\n```\n\n- `--restart=always`: This ensures the container automatically restarts whenever the system reboots.\n- `-p 127.0.0.1:9150:9150/tcp`: This binds the container to localhost, and you should not change this IP unless you want to expose the proxy to a local network or the Internet.\n  - You can change the first `9150` to any available port. Please note that ports `9050`/`9150` may be occupied if you are running another Tor client like TorBrowser.\n\n### Start or stop an existing Instance manually\n\n```sh\ndocker start tor-socks-proxy\n```\n\n```sh\ndocker stop tor-socks-proxy\n```\n\n### Checking the Proxy Status and logs\n\n```sh\ndocker logs tor-socks-proxy\n```\n\n### Configuring a Client to Use the Proxy\n\n```sh\ncurl --socks5-hostname 127.0.0.1:9150 https://ipinfo.tw/ip\n```\n\n### Stopping the Proxy\n\n```sh\ndocker stop tor-socks-proxy\n```\n\n## IP Renewal\n\nBy default, Tor automatically changes IPs every 10 minutes. You can manually renew the IP by restarting the container:\n\n```sh\ndocker restart tor-socks-proxy\n```\n\n## DNS over Tor\n\nPublish DNS port during setup to query DNS requests over Tor:\n\n```sh\ndocker run -d --restart=always --name tor-socks-proxy -p 127.0.0.1:9150:9150/tcp -p 127.0.0.1:53:8853/udp peterdavehello/tor-socks-proxy:latest\n```\n## Sponsor\n\n\u003ca href=\"https://m.do.co/c/1fdd0a1d695a\"\u003e\u003cimg src=\"https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg\" width=\"201px\"\u003e\u003c/a\u003e\n\nThis project is now sponsored by DigitalOcean, providing us with a dedicated development and testing environment.\n\nFor cloud VPS hosting with $200 in free credit, consider using my DigitalOcean referral link: https://m.do.co/c/1fdd0a1d695a\n\n## Support Tor Project\n\nSupport the Tor project by [setting up Tor bridge/exit nodes](https://trac.torproject.org/projects/tor/wiki/TorRelayGuide) and [donating](https://donate.torproject.org/).\n","funding_links":["https://github.com/sponsors/PeterDaveHello","https://opencollective.com/peterdavehello","https://ko-fi.com/peterdavehello","https://liberapay.com/PeterDaveHello","https://issuehunt.io/r/peterdavehello"],"categories":["Dockerfile"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPeterDaveHello%2Ftor-socks-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPeterDaveHello%2Ftor-socks-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPeterDaveHello%2Ftor-socks-proxy/lists"}