{"id":27063434,"url":"https://github.com/fagongzi/gateway","last_synced_at":"2025-04-05T16:01:44.550Z","repository":{"id":37404014,"uuid":"57028434","full_name":"fagongzi/manba","owner":"fagongzi","description":"HTTP API Gateway","archived":false,"fork":false,"pushed_at":"2023-07-12T07:59:34.000Z","size":36107,"stargazers_count":3299,"open_issues_count":21,"forks_count":758,"subscribers_count":184,"default_branch":"master","last_synced_at":"2024-10-29T15:29:33.343Z","etag":null,"topics":["api","api-gateway","backend-apis","circuit-breaker","etcd","gateway","go","golang","microservice","proxy","traffic-control"],"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/fagongzi.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":"2016-04-25T09:17:37.000Z","updated_at":"2024-10-25T15:47:26.000Z","dependencies_parsed_at":"2022-07-08T17:47:48.751Z","dependency_job_id":"e617c703-4c37-4449-a5a5-a80c61eeb2be","html_url":"https://github.com/fagongzi/manba","commit_stats":{"total_commits":462,"total_committers":27,"mean_commits":17.11111111111111,"dds":"0.24675324675324672","last_synced_commit":"2b39aeed1c7805e5b8e5ae8e5a0b482f539141e0"},"previous_names":["fagongzi/gateway"],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fagongzi%2Fmanba","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fagongzi%2Fmanba/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fagongzi%2Fmanba/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fagongzi%2Fmanba/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fagongzi","download_url":"https://codeload.github.com/fagongzi/manba/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247361594,"owners_count":20926641,"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":["api","api-gateway","backend-apis","circuit-breaker","etcd","gateway","go","golang","microservice","proxy","traffic-control"],"created_at":"2025-04-05T16:01:19.500Z","updated_at":"2025-04-05T16:01:44.524Z","avatar_url":"https://github.com/fagongzi.png","language":"Go","funding_links":[],"categories":["proxy"],"sub_categories":[],"readme":"\u003cimg src=\"./images/logo.png\" height=80\u003e\u003c/img\u003e\n\n[![Gitter](https://badges.gitter.im/fagongzi/gateway.svg)](https://gitter.im/fagongzi/gateway?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge)\n[![Build Status](https://api.travis-ci.org/fagongzi/gateway.svg)](https://travis-ci.org/fagongzi/gateway)\n[![Go Report Card](https://goreportcard.com/badge/github.com/fagongzi/gateway)](https://goreportcard.com/report/github.com/fagongzi/gateway)\n\nManba/[简体中文](README_CN.md)\n-------\nManba is a restful API gateway based on HTTP, which can be used as a unified API access layer.\n\n## Tutorial\nA very detailed tutorial for beginners. [Link](./docs/tutorial.md)\nBelow are video tutorials.\nBasics:\n[![](https://img.youtube.com/vi/2qMWmdcw7o4/0.jpg)](https://www.youtube.com/watch?v=2qMWmdcw7o4)\n\nAlternative bilibili.com video link: https://www.bilibili.com/video/av73432556/\n\nRouting Configuration Tutorial:\n[![](https://img.youtube.com/vi/D1pI6opB_ks/0.jpg)](https://www.youtube.com/watch?v=D1pI6opB_ks)\n\nAlternative bilibili.com video link: https://www.bilibili.com/video/av73432836/\n\nJWT Plugin Configuration Tutorial:\n[![](https://img.youtube.com/vi/sLb16YDSlBs/0.jpg)](https://www.youtube.com/watch?v=sLb16YDSlBs)\n\nAlternative bilibili.com video link: https://www.bilibili.com/video/av73433002/\n\n## Attention\nPlease make sure your Go version is 1.10 or above. Otherwise, **undefined \"math/rand\".Shuffle** error will occur when compiling. [StackOverFlow Link](https://stackoverflow.com/questions/52172794/getting-undefined-rand-shuffle-in-golang)\n\n\n## Features\n* Traffic Control (on Server or API)\n* Circuit Breaker (on Server or API)\n* Load Balance\n* Service Discovery\n* Plugin\n* Routing (Divert Traffic, Duplicate Traffic)\n* API Aggregation\n* API Argument Check\n* API Access Control (White and Black List)\n* API Default Return Value\n* API Customized Return Value\n* API Result Cache\n* JWT Authorization\n* API Metric Imports Prometheus\n* API Retry After Failure\n* Backend Server Health Check\n* Open Management of API (GRPC、Restful)\n* Websocket Support\n* Online Data Migration Support\n\n## Docker\n\nThe following content requires reader some knowledge of Docker. You can refer to [this book][2], or check out [the official documentation][1]。\n\n### Available Docker Images\n* `fagongzi/proxy`\n\n   proxy component, `production ready`\n\n* `fagongzi/apiserver`\n\n   apiserver component, `production ready`\n\n### Quick start with docker-compose\n```bash\ndocker-compose up -d\n```\n\nUse `http://127.0.0.1:9093/ui/index.html` to access `apiserver`\n\nUse `http://127.0.0.1` to access to your API\n\n## Architecture\n![](./images/arch.png)\n\n## Web UI\nAvailable Manba Web UI Projects：\n* [Official](https://github.com/fagongzi/gateway-ui-vue)\n* [gateway_ui (v2.x ONLY)](https://github.com/archfish/gateway_ui)\n* [gateway_admin_ui](https://github.com/wilehos/gateway_admin_ui)\n\n## Components\nManba consists of `proxy` and `apiserver`.\n\n### Proxy\nProxy is a component which provides service to clients. Proxy is a stateless node. Multiple proxies can be deployed to handle huge traffic.\n[More](./docs/proxy.md).\n\n### ApiServer\nApiServer provides GRPC and Restful to manage metadata for users. ApiServer integrates  official Web UI.\n[More](./docs/apiserver.md).\n\n## Concepts of Manba\n### Server\nA server is a a real backend service.\n[More](./docs/server.md).\n\n### Cluster\nCluster consists of servers which provide the same service. A server is chosen to handle a specific request based on a load balance strategy.\n[More](./docs/cluster.md).\n\n### API\nAPI is a key concept of Manba. We can manage external APIs in Manba and their distribution rules, aggregation rules and URL matching rules.\n[More](./docs/api.md).\n\n### Routing\nRouting is a route strategy. Cookie, Querystring, Header and Path in HTTP Request dictate traffic distribution and traffic duplication to a specific cluster. Through this feature, AB test and online traffic divertion is achieved.\n[More](./docs/routing.md).\n\n## Getting Involved\n[More](./docs/build.md)\n\n## WeChat\n![](./images/qr.jpg)\n\n[1]: https://docs.docker.com/ \"Docker Documentation\"\n[2]: https://github.com/yeasy/docker_practice \"docker_practice\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffagongzi%2Fgateway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffagongzi%2Fgateway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffagongzi%2Fgateway/lists"}