Skip to content
An Advanced HTTP Reverse Proxy with Dynamic Sharding Strategies
Branch: master
Clone or download
gowtham-sai Adding init containers when etcd deployment is enabled
Weaver will stop watching for routes the very first time if etcd is not up

To handle this, will start weaver when etcd is up and healthy

docker start command is changed
Latest commit 9295547 Mar 20, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd/weaver-server Helm charts to deploy to kubenetes (#17) Feb 25, 2019
config Flatten the package structure Feb 1, 2019
docs add weaver logo Feb 18, 2019
examples/body_lookup Fix weaver deployment chart Mar 19, 2019
pkg fixes #12, reduce the number of keys to run tests faster Feb 9, 2019
server change name of the notfound handler Feb 8, 2019
.travis.yml Login to docker if only docker password is set in CI Feb 23, 2019
Dockerfile Adding init containers when etcd deployment is enabled Mar 20, 2019
LICENSE Initial commit Jan 27, 2019
Makefile Fix spell of Kubernetes Mar 12, 2019
acl.go Move acl to weaver package Feb 1, 2019
backend.go Flatten the package structure Feb 1, 2019
backend_test.go Flatten the package structure Feb 1, 2019
docker-compose.yml Speed up docker builds for development Mar 18, 2019
endpoint.go De-couple shard and weaver packages Feb 1, 2019
endpoint_test.go De-couple shard and weaver packages Feb 1, 2019
goreleaser.yml Goreleaser integration for weaver (#11) Feb 4, 2019
sharder.go De-couple shard and weaver packages Feb 1, 2019

Weaver - A modern HTTP Proxy with Advanced features

Build Status Go Report Card Coverage Status GitHub Release


Weaver is a Layer-7 Load Balancer with Dynamic Sharding Strategies. It is a modern HTTP reverse proxy with advanced features.


  • Sharding request based on headers/path/body fields
  • Emits Metrics on requests per route per backend
  • Dynamic configuring of different routes (No restarts!)
  • Is Fast
  • Supports multiple algorithms for sharding requests (consistent hashing, modulo, s2 etc)
  • Packaged as a single self contained binary
  • Logs on failures (Observability)


Build from source

  • Clone the repo:
git clone
  • Build to create weaver binary
make build

Binaries for various architectures

Download the binary for a release from: here


Weaver uses etcd as a control plane to match the incoming requests against a particular route config and shard the traffic to different backends based on some sharding strategy.

Weaver can be configured for different routes matching different paths with various sharding strategies through a simple route config named ACL.

The various sharding strategies supported by weaver are:

  • Consistent hashing (hashring)
  • Simple lookup based
  • Modulo
  • Prefix lookup
  • S2 based

Deploying to Kubernetes

Currently we support deploying to kubernetes officially. You can check the doc here


We have examples defined to deploy it to kubernetes and using acls. Please checkout out examples


Defining ACL's

Details on configuring weaver can be found here

Please note

As the famous saying goes, All Load balancers are proxies, but not every proxy is a load balancer, weaver currently does not support load balancing.


If you'd like to contribute to the project, refer to the contributing documentation


Copyright 2018, GO-JEK Tech (

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.