https://github.com/chmduquesne/wg-ip

automatic ip addresses for wireguard peers
https://github.com/chmduquesne/wg-ip

Last synced: 3 months ago
JSON representation

automatic ip addresses for wireguard peers

• Host: GitHub
• URL: https://github.com/chmduquesne/wg-ip
• Owner: chmduquesne
• License: gpl-2.0
• Created: 2018-04-08T18:11:37.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-03-29T02:07:28.000Z (over 4 years ago)
• Last Synced: 2024-06-03T09:45:13.905Z (5 months ago)
• Language: Shell
• Homepage:
• Size: 104 KB
• Stars: 41
• Watchers: 5
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Build Status](https://travis-ci.org/chmduquesne/wg-ip.svg?branch=master)](https://travis-ci.org/chmduquesne/wg-ip)

wg-ip is a tool to assign ip addresses derived from the public keys to

wireguard interfaces.

How to

------

I personally just run `wg-ip apply dev wg0` after adding the peers and

bringing the interface up. In my automation scripts, I obtain the private

ip address of a given node by using `wg-ip gen `.

Portability

-----------

wg-ip is written to be portable across shells. It should run fine on

openwrt (if not, it's a bug).

Advanced usage

--------------

    Usage: wg-ip [-4|-6|--subnet ][--asnet ] [gen |[dev  ]apply|[dev  ]dryrun]

    Subnet used:

        -4

            sets the subnet to 10.0.0.0/8

        -6

            sets the subnet to fd1a:6126:2887::/48

        --subnet 

            sets an arbitrary (ipv4 or ipv6) subnet

    When the subnet is specified several times, only the last

    occurrence applies. By default -6 is enabled.

    Device used:

        dev :

            specify the device to which the commands apply.

        When the device option is used several times, only the last

        occurrence applies. If no device is specified, commands are

        applied to the first entry returned by 'wg show interfaces'

    Commands:

        --help

            show this message

        --test

            run the embedded test suite

        gen :

            generate an ip from the pubkey, in the specified subnet.

            when the --asnet option is used, the generated ip is cut to

            length to generate a subnet prefix instead of a whole ip.

        dryrun:

            generate an ip from the pubkey of the specified interface (see

            "device used"), as well as for all the peers of that same

            interface, in the specified subnet (see "subnet used"). Create

            commands to add this ip to the interface, as well as commands

            to modify allowed_ips for each peer. The commands are simply

            displayed, not applied.

        apply:

            actually run the commands displayed by 'dryrun'

    When several commands are specified, only the last one is

    executed. Executing '' without argument is the same as running

    ' dryrun'

    Example:

         dev wg0 apply

Original post

-------------

See https://lists.zx2c4.com/pipermail/wireguard/2018-April/002593.html