{"id":13753479,"url":"https://github.com/rpcxio/rpcx-gateway","last_synced_at":"2026-02-03T09:10:40.774Z","repository":{"id":38022471,"uuid":"112607312","full_name":"rpcxio/rpcx-gateway","owner":"rpcxio","description":"http gateway for rpcx services. Clients in any programming languages can call them","archived":false,"fork":false,"pushed_at":"2023-06-02T02:21:08.000Z","size":9160,"stargazers_count":204,"open_issues_count":3,"forks_count":40,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-05-09T21:34:52.065Z","etag":null,"topics":["cross-platform","gateway","microservice","microservices","rpc","rpcx","service-mesh","sidecar"],"latest_commit_sha":null,"homepage":"","language":"Go","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/rpcxio.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}},"created_at":"2017-11-30T12:11:09.000Z","updated_at":"2025-01-30T12:36:45.000Z","dependencies_parsed_at":"2023-07-13T09:55:58.176Z","dependency_job_id":null,"html_url":"https://github.com/rpcxio/rpcx-gateway","commit_stats":null,"previous_names":["rpcx-ecosystem/rpcx-gateway"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rpcxio/rpcx-gateway","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpcxio%2Frpcx-gateway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpcxio%2Frpcx-gateway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpcxio%2Frpcx-gateway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpcxio%2Frpcx-gateway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rpcxio","download_url":"https://codeload.github.com/rpcxio/rpcx-gateway/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpcxio%2Frpcx-gateway/sbom","scorecard":{"id":786177,"data":{"date":"2025-08-11","repo":{"name":"github.com/rpcxio/rpcx-gateway","commit":"74ed729109fdc7a8d456a367a0f42e7cfdcc6b02"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 2/21 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 11 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"13 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-rq8g-5pc5-wrhr","Warn: Project is vulnerable to: GHSA-qrmc-fj45-qfc2","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-44pw-h2cw-w3vq","Warn: Project is vulnerable to: GHSA-jp4x-w63m-7wgm","Warn: Project is vulnerable to: GHSA-c429-5p7v-vgjp","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-2m39-62fm-q8r3","Warn: Project is vulnerable to: GHSA-mf6x-7mm4-x2g7","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-23T06:09:51.214Z","repository_id":38022471,"created_at":"2025-08-23T06:09:51.214Z","updated_at":"2025-08-23T06:09:51.214Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29039342,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T08:41:49.363Z","status":"ssl_error","status_checked_at":"2026-02-03T08:40:19.255Z","response_time":96,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cross-platform","gateway","microservice","microservices","rpc","rpcx","service-mesh","sidecar"],"created_at":"2024-08-03T09:01:23.092Z","updated_at":"2026-02-03T09:10:40.750Z","avatar_url":"https://github.com/rpcxio.png","language":"Go","funding_links":[],"categories":["sidecar"],"sub_categories":[],"readme":"# rpcx-gateway\n[rpcx-gateway](https://github.com/rpcxio/rpcx-gateway) is a http gateway for [rpcx](https://github.com/smallnest/rpcx) services.\n\n[rpcx](https://github.com/smallnest/rpcx) is a fast rpc framework. Faster, more features.\n\nYou can write rpc http clients in any programming languages such as Java、Python、C#、Node.js、Php、C\\C++、Rust and others. See [examples](https://github.com/rpcxio/rpcx-gateway/blob/master/examples/README.md)\n\n## Deployment models\n\nThere are two deployment modes: **Gateway** and **Agent**。\n\n### Gateway\n\n![](doc/gateway.png)\n\nYou can deploy this as gateway model. Gateway is running at independent servers. Clients sends http requests to gateways, and gateways translate http requests into raw rpcx requests. And then gateways send raw rpcx requests to rpcx services.\n\nwhen gateways receive rpcx responses, they translates rpcx responses into http responses and return clients.\n\nYou can scale gateway easily because it is stateless.\n\nIt works like a http load balancer.\n\n\n### Agent\n\n![](doc/agent.png)\n\n\nYou can also deploy this as agent model. Agents are deploy with clients. They are installed as a daemon application in node of clients. If there are multiple clients in one node, you only need to install one agent.\n\nClients send http requests to their local agent. The local agent translate http requests into rpcx requests, send rpcx requests to rpcx services, translate rpcx responses into http ressponses.\n\nIt works like service mesh.\n\n\n## Protocol\n\nYou can send a http request in any programming languages. You must set some extra http headers in requests.\n\n- X-RPCX-Version: rpcx version\n- X-RPCX-MesssageType: set 0 as request\n- X-RPCX-Heartbeat: is heartbeat request or not, false in default.\n- X-RPCX-Oneway: is one-way request or not, false in default.\n- X-RPCX-SerializeType: 0 as raw bytes, 1 as JSON, 2 as protobuf, 3 as msgpack\n- X-RPCX-MessageID: message ID, uint64 type\n- X-RPCX-ServicePath: service path\n- X-RPCX-ServiceMethod: service method\n- X-RPCX-Meta: extra metadata\n\nFor the http response, there are some extra http headers:\n\n- X-RPCX-Version: rpcx version\n- X-RPCX-MesssageType: 1 as response\n- X-RPCX-Heartbeat: is heartbeat response or not\n- X-RPCX-MessageStatusType:  Error or Normal. Error means there is call failure\n- X-RPCX-SerializeType: 0 as raw bytes, 1 as JSON, 2 as protobuf, 3 as msgpack\n- X-RPCX-MessageID: message ID, uint64 type\n- X-RPCX-ServicePath: service path\n- X-RPCX-ServiceMethod: service method\n- X-RPCX-Meta: extra metadata\n- X-RPCX-ErrorMessage: error message if X-RPCX-MessageStatusType is Error\n\n\n## Example\n\nThere is a golang http client example:\n\n```go\npackage main\n\nimport (\n\t\"bytes\"\n\t\"io/ioutil\"\n\t\"log\"\n\t\"net/http\"\n\n\t\"github.com/rpcxio/rpcx-gateway\"\n\n\t\"github.com/smallnest/rpcx/codec\"\n)\n\ntype Args struct {\n\tA int\n\tB int\n}\n\ntype Reply struct {\n\tC int\n}\n\nfunc main() {\n\tcc := \u0026codec.MsgpackCodec{}\n\n    // request \n\targs := \u0026Args{\n\t\tA: 10,\n\t\tB: 20,\n\t}\n\tdata, _ := cc.Encode(args)\n\n\treq, err := http.NewRequest(\"POST\", \"http://127.0.0.1:9981/\", bytes.NewReader(data))\n\tif err != nil {\n\t\tlog.Fatal(\"failed to create request: \", err)\n\t\treturn\n    }\n    \n    // set extra headers\n\th := req.Header\n\th.Set(gateway.XSerializeType, \"3\")\n\th.Set(gateway.XServicePath, \"Arith\")\n\th.Set(gateway.XServiceMethod, \"Mul\")\n\n    // send to gateway\n\tres, err := http.DefaultClient.Do(req)\n\tif err != nil {\n\t\tlog.Fatal(\"failed to call: \", err)\n\t}\n\tdefer res.Body.Close()\n\n\t// handle http response\n\treplyData, err := ioutil.ReadAll(res.Body)\n\tif err != nil {\n\t\tlog.Fatal(\"failed to read response: \", err)\n\t}\n\n    // parse reply\n\treply := \u0026Reply{}\n\terr = cc.Decode(replyData, reply)\n\tif err != nil {\n\t\tlog.Fatal(\"failed to decode reply: \", err)\n\t}\n\n\tlog.Printf(\"%d * %d = %d\", args.A, args.B, reply.C)\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frpcxio%2Frpcx-gateway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frpcxio%2Frpcx-gateway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frpcxio%2Frpcx-gateway/lists"}