https://github.com/erred/wggo

wireguard-go in a container
https://github.com/erred/wggo

container wireguard wireguard-go

Last synced: 3 months ago
JSON representation

wireguard-go in a container

• Host: GitHub
• URL: https://github.com/erred/wggo
• Owner: erred
• License: mit
• Archived: true
• Created: 2019-02-20T08:21:49.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2020-12-12T17:50:16.000Z (almost 4 years ago)
• Last Synced: 2024-06-03T09:45:00.533Z (5 months ago)
• Topics: container, wireguard, wireguard-go
• Language: Shell
• Homepage:
• Size: 16.6 KB
• Stars: 7
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# wggo

[wireguard-go](https://git.zx2c4.com/wireguard-go/about/) in a container, becuase `WG_I_PREFER_BUGGY_USERSPACE_TO_POLISHED_KMOD=1`

[![License](https://img.shields.io/github/license/seankhliao/wggo.svg?style=flat-square)](LICENSE)

![Version](https://img.shields.io/github/v/tag/seankhliao/wggo?sort=semver&style=flat-square)

[![Docker](https://img.shields.io/docker/pulls/seankhliao/wggo?style=flat-square)](https://hub.docker.com/r/seankhliao/wggo)

## About

I ~~needed~~ wanted to run a wireguard VPN server on a system without access to kernel modules (GKE coos)

Based on [activeeos/wireguard-docker](https://github.com/activeeos/wireguard-docker), kernel module version of wireguard in a container, which you should probably be using

## Usage

### Prerequisites

- `CAP_NET_ADMIN` and `/dev/net/tun`

- A `wg-quick` config file

### Run

1. mount conf file into `/etc/wireguard/`, (name doesn't matter)

2. expose the port as specified in conf file

```sh

docker run --rm \

  --cap-add=NET_ADMIN \

  -v /dev/net/tun:/dev/net/tun \

  -v /abs/path/to/wg-quick/conf/file:/etc/wireguard/name_of_interface.conf \

  -p port:expose \

  seankhliao/wggo

```

### Build

With docker:

```sh

docker build \

  .

```

## Links

- [activeeos/wireguard-docker](https://github.com/activeeos/wireguard-docker): kernel mod version