Registry for Hydra service discovery
Last updated 2 years ago by moraesmax .
MIT · Original npm · Tarball · package.json
$ cnpm install @frmnt/hydra-server 
SYNC missed versions from official npm registry.

Hydra Server

The Hydra Server is a core service for registering and looking up services by name. Every new Service sends a registry entry (describing its name, hostname, port, protocol), which a Client can then look up to create a Connection.


A single Hydra Server should be running on each machine using Hydra. By default the Hydra Server binds to, and by default every Service and Client will connect to the same.

$ hydra-server
[Hydra Server] Bound to

Keep it running in the background with your process manager of choice, e.g. pm2:

$ pm2 start hydra-server


Using the --host, --port, and --proto flags you can change where the Hydra Server binds:

$ hydra-server --port 48822
[Hydra Server] Bound to


A Hydra Server can "join" to another Hydra Server to share registered service information. Clients can then ask their local Hydra Server for remotely registered services.

$ hydra-server --join
[Hydra Server] Bound to
[Hydra Server] Joined with

Joining is more bandwidth-efficient and fault-tolerant than tunneling, as clients make direct connections to the remote services. However this only really works on trusted internal networks where machines are directly accessible via multiple ports (which services are bound to).


A Hydra Server can "tunnel" to another Hydra Server to share service info while also tunneling all messages through the same connection. A tunnel goes from a "local" machine to a "remote" machine

A tunnel uses a single local → remote connection, so Clients don't need access to every port a Service is on. The local machine only makes outbound connections, while the remote one needs to be accessible by the Hydra Server port.


Hydra Server depends on ZeroMQ:

$ sudo apt-get install libzmq-dev

Install the NPM module globally:

$ sudo npm install -g @frmnt/hydra-server

Current Tags

  • 0.0.1                                ...           latest (2 years ago)

1 Versions

  • 0.0.1                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (9)
Dev Dependencies (0)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |