https://github.com/mqliang/libipvs
Pure Go lib to work with IPVS using generic netlink socket
https://github.com/mqliang/libipvs
golang ipvs netlink
Last synced: 3 months ago
JSON representation
Pure Go lib to work with IPVS using generic netlink socket
- Host: GitHub
- URL: https://github.com/mqliang/libipvs
- Owner: mqliang
- License: apache-2.0
- Created: 2016-12-16T02:12:56.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2023-01-09T03:52:26.000Z (over 2 years ago)
- Last Synced: 2025-04-05T19:04:26.962Z (6 months ago)
- Topics: golang, ipvs, netlink
- Language: Go
- Homepage:
- Size: 42 KB
- Stars: 46
- Watchers: 4
- Forks: 14
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# libipvs: Pure Go lib to work with IPVS
This project provides a pure Go client to communicate with IPVS kernel module using generic netlink socket. Netlink socket are used to communicate with various kernel subsystems as an RPC system.
[](https://goreportcard.com/report/github.com/mqliang/libipvs)
[](https://godoc.org/github.com/mqliang/libipvs)
## Requirements
* Linux platform
## API
```Golang
type IPVSHandle interface {
Flush() error
GetInfo() (info Info, err error)
ListServices() (services []*Service, err error)
NewService(s *Service) error
UpdateService(s *Service) error
DelService(s *Service) error
ListDestinations(s *Service) (dsts []*Destination, err error)
NewDestination(s *Service, d *Destination) error
UpdateDestination(s *Service, d *Destination) error
DelDestination(s *Service, d *Destination) error
}
```
## TODO
* IPVS state synchronization: support configuring the in-kernel IPVS sync daemon for supporting failover
between IPVS routers, as done with keepalived `lvs_sync_daemon_interface`
## Acknowledgments
* The code is first “borrowed” from https://github.com/qmsk/clusterf, so all kudos goes @SpComb. I moved the code out into this dedicated project, with a better API, proper tests and concurrency safety, so everyone would benefit from having a good and well-tested package.
## Alternatives
Other pure go implementation of IPVS that maybe useful:
* https://github.com/tehnerd/gnl2go
* https://github.com/moby/ipvs
## Example code
```Golang
package main
import (
"fmt"
"net"
"syscall"
"github.com/mqliang/libipvs"
)
func main() {
h, err := libipvs.New()
if err != nil {
panic(err)
}
if err := h.Flush(); err != nil {
panic(err)
}
info, err := h.GetInfo()
if err != nil {
panic(err)
}
fmt.Printf("%#v\n", info)
svcs, err := h.ListServices()
if err != nil {
panic(err)
}
fmt.Printf("%#v\n", svcs)
svc := libipvs.Service{
Address: net.ParseIP("172.192.168.1"),
AddressFamily: syscall.AF_INET,
Protocol: libipvs.Protocol(syscall.IPPROTO_TCP),
Port: 80,
SchedName: libipvs.RoundRobin,
}
if err := h.NewService(&svc); err != nil {
panic(err)
}
svcs, err = h.ListServices()
if err != nil {
panic(err)
}
fmt.Printf("%#v\n", svcs)
dst := libipvs.Destination{
Address: net.ParseIP("172.192.100.1"),
AddressFamily: syscall.AF_INET,
Port: 80,
}
if err := h.NewDestination(&svc, &dst); err != nil {
panic(err)
}
dsts, err := h.ListDestinations(&svc)
if err != nil {
panic(err)
}
fmt.Printf("%#v\n", dsts)
}
```