
Промышленный C++ RPC-фреймворк для создания высокопроизводительных распределённых систем, поддерживающий несколько протоколов (HTTP, gRPC, Redis, Thrift) со встроенной балансировкой нагрузки, службами имён и консенсусом RAFT.
[中文版](https://github.com/apache/brpc/blob/master/README_cn.md)
[](https://github.com/apache/brpc/actions/workflows/ci-linux.yml)
[](https://github.com/apache/brpc/actions/workflows/ci-macos.yml)


[bRPC](https://brpc.apache.org/) — это промышленный RPC-фреймворк на языке C++, который часто используется в высокопроизводительных системах, таких как поиск, хранение, машинное обучение, реклама, рекомендации и т. д.
### «bRPC» означает «better RPC» (лучший RPC).
Вы можете использовать его для:
* Создания сервера, который может общаться по множеству протоколов (**на одном порту**), или для доступа ко всевозможным сервисам:
* restful http/https, [h2](https://httpwg.org/specs/rfc9113.html)/[gRPC](https://grpc.io). Использование http/h2 в bRPC гораздо удобнее, чем [libcurl](https://curl.haxx.se/libcurl/). Доступ к протоколам на основе protobuf через HTTP/h2+json, вероятно, из другого языка.
* [redis](https://github.com/apache/brpc/blob/master/docs/en/redis_client.md) и [memcached](https://github.com/apache/brpc/blob/master/docs/en/memcache_client.md), потокобезопасные, более удобные и производительные, чем официальные клиенты.
* [rtmp](https://github.com/apache/brpc/blob/master/src/brpc/rtmp.h)/[flv](https://en.wikipedia.org/wiki/Flash_Video)/[hls](https://en.wikipedia.org/wiki/HTTP_Live_Streaming) для создания [потоковых сервисов](https://github.com/brpc/media-server).
* hadoop_rpc (возможно, будет открыт).
* поддержка [rdma](https://en.wikipedia.org/wiki/Remote_direct_memory_access).
* поддержка [thrift](https://github.com/apache/brpc/blob/master/docs/en/thrift.md), потокобезопасная, более удобная и производительная, чем официальные клиенты.
* всевозможные протоколы, используемые в Baidu: [baidu_std](https://github.com/apache/brpc/blob/master/docs/en/baidu_std.md), [streaming_rpc](https://github.com/apache/brpc/blob/master/docs/en/streaming_rpc.md), hulu_pbrpc, [sofa_pbrpc](https://github.com/baidu/sofa-pbrpc), nova_pbrpc, public_pbrpc, ubrpc и протоколы на основе nshead.
* Создание распределённых сервисов с [HA](https://en.wikipedia.org/wiki/High_availability) с использованием промышленной реализации [алгоритма консенсуса RAFT](https://raft.github.io), открытый исходный код которой доступен в [braft](https://github.com/brpc/braft).
* Серверы могут обрабатывать запросы [синхронно](https://github.com/apache/brpc/blob/master/docs/en/server.md) или [асинхронно](https://github.com/apache/brpc/blob/master/docs/en/server.md#asynchronous-service).
* Клиенты могут обращаться к серверам [синхронно](https://github.com/apache/brpc/blob/master/docs/en/client.md#synchronus-call), [асинхронно](https://github.com/apache/brpc/blob/master/docs/en/client.md#asynchronous-call), [полусинхронно](https://github.com/apache/brpc/blob/master/docs/en/client.md#semi-synchronous-call) или использовать [combo channels](https://github.com/apache/brpc/blob/master/docs/en/combo_channel.md) для декларативного упрощения шардированного или параллельного доступа.
* Отладки сервисов [через http](https://github.com/apache/brpc/blob/master/docs/en/builtin_service.md) и запуска профилировщиков [cpu](https://github.com/apache/brpc/blob/master/docs/en/cpu_profiler.md), [heap](https://github.com/apache/brpc/blob/master/docs/en/heap_profiler.md) и [contention](https://github.com/apache/brpc/blob/master/docs/en/contention_profiler.md).
* Получения [лучшей задержки и пропускной способности](https://github.com/apache/brpc/blob/master/docs/en/overview.md#better-latency-and-throughput).
* [Расширения bRPC](https://github.com/apache/brpc/blob/master/docs/en/new_protocol.md) протоколами, используемыми в вашей организации, быстро, или настройки компонентов, включая [сервисы именования](https://github.com/apache/brpc/blob/master/docs/en/load_balancing.md) (dns, zk, etcd), [балансировщики нагрузки](https://github.com/apache/brpc/blob/master/docs/en/load_balancing.md) (rr, random, consistent hashing).
# Попробуйте!
* Прочитайте [обзор](https://github.com/apache/brpc/blob/master/docs/en/overview.md), чтобы узнать, где можно использовать bRPC и в чём его преимущества.
* Прочитайте [руководство по началу работы](https://github.com/apache/brpc/blob/master/docs/en/getting_started.md) для получения инструкций по сборке и поработайте с [примерами](https://github.com/apache/brpc/tree/master/example/).
* Документация:
* [Включение FlatBuffers RPC и проверка примера](https://github.com/apache/brpc/blob/master/docs/en/flatbuffers.md)
* [Сравнительный анализ производительности](https://github.com/apache/brpc/blob/master/docs/en/benchmark.md)
* [bvar](https://github.com/apache/brpc/blob/master/docs/en/bvar.md)
* [bvar_c++](https://github.com/apache/brpc/blob/master/docs/en/bvar_c%2B%2B.md)
* [bthread](https://github.com/apache/brpc/blob/master/docs/en/bthread.md)
* [bthread или нет](https://github.com/apache/brpc/blob/master/docs/en/bthread_or_not.md)
* [thread-local](https://github.com/apache/brpc/blob/master/docs/en/thread_local.md)
* [Очередь выполнения](https://github.com/apache/brpc/blob/master/docs/en/execution_queue.md)
* [Трассировщик bthread](https://github.com/apache/brpc/blob/master/docs/en/bthread_tracer.md)
* [Группа задач с тегами bthread](https://github.com/apache/brpc/blob/master/docs/en/bthread_tagged_task_group.md)
* Клиент
* [Основы](https://github.com/apache/brpc/blob/master/docs/en/client.md)
* [Код ошибки](https://github.com/apache/brpc/blob/master/docs/en/error_code.md)
* [Комбинированные каналы](https://github.com/apache/brpc/blob/master/docs/en/combo_channel.md)
* [Доступ к http/h2](https://github.com/apache/brpc/blob/master/docs/en/http_client.md)
* [Доступ к gRPC](https://github.com/apache/brpc/blob/master/docs/en/http_derivatives.md#h2grpc)
* [Доступ к thrift](https://github.com/apache/brpc/blob/master/docs/en/thrift.md#client-accesses-thrift-server)
* [Доступ к UB](https://github.com/apache/brpc/blob/master/docs/en/ub_client.md)
* [Потоковый RPC](https://github.com/apache/brpc/blob/master/docs/en/streaming_rpc.md)
* [Доступ к redis](https://github.com/apache/brpc/blob/master/docs/en/redis_client.md)
* [Доступ к memcached](https://github.com/apache/brpc/blob/master/docs/en/memcache_client.md)
* [Резервный запрос](https://github.com/apache/brpc/blob/master/docs/en/backup_request.md)
* [Фиктивный сервер](https://github.com/apache/brpc/blob/master/docs/en/dummy_server.md)
* Сервер
* [Основы](https://github.com/apache/brpc/blob/master/docs/en/server.md)
* [Обслуживание http/h2](https://github.com/apache/brpc/blob/master/docs/en/http_service.md)
* [Обслуживание gRPC](https://github.com/apache/brpc/blob/master/docs/en/http_derivatives.md#h2grpc)
* [Обслуживание thrift](https://github.com/apache/brpc/blob/master/docs/en/thrift.md#server-processes-thrift-requests)
* [Обслуживание Nshead](https://github.com/apache/brpc/blob/master/docs/en/nshead_service.md)
* [Отладка проблем сервера](https://github.com/apache/brpc/blob/master/docs/en/server_debugging.md)
* [Push с сервера](https://github.com/apache/brpc/blob/master/docs/en/server_push.md)
* [Лавина](https://github.com/apache/brpc/blob/master/docs/en/avalanche.md)
* [Автоматический ConcurrencyLimiter](https://github.com/apache/brpc/blob/master/docs/en/auto_concurrency_limiter.md)
* [Медиасервер](https://github.com/brpc/media-server)
* [json2pb](https://github.com/apache/brpc/blob/master/docs/en/json2pb.md)
* [Встроенные сервисы](https://github.com/apache/brpc/blob/master/docs/en/builtin_service.md)
* [status](https://github.com/apache/brpc/blob/master/docs/en/status.md)
* [vars](https://github.com/apache/brpc/blob/master/docs/en/vars.md)
* [connections](https://github.com/apache/brpc/blob/master/docs/en/connections.md)
* [flags](https://github.com/apache/brpc/blob/master/docs/en/flags.md)
* [rpcz](https://github.com/apache/brpc/blob/master/docs/en/rpcz.md)
* [cpu_profiler](https://github.com/apache/brpc/blob/master/docs/en/cpu_profiler.md)
* [heap_profiler](https://github.com/apache/brpc/blob/master/docs/en/heap_profiler.md)
* [contention_profiler](https://github.com/apache/brpc/blob/master/docs/en/contention_profiler.md)
* Инструменты
* [rpc_press](https://github.com/apache/brpc/blob/master/docs/en/rpc_press.md)
* [rpc_replay](https://github.com/apache/brpc/blob/master/docs/en/rpc_replay.md)
* [rpc_view](https://github.com/apache/brpc/blob/master/docs/en/rpc_view.md)
* [benchmark_http](https://github.com/apache/brpc/blob/master/docs/en/benchmark_http.md)
* [parallel_http](https://github.com/apache/brpc/blob/master/docs/en/parallel_http.md)
* Прочее
* [IOBuf](https://github.com/apache/brpc/blob/master/docs/en/iobuf.md)
* [Потоковый журнал](https://github.com/apache/brpc/blob/master/docs/en/streaming_log.md)
* [FlatMap](https://github.com/apache/brpc/blob/master/docs/en/flatmap.md)
* [Корутина](https://github.com/apache/brpc/blob/master/docs/en/coroutine.md)
* [Размыкатель цепи](https://github.com/apache/brpc/blob/master/docs/en/circuit_breaker.md)
* [UBRing](https://github.com/apache/brpc/blob/master/docs/en/ubring.md)
* [RDMA](https://github.com/apache/brpc/blob/master/docs/en/rdma.md)
* [Поддержка Bazel](https://github.com/apache/brpc/blob/master/docs/en/bazel_support.md)
* [Плагин-диссектор baidu_std для Wireshark](https://github.com/apache/brpc/blob/master/docs/en/wireshark_baidu_std.md)
* [Введение в bRPC](https://github.com/apache/brpc/blob/master/docs/cn/brpc_intro.pptx)(учебный материал)
* [Руководство по построению крупномасштабных сервисов](https://github.com/apache/brpc/blob/master/docs/en/tutorial_on_building_services.pptx)(учебный материал)
* [Внутреннее устройство bRPC](https://github.com/apache/brpc/blob/master/docs/en/brpc_internal.pptx)(учебный материал)
* RPC в деталях
* [Новый протокол](https://github.com/apache/brpc/blob/master/docs/en/new_protocol.md)
* [Атомарные инструкции](https://github.com/apache/brpc/blob/master/docs/en/atomic_instructions.md)
* [IO](https://github.com/apache/brpc/blob/master/docs/en/io.md)
* [Обзор потоков](https://github.com/apache/brpc/blob/master/docs/en/threading_overview.md)
* [Балансировка нагрузки](https://github.com/apache/brpc/blob/master/docs/en/load_balancing.md)
* [С учётом локальности](https://github.com/apache/brpc/blob/master/docs/en/lalb.md)
* [Согласованное хеширование](https://github.com/apache/brpc/blob/master/docs/en/consistent_hashing.md)
* [Управление памятью](https://github.com/apache/brpc/blob/master/docs/en/memory_management.md)
* [Работа с таймерами](https://github.com/apache/brpc/blob/master/docs/en/timer_keeping.md)
* [bthread_id](https://github.com/apache/brpc/blob/master/docs/en/bthread_id.md)
* Примеры использования
* [Примеры использования](https://github.com/apache/brpc/blob/master/community/cases.md)
# Участие в разработке
Пожалуйста, обратитесь [сюда](https://github.com/apache/brpc/blob/master/CONTRIBUTING.md).
# Обратная связь и участие в проекте
* Сообщайте об ошибках, задавайте вопросы или вносите предложения через [Github Issues](https://github.com/apache/brpc/issues).
* Подпишитесь на список рассылки ([email protected]), чтобы получать обновления о проекте.
# Кодекс поведения
Мы следуем кодексу поведения Apache Software Foundation, пожалуйста, ознакомьтесь с ним здесь [Ссылка](https://www.apache.org/foundation/policies/conduct).