{"id":13638988,"url":"https://github.com/kizzx2/docker-wireguard-socks-proxy","last_synced_at":"2026-01-22T09:14:44.682Z","repository":{"id":58043077,"uuid":"213676084","full_name":"kizzx2/docker-wireguard-socks-proxy","owner":"kizzx2","description":"Expose a WireGuard tunnel as a SOCKS5 proxy","archived":false,"fork":false,"pushed_at":"2019-10-08T15:17:01.000Z","size":2,"stargazers_count":153,"open_issues_count":7,"forks_count":38,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-09T09:38:00.256Z","etag":null,"topics":["docker","opsec","privacy","proxy","wireguard"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/kizzx2/wireguard-socks-proxy","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kizzx2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-08T15:04:16.000Z","updated_at":"2024-11-08T13:59:19.000Z","dependencies_parsed_at":"2022-08-28T09:50:09.866Z","dependency_job_id":null,"html_url":"https://github.com/kizzx2/docker-wireguard-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/kizzx2%2Fdocker-wireguard-socks-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kizzx2%2Fdocker-wireguard-socks-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kizzx2%2Fdocker-wireguard-socks-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kizzx2%2Fdocker-wireguard-socks-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kizzx2","download_url":"https://codeload.github.com/kizzx2/docker-wireguard-socks-proxy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249811168,"owners_count":21328752,"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","opsec","privacy","proxy","wireguard"],"created_at":"2024-08-02T01:00:56.389Z","updated_at":"2026-01-22T09:14:44.652Z","avatar_url":"https://github.com/kizzx2.png","language":"Dockerfile","funding_links":[],"categories":["Dockerfile","Projects"],"sub_categories":["User Interface"],"readme":"# docker-wireguard-socks-proxy\n\nExpose WireGuard as a SOCKS5 proxy in a Docker container.\n\n(For the same thing in OpenVPN, see [kizzx2/docker-openvpn-client-socks](https://github.com/kizzx2/docker-openvpn-client-socks))\n\n## Why?\n\nThis is arguably the easiest way to achieve \"app based\" routing. For example, you may only want certain applications to go through your WireGuard tunnel while the rest of your system should go through the default gateway. You can also achieve \"domain name based\" routing by using a [PAC file](https://developer.mozilla.org/en-US/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file) that most browsers support.\n\n## Usage\n\nPreferably, using `start` in this repository:\n```bash\nbash start.sh /directory/containing/your/wireguard/conf/file\n```\n\nAlternatively, you can use `docker run` directly if you want to customize things such as port mapping:\n\n```bash\ndocker run -it --rm --cap-add=NET_ADMIN \\\n    --name wireguard-socks-proxy \\\n    --volume /directory/containing/your/wireguard/conf/file/:/etc/wireguard/:ro \\\n    -p 1080:1080 \\\n    kizzx2/wireguard-socks-proxy\n```\n\nThen connect to SOCKS proxy through through `127.0.0.1:1080` (or `local.docker:1080` for Mac / docker-machine / etc.). For example:\n\n```bash\ncurl --proxy socks5h://127.0.0.1:1080 ipinfo.io\n```\n\n## HTTP Proxy\n\nYou can easily convert this to an HTTP proxy using [http-proxy-to-socks](https://github.com/oyyd/http-proxy-to-socks), e.g.\n\n```bash\nhpts -s 127.0.0.1:1080 -p 8080\n```\n\n## Troubleshooting\n\n### I get \"Permission Denied\"\n\nThis can happen if your WireGuard configuration file includes an IPv6 address but your host interface does not work with it. Try removing the IPv6 address in `Address` from your configuration file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkizzx2%2Fdocker-wireguard-socks-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkizzx2%2Fdocker-wireguard-socks-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkizzx2%2Fdocker-wireguard-socks-proxy/lists"}