{"id":18040485,"url":"https://github.com/jgaa/shinysocks","last_synced_at":"2025-04-04T19:07:36.640Z","repository":{"id":34314521,"uuid":"38232046","full_name":"jgaa/shinysocks","owner":"jgaa","description":"A small, ultrafast SOCKS proxy server.","archived":false,"fork":false,"pushed_at":"2025-02-24T07:50:38.000Z","size":109,"stargazers_count":176,"open_issues_count":2,"forks_count":24,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-03-28T18:09:21.179Z","etag":null,"topics":["socks-server"],"latest_commit_sha":null,"homepage":"","language":"C++","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/jgaa.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-06-29T06:46:19.000Z","updated_at":"2025-03-23T09:42:54.000Z","dependencies_parsed_at":"2024-03-07T17:56:45.907Z","dependency_job_id":"ab78cfcc-fca6-42fd-bba5-eed5ab40f70a","html_url":"https://github.com/jgaa/shinysocks","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/jgaa%2Fshinysocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgaa%2Fshinysocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgaa%2Fshinysocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgaa%2Fshinysocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jgaa","download_url":"https://codeload.github.com/jgaa/shinysocks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247234921,"owners_count":20905854,"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":["socks-server"],"created_at":"2024-10-30T15:02:59.584Z","updated_at":"2025-04-04T19:07:36.620Z","avatar_url":"https://github.com/jgaa.png","language":"C++","funding_links":[],"categories":["HarmonyOS","SOCKS5 Proxy Servers"],"sub_categories":["Windows Manager"],"readme":"# ShinySOCKS\n\n[![CI](https://github.com/jgaa/shinysocks/actions/workflows/ci.yaml/badge.svg?branch=master)](https://github.com/jgaa/shinysocks/actions/workflows/ci.yaml)\n[![macOS Universal](https://github.com/jgaa/shinysocks/actions/workflows/build_macos-universal.yaml/badge.svg)](https://github.com/jgaa/shinysocks/actions/workflows/build_macos-universal.yaml)\n\n## Mission Statement\n\n*To create a small, ultra-fast SOCKS proxy server that just works.*\n\n## Background\n\nI sometimes use VPN. In one case, I had VPN access only\nfrom a Windows 7 virtual machine trough some proprietary\n\"security by obscurity\", obscenely expensive enterprise\nVPN software. In order to work\nefficiently, I needed to connect my Linux workstation to that\nVPN. Network routing and IP forwarding seems not to work,\nso the second best option in my case is SOCKS. Socks\ntrough Putty works, kind of. It's slow and unreliable.\n\nI tried a few free SOCKS servers. Neither of them worked, so\ntherefore I'm spending a few hours writing my own.\n\n## Blog posts mentioning the project\n- [My blog](https://lastviking.eu/_tags/shinysocks.html)\n\n## Current State\nThe project has been in maintenance mode for ages. It just works.\nHowever, these days I'm fixing some build issues to make it \nsimpler for you or other hackers to submit pull requests with new features ;)\n\nI'm also in the process of updating the code from mostly C++11 to C++20. But\nit's not a very high priority - after all, the application work well as it is.\n\nThe SOCKS server works for SOCKS 4, 4a and 5 under\nLinux, Windows and MacOS.\n\nIPv6 and binding (reverse connections) are not yet supported.\n\n## How I use it\n\nI start ShinySOCKS on the command-line (cmd.exe) in a Windows or Linux\nVM with VPN. Then I ssh to whatever servers on the VPN network\nI desire - using ShinySOCKS as a proxy.\n\nFrom Linux:\n $ ssh -o ProxyCommand='nc -x 192.168.0.10:1080 %h %p' jgaa@cool-server\n\nFor accessing intranet web pages over the VPN, I some times\nused the [Foxy Proxy](https://getfoxyproxy.org/) Firefox plugin.\nIt simplifies things, and make my work-flow smooth. This also\nimproved my privacy, as the VPN host will only see the web traffic\ngoing to the intranet sites.\n\n## How I test it\n\nIf it run locally, and I have curl installed, I can test it like this:\n```sh\ncurl -L --socks5-hostname socks5://localhost:1080 https://raw.githubusercontent.com/jgaa/shinysocks/master/ci/test.txt\n\n```\n\n## Docker\n\nYou can also pull a [Docker image](https://hub.docker.com/r/jgaafromnorth/shinysocks/)\nwith the server from Docker Hub.\n\n```sh\ndocker pull jgaafromnorth/shinysocks\n```\n\nTo run it.\n```sh\ndocker run --rm --name shiny -p 1080:1080 -d jgaafromnorth/shinysocks\n```\n\nTo  test it on the command-line with `curl`:\n```sh\n# Let curl do the DNS lookup\ncurl -L -x socks5://localhost:1080 https://www.google.com/\n\n# Let shinysocks do the DNS lookup\n\ncurl -L --socks5-hostname socks5://localhost:1080 https://www.google.com/\n```\n\nYou can now set the socks 5 address to ip `127.0.0.1` port `1080` in your applications (for example Firefox') proxy settings and test it.\n\n## Command line\n\nYou can download a zipfile with the binary and run in from the command line:\n\n**Linux**\n\nAfter you have extracted the zip archive:\n\n```sh\nchmod +x shinysocks\n\n./shinysocks -l debug -c \"\"\n\n```\n\n**Windows**\n\n```sh\n\nshinysocks -l debug -c \"\"\n\n```\n\n**MacOS**\n\n```sh\n\nchmod +x shinysocks\n\n./shinysocks -l debug -c \"\"\n\n```\n\nTo **disable logging**, set the log level to `none`.\n\n## Supported platforms\n- Linux\n- Windows\n- MacOS\n\n## License\nShinySOCKS is released under GPLv3.\n\nIt is Free. Free as in free speech - at least in imaginary countries, where free speech is still allowed ;)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgaa%2Fshinysocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjgaa%2Fshinysocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgaa%2Fshinysocks/lists"}