{"id":13441363,"url":"https://github.com/serjs/socks5-server","last_synced_at":"2025-03-20T11:38:31.574Z","repository":{"id":37887240,"uuid":"76945507","full_name":"serjs/socks5-server","owner":"serjs","description":null,"archived":false,"fork":false,"pushed_at":"2024-07-26T23:02:10.000Z","size":2199,"stargazers_count":683,"open_issues_count":28,"forks_count":168,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-08-01T03:34:09.621Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/serjs.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"patreon":"serjs","ko_fi":"serjsj"}},"created_at":"2016-12-20T10:05:13.000Z","updated_at":"2024-07-31T07:28:28.000Z","dependencies_parsed_at":"2024-01-14T03:48:06.926Z","dependency_job_id":"d5f4ea42-9162-4271-8af7-b01df5c883b2","html_url":"https://github.com/serjs/socks5-server","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serjs%2Fsocks5-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serjs%2Fsocks5-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serjs%2Fsocks5-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serjs%2Fsocks5-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/serjs","download_url":"https://codeload.github.com/serjs/socks5-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221759960,"owners_count":16876324,"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":[],"created_at":"2024-07-31T03:01:33.134Z","updated_at":"2024-10-28T01:30:40.774Z","avatar_url":"https://github.com/serjs.png","language":"Go","funding_links":["https://patreon.com/serjs","https://ko-fi.com/serjsj"],"categories":["HarmonyOS","Go"],"sub_categories":["Windows Manager"],"readme":"# go-socks5-proxy\n\n![Latest tag from master branch](https://github.com/serjs/socks5-server/workflows/Latest%20tag%20from%20master%20branch/badge.svg)\n![Release tag](https://github.com/serjs/socks5-server/workflows/Release%20tag/badge.svg)\n\nSimple socks5 server using go-socks5 with authentication, allowed ips list and destination FQDNs filtering\n\n# Examples\n\n- Run docker container using default container port 1080 and expose it to world using host port 1080, with auth creds\n\n    ```docker run -d --name socks5 -p 1080:1080 -e PROXY_USER=\u003cPROXY_USER\u003e -e PROXY_PASSWORD=\u003cPROXY_PASSWORD\u003e  serjs/go-socks5-proxy```\n\n    - Leave `PROXY_USER` and `PROXY_PASSWORD` empty for skip authentication options while running socks5 server, see example below\n\n- Run docker container using specifit container port and expose it to host port 1090, without auth creds\n\n    ```docker run -d --name socks5 -p 1090:9090 -e PROXY_PORT=9090 serjs/go-socks5-proxy```\n\n# List of supported config parameters\n\n|ENV variable|Type|Default|Description|\n|------------|----|-------|-----------|\n|PROXY_USER|String|EMPTY|Set proxy user (also required existed PROXY_PASS)|\n|PROXY_PASSWORD|String|EMPTY|Set proxy password for auth, used with PROXY_USER|\n|PROXY_PORT|String|1080|Set listen port for application inside docker container|\n|ALLOWED_DEST_FQDN|String|EMPTY|Allowed destination address regular expression pattern. Default allows all.|\n|ALLOWED_IPS|String|Empty|Set allowed IP's that can connect to proxy, separator `,`|\n\n\n# Build your own image:\n`docker-compose -f docker-compose.build.yml up -d`\\\nJust don't forget to set parameters in the `.env` file.\n\n# Test running service\n\nAssuming that you are using container on 1080 host docker port\n\n## Without authentication\n\n```curl --socks5 \u003cdocker host ip\u003e:1080  https://ifcfg.co``` - result must show docker host ip (for bridged network)\n\nor\n\n```docker run --rm curlimages/curl:7.65.3 -s --socks5 \u003cdocker host ip\u003e:1080 https://ifcfg.co```\n\n## With authentication\n\n```curl --socks5 \u003cdocker host ip\u003e:1080 -U \u003cPROXY_USER\u003e:\u003cPROXY_PASSWORD\u003e http://ifcfg.co```\n\nor\n\n```docker run --rm curlimages/curl:7.65.3 -s --socks5 \u003cPROXY_USER\u003e:\u003cPROXY_PASSWORD\u003e@\u003cdocker host ip\u003e:1080 http://ifcfg.co```\n\n# Authors\n\n* **Sergey Bogayrets**\n\nSee also the list of [contributors](https://github.com/serjs/socks5-server/graphs/contributors) who participated in this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserjs%2Fsocks5-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserjs%2Fsocks5-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserjs%2Fsocks5-server/lists"}