{"id":13775944,"url":"https://github.com/bestoa/shadowsocks-vertx","last_synced_at":"2026-01-16T11:41:13.389Z","repository":{"id":79034298,"uuid":"54633837","full_name":"Bestoa/shadowsocks-vertx","owner":"Bestoa","description":"Java port of shadowsocks with vertx.","archived":false,"fork":false,"pushed_at":"2023-05-29T03:20:12.000Z","size":19494,"stargazers_count":27,"open_issues_count":4,"forks_count":23,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-03T17:12:21.988Z","etag":null,"topics":["bouncy-castle","java","java-8","shadowsocks","shadowsocks-java","vertx"],"latest_commit_sha":null,"homepage":"","language":"Java","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/Bestoa.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":"2016-03-24T10:29:52.000Z","updated_at":"2023-05-29T03:20:18.000Z","dependencies_parsed_at":"2024-01-07T22:48:07.486Z","dependency_job_id":"623b5264-f18e-4e28-942d-09064a1ca018","html_url":"https://github.com/Bestoa/shadowsocks-vertx","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bestoa%2Fshadowsocks-vertx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bestoa%2Fshadowsocks-vertx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bestoa%2Fshadowsocks-vertx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bestoa%2Fshadowsocks-vertx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bestoa","download_url":"https://codeload.github.com/Bestoa/shadowsocks-vertx/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225031383,"owners_count":17410057,"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":["bouncy-castle","java","java-8","shadowsocks","shadowsocks-java","vertx"],"created_at":"2024-08-03T17:01:55.384Z","updated_at":"2026-01-16T11:41:13.383Z","avatar_url":"https://github.com/Bestoa.png","language":"Java","funding_links":[],"categories":["\u003ca id=\"d03d494700077f6a65092985c06bf8e8\"\u003e\u003c/a\u003e工具"],"sub_categories":["\u003ca id=\"cb16466a31a167bb61f39e2a4a85f449\"\u003e\u003c/a\u003eShadowsocks"],"readme":"shadowsocks-vertx\n================\n\nDO NOT USE IT ANYMORE!!!\n========================\n\nOnly support SS-V1\n\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/213dc9a68343476a94f37dde6991353d)](https://app.codacy.com/gh/Bestoa/shadowsocks-vertx/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n[![codecov](https://codecov.io/gh/Bestoa/shadowsocks-vertx/branch/master/graph/badge.svg)](https://codecov.io/gh/Bestoa/shadowsocks-vertx)\n[![License](http://img.shields.io/:license-apache-blue.svg?style=flat-square)](http://www.apache.org/licenses/LICENSE-2.0.html)\n\n## Intro\n\nshadowsocks-vertx is a lightweight tunnel proxy which can help you get through firewalls. It is a java port of shadowsocks. This project is based on vert.x.\n\nThe protocol is compatible with the origin shadowsocks (if both have been upgraded to the latest version).\n\nJDK 8 is needed.\n\nCurrent version 0.8.4\n\nIt is **unstable**! If you encounter any problems, please open an issue.\n\nAbout shadowsocks, please refer to [shadowsocks](https://shadowsocks.org/)\n\nAbout vert.x, please refer to [vertx](http://vertx.io/)\n\n## Features\n\nSupported argument:\n\n    1. -m/--method crypto method\n    2. -k/--password password\n    3. -p/--server_port bind port(server)/remote port(client)\n    4. -a/--auth OTA enforcing mode\n    5. -l/--local_port local port\n    6. -s/--server server\n    7. -S/--server_mode server mode(default is client mode)\n    8. -c/--config config file\n    9. -t/--timeout timeout(unit is second, currently unused)\n    10. -h/--help show help.\n\nSupported encrypt method:\n\n    1. aes-128-cfb\n    2. aes-192-cfb\n    3. aes-256-cfb\n    4. chacha20/chacha20-ietf\n\nSupported one-time auth.\n\nSupport JSON config file. Please refer to [shadowsocks config](https://github.com/shadowsocks/shadowsocks/wiki/Configuration-via-Config-File).\nNote:\n\n    1. Not support: local_address, client will bind 0.0.0.0 not 127.0.0.1\n    2. Not support: fast_open. Java doesn't have such feature.\n    3. Not support: workers. Vertx will set work thread number automatically.\n    4. Additional: server_mode, set the running mode, true for the server.\n\nYou could refer to demo config etc/demo.json.\n\n### How to run\n\n#### (1) Before you start\nYou must have 'gradle' installed first, or use gradle wrapper ./gradlew.\n\n#### (2) generate distributable zip\n```shell\n$ gradle distZip\n```\nor\n```shell\n$ ./gradlew distZip\n```\n\nThen you will get shadowsocks-ver.zip in build/distributions.\nUnzip it, the folder should contain bin and lib.\n\n#### Run\n```shell\n//Server\n$ bin/shadowsocks -S ...\n$ bin/shadowsocks --server_mode ...\n//Local\n$ bin/shadowsocks ...\n```\n\n### (3) generate all-in-one jar\n```shell\n$ gradle fatJar\n```\nor\n```shell\n$ ./gradlew fatJar\n```\n\n\nThen you will get shadowsocks-fat-ver.jar in build/libs.\n\n#### How to run\n```shell\n//Server\n$ java -jar shadowsocks-fat-xx.jar -S ...\n$ java -jar shadowsocks-fat-xx.jar --server_mode ...\n//Local\n$ java -jar shadowsocks-fat-xx.jar ...\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbestoa%2Fshadowsocks-vertx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbestoa%2Fshadowsocks-vertx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbestoa%2Fshadowsocks-vertx/lists"}