# weibocom/nginx-upsync-module

For http protocol. nginx-upsync-module, sync upstreams from consul or etcd and so on, dynamiclly modify backend-servers attributes(weight, max_fails, down...), needn't reload nginx

Repository: https://github.com/weibocom/nginx-upsync-module
Canonical: https://ross.abutalabs.com/products/nginx-upsync-module
Language: C
License Family: other
Last push: 2023-04-07T11:45:25+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4003, "days_push": 1244, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1846, forks 390 (observed 2026-08-28T04:05:43.489507+00:00)

## What it is
An Nginx C module that dynamically syncs upstream server lists from Consul or etcd, allowing live modification of backend server attributes like weight and max_fails without reloading Nginx. It avoids the performance cost of restarting Nginx under high load.

## Use cases
- dynamically update nginx upstream servers without reload
- sync backend server list from consul to nginx
- scale nginx backends up and down without restarting
- modify nginx upstream weights at runtime
- avoid nginx reload under high traffic
- service discovery for nginx load balancing

## When to choose
- you need zero-downtime upstream changes in nginx
- your infrastructure uses consul or etcd for service discovery
- reloading nginx under load causes performance degradation

## When to avoid
- you use a TCP/stream (L4) proxy instead of HTTP - use nginx-stream-upsync-module
- you prefer a control-plane like OpenResty or an API gateway for dynamic routing
- you need a maintained module with an explicit license

## Facets
- artifact type: plugin
- maturity: maintenance
- function: configuration-management, middleware
- domain: web-development, microservices
- platform: -
- tags: nginx-module, consul, etcd, dynamic-upstream, service-discovery, c, load-balancing, devops, nginx, linux, web-server

## Member repositories
- weibocom/nginx-upsync-module (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:43.489507+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:17:53.642593+00:00, confidence not recorded.
  - readme: https://github.com/weibocom/nginx-upsync-module (fetched 2026-08-28T04:05:43.489507+00:00, sha 96fa10bd701d)
- Data as of 2026-08-30T08:39:29.467469+00:00.