mainfrezzer-wireguard-client

mainfrezzer-wireguard-client

Docker app from Mainfrezzer's Repository

Overview

Allows you to connect your containers to a dual-stack or even ipv6 only wireguard server. Comes with Privoxy as http proxy (https://www.privoxy.org/) and mircosocks as socks5 proxy (https://github.com/rofl0r/microsocks)

Runtime arguments

Network
bridge
Shell
sh
Privileged
false
Extra Params
--cap-add=NET_ADMIN --sysctl net.ipv4.conf.all.src_valid_mark=1

Template configuration

Wireguard ConfigPathrw

Location to place your wg0.conf

Target
/etc/wireguard/
Value
/mnt/user/appdata/wg-bridge
Socks5Porttcp
Target
1080
Default
1080
Value
1080
Http ProxyPorttcp
Target
8080
Default
8080
Value
8080
Lan NetworkVariable

Set you ipv4 LAN network in CIDR format. Only needed if you want to reach something attached to this container and vice versa

Target
LAN_NETWORK
Default
192.168.2.0/24
Value
192.168.2.0/24
Lan IPV6 NetworkVariable

Set your ipv6 LAN network in CIDR format. ULA or GUA. Only needed if you want to reach something attached to this container and vice versa

Target
LAN_NETWORK6
Default
fd00::/64
Value
fd00::/64
Privoxy portVariable

Allows you to change the port Privoxy listens on inside the container. If you change it, dont forget to add a new port mapping

Target
HTTPPORT
Default
8080
Value
8080
Random ModeVariable

Setting this to 1 will pick a wireguard config file randomly to establish the connection. Do not name the files wg0.conf

Target
ENABLE_RANDOM
Default
0
Value
0
Healthcheck URLVariable

By default the healthcheck checks its endpoint via ping. This might not be possible in some cases. You can set a domain or ip address here to use instead.

Target
HEALTH_URL_CHECK
CONNECTED_CONTAINERSVariable

This variable enables the Connected Containers feature which will notify compatible containers when the VPN is restarted and restart themselves. To enable this feature enter '27286' without quotes, if you don't want to enable this feature leave this field empty.

Disable Tunnel EnforcementVariable

Setting ANY value will disable the VPN tunnel enforcement. That means the container will not ensure that all your traffic is routed through the VPN. This is useful if you want your containers only to reach specific VPN IPs but otherwise want to use your internet connection

Target
DISABLE_TUNNEL_MODE

Download Statistics

1,334
Total Downloads

Details

Repository
ghcr.io/mainfrezzer/wg-bridge:latest
Last Updated2026-03-23
First Seen2025-03-16

Run mainfrezzer-wireguard-client on Unraid.

mainfrezzer-wireguard-client is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.