{"id":20467491,"url":"https://github.com/hackerl/ssocks","last_synced_at":"2025-08-19T23:07:03.567Z","repository":{"id":178566164,"uuid":"662026246","full_name":"Hackerl/sSocks","owner":"Hackerl","description":"A tiny socks5 VPN","archived":false,"fork":false,"pushed_at":"2024-08-01T10:56:29.000Z","size":70,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-13T09:12:05.357Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hackerl.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,"zenodo":null}},"created_at":"2023-07-04T07:44:57.000Z","updated_at":"2025-01-02T02:06:16.000Z","dependencies_parsed_at":"2024-08-03T13:47:01.891Z","dependency_job_id":null,"html_url":"https://github.com/Hackerl/sSocks","commit_stats":null,"previous_names":["hackerl/ssocks"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Hackerl/sSocks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hackerl%2FsSocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hackerl%2FsSocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hackerl%2FsSocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hackerl%2FsSocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hackerl","download_url":"https://codeload.github.com/Hackerl/sSocks/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hackerl%2FsSocks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271236280,"owners_count":24723978,"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","status":"online","status_checked_at":"2025-08-19T02:00:09.176Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-11-15T13:28:49.485Z","updated_at":"2025-08-19T23:07:03.542Z","avatar_url":"https://github.com/Hackerl.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 --\u003e\n\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\u003c!--\n*** Thanks for checking out the Best-README-Template. If you have a suggestion\n*** that would make this better, please fork the repo and create a pull request\n*** or simply open an issue with the tag \"enhancement\".\n*** Don't forget to give the project a star!\n*** Thanks again! Now go create something AMAZING! :D\n--\u003e\n\n\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![Apache 2.0 License][license-shield]][license-url]\n\n\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n\n\u003ch3 align=\"center\"\u003esSocks\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    A tiny socks5 VPN\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/Hackerl/sSocks/wiki\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/Hackerl/sSocks/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/Hackerl/sSocks/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#build\"\u003eBuild\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nA tiny socks5 VPN based on TLS mutual authentication.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n### Built With\n\n* [![CMake][CMake]][CMake-url]\n* [![vcpkg][vcpkg]][vcpkg-url]\n* [![C++17][C++17]][C++17-url]\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nBoth the server and the client need their own private keys and certificates when deployed.\n\n### Prerequisites\n\nCreate openssl 509 extended configuration, then generate all keys and certificates needed.\n\n* ext.cnf\n  ```conf\n  [req]\n  distinguished_name = req_distinguished_name\n  req_extensions = v3_req\n  \n  [req_distinguished_name]\n  \n  [v3_req]\n  subjectAltName = @alt_names\n  \n  [alt_names]\n  IP.1 = YOUR_SERVER_IP.1\n  IP.2 = YOUR_SERVER_IP.2\n  ```\n\n* private keys and certificates\n  ```sh\n  openssl genrsa -out cakey.pem 2048\n  openssl req -new -key cakey.pem -out ca.csr -subj \"/C=CN/ST=province/L=city/O=organization/OU=group/CN=CA\"\n  openssl x509 -req -days 365 -sha256 -extensions v3_ca -signkey cakey.pem -in ca.csr -out  cacert.pem\n  openssl genrsa -out server-key.pem 2048\n  openssl req -new -key server-key.pem -out server.csr -subj \"/C=CN/ST=province/L=city/O=organization/OU=group/CN=server\"\n  openssl x509 -req -days 365 -sha256 -extensions v3_req -extfile ext.cnf -CA cacert.pem -CAkey cakey.pem -CAserial ca.srl -CAcreateserial -in server.csr -out server-cert.pem\n  openssl verify -CAfile cacert.pem server-cert.pem\n  openssl genrsa  -out client-key.pem 2048\n  openssl req -new -key client-key.pem -out client.csr -subj \"/C=CN/ST=province/L=city/O=organization/OU=group/CN=client\"\n  openssl x509 -req -days 365 -sha256 -extensions v3_req -CA  cacert.pem -CAkey cakey.pem  -CAserial ca.srl -in client.csr -out client-cert.pem\n  ```\n\nExport environment variables:\n* VCPKG_INSTALLATION_ROOT\n* ANDROID_NDK_HOME(Android)\n\n### Build\n\n* Linux\n  ```sh\n  mkdir -p build \u0026\u0026 cmake -B build -DCMAKE_TOOLCHAIN_FILE=\"${VCPKG_INSTALLATION_ROOT}/scripts/buildsystems/vcpkg.cmake\" \u0026\u0026 cmake --build build -j$(nproc)\n  ```\n\n* Android\n  ```sh\n  # set \"ANDROID_PLATFORM\" for dependencies installed by vcpkg: echo 'set(VCPKG_CMAKE_SYSTEM_VERSION 24)' \u003e\u003e \"${VCPKG_INSTALLATION_ROOT}/triplets/community/arm64-android.cmake\"\n  mkdir -p build \u0026\u0026 cmake -B build -DCMAKE_TOOLCHAIN_FILE=\"${VCPKG_INSTALLATION_ROOT}/scripts/buildsystems/vcpkg.cmake\" -DVCPKG_CHAINLOAD_TOOLCHAIN_FILE=\"${ANDROID_NDK_HOME}/build/cmake/android.toolchain.cmake\" -DVCPKG_TARGET_TRIPLET=arm64-android -DANDROID_ABI=arm64-v8a -DANDROID_PLATFORM=android-24 \u0026\u0026 cmake --build build -j$(nproc)\n  ```\n\n* Windows(Developer PowerShell)\n  ```sh\n  mkdir -p build \u0026\u0026 cmake -B build -G Ninja -DCMAKE_TOOLCHAIN_FILE=\"$env:VCPKG_INSTALLATION_ROOT/scripts/buildsystems/vcpkg.cmake\" \u0026\u0026 cmake --build build -j $env:NUMBER_OF_PROCESSORS\n  ```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage\n\n* Server\n  ```sh\n  ./server 0.0.0.0 443 cacert.pem server-cert.pem server-key.pem\n  ```\n\n* Client\n\n  ```sh\n  ./client server-ip 443 cacert.pem client-cert.pem client-key.pem\n  ```\n\n* Proxy\n\n  ```sh\n  curl -x socks5://127.0.0.1:1080 https://www.google.com -vv\n  ```\n\n_For more examples, please refer to the [Documentation](https://github.com/Hackerl/sSocks/wiki)_\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- ROADMAP --\u003e\n## Roadmap\n\nSee the [open issues](https://github.com/Hackerl/sSocks/issues) for a full list of proposed features (and known issues).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the Apache 2.0 License. See `LICENSE` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nHackerl - [@Hackerl](https://github.com/Hackerl) - patteliu@gmail.com\n\nProject Link: [https://github.com/Hackerl/sSocks](https://github.com/Hackerl/sSocks)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n## Acknowledgments\n\n* [aio](https://github.com/hackerl/aio)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/Hackerl/sSocks.svg?style=for-the-badge\n[contributors-url]: https://github.com/Hackerl/sSocks/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/Hackerl/sSocks.svg?style=for-the-badge\n[forks-url]: https://github.com/Hackerl/sSocks/network/members\n[stars-shield]: https://img.shields.io/github/stars/Hackerl/sSocks.svg?style=for-the-badge\n[stars-url]: https://github.com/Hackerl/sSocks/stargazers\n[issues-shield]: https://img.shields.io/github/issues/Hackerl/sSocks.svg?style=for-the-badge\n[issues-url]: https://github.com/Hackerl/sSocks/issues\n[license-shield]: https://img.shields.io/github/license/Hackerl/sSocks.svg?style=for-the-badge\n[license-url]: https://github.com/Hackerl/sSocks/blob/master/LICENSE\n[CMake]: https://img.shields.io/badge/CMake-000000?style=for-the-badge\u0026logo=cmake\u0026logoColor=FF3E00\n[CMake-url]: https://cmake.org\n[vcpkg]: https://img.shields.io/badge/vcpkg-000000?style=for-the-badge\u0026logo=microsoft\u0026logoColor=61DAFB\n[vcpkg-url]: https://vcpkg.io\n[C++17]: https://img.shields.io/badge/C++17-000000?style=for-the-badge\u0026logo=cplusplus\u0026logoColor=4FC08D\n[C++17-url]: https://en.cppreference.com/w/cpp/17","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackerl%2Fssocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackerl%2Fssocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackerl%2Fssocks/lists"}