SVI/netbird
1
0
Fork 0
mirror of https://github.com/netbirdio/netbird.git synced 2026-08-01 10:28:39 -04:00
Code Issues 3.0k Packages Projects Releases 10 Wiki Activity

Traffic inspection with Zenarmor on OPNsense #2356

New Issue
Open
opened 2025-11-20 07:08:28 -05:00 by saavagebueno · 0 comments
saavagebueno commented 2025-11-20 07:08:28 -05:00
Owner
Copy Link

Originally created by @on-nightingale on GitHub (Oct 10, 2025).

Describe the problem

Zenarmor is a next-generation firewall extension for OPNsense and we are using it to inspect traffic and enforce web filtering. Zenarmor is also able to inspect traffic on Wireguard interfaces.

Using the os-netbird plugin we can successful configure and establish a connection to our self-hosted netbird setup, also other peers can connect with the OPNsense instance. The netbird peer on OPNsense is set up as Exit-Node.

But Zenarmor is not able to see the traffic on the netbird created wireguard interface (wt0).

The only difference I could spot right now is that netbird is running in "userspace" and other Wireguard solutions are running in kernel mode.

To Reproduce

Steps to reproduce the behavior:

  1. Install os-netbird plugin
  2. Set up netbird to connect to self-hosted netbird setup
  3. Go to Interfaces -> Assignments and assign the netbird interface (wt0) with the name netbird
  4. Go to Interfaces -> [netbird] and enable the interface
  5. Go to Zenarmor -> Settings -> Configuration -> Please choose interfaces to protect and select wt0
  6. Save Zenarmor configuration and restart the service
  7. Go to Zenarmor -> Live Sessions -> Connections and observe the connections. No traffic from wt0 will show up.

Expected behavior

Zenarmor should be able to inspect the traffic on Wireguard interfaces created by netbird.

Are you using NetBird Cloud?

  • self-host NetBird's control plane.

NetBird version

  • Netbird 0.59.1
  • OPNsense 25.7.5
  • Zenarmor 2.1

Is any other VPN software installed?

If yes, which one?

  • Wireguard
  • OpenVPN
  • IPsec
  • Defguard

Debug output

To help us resolve the problem, please attach the following anonymized status output

# netbird status -dA
Peers detail:
 nb-peer1.netbird.selfhosted:
  NetBird IP: 100.108.10.100
  Public key: [removed]
  Status: Connecting
  -- detail --
  Connection type: P2P
  ICE candidate (Local/Remote): -/-
  ICE candidate endpoints (Local/Remote): -/-
  Relay server address: 
  Last connection update: 20 minutes, 36 seconds ago
  Last WireGuard handshake: -
  Transfer status (received/sent) 0 B/0 B
  Quantum resistance: false
  Networks: -
  Latency: 0s

Events:
  [INFO] SYSTEM (4340e543-83ee-40d6-b801-94a5a757e570)
    Message: Network map updated
    Time: 20 minutes, 36 seconds ago
OS: freebsd/amd64
Daemon version: 0.59.1
CLI version: 0.59.1
Profile: default
Management: Connected to https://poc-nb.anon-Bh96S.domain:444
Signal: Connected to https://poc-nb.anon-Bh96S.domain:446
Relays: 
  [stun:poc-nb.anon-Bh96S.domain:3478] is Unavailable, reason: stun request: context deadline exceeded
  [turn:poc-nb.anon-Bh96S.domain:3478?transport=udp] is Unavailable, reason: allocate: all retransmissions failed for WbBJ9AJYW2mtBZYZ
  [rels://poc-nb.anon-Bh96S.domain:443/relay] is Available
Nameservers: 
  [192.168.200.10:53] for [.] is Available
FQDN: opn01.netbird.selfhosted
NetBird IP: 100.108.10.50/16
Interface type: Userspace
Quantum resistance: false
Lazy connection: false
Networks: -
Forwarding rules: 0
Peers count: 0/1 Connected

Additional context

Add any other context about the problem here.

Have you tried these troubleshooting steps?

  • Reviewed client troubleshooting (if applicable)
  • Checked for newer NetBird versions
  • Searched for similar issues on GitHub (including closed ones)
  • Restarted the NetBird client
  • Disabled other VPN software
  • Checked firewall settings
Originally created by @on-nightingale on GitHub (Oct 10, 2025). **Describe the problem** Zenarmor is a next-generation firewall extension for OPNsense and we are using it to inspect traffic and enforce web filtering. Zenarmor is also able to inspect traffic on Wireguard interfaces. Using the os-netbird plugin we can successful configure and establish a connection to our self-hosted netbird setup, also other peers can connect with the OPNsense instance. The netbird peer on OPNsense is set up as Exit-Node. But Zenarmor is not able to see the traffic on the netbird created wireguard interface (wt0). The only difference I could spot right now is that netbird is running in "userspace" and other Wireguard solutions are running in kernel mode. **To Reproduce** Steps to reproduce the behavior: 1. Install os-netbird plugin 2. Set up netbird to connect to self-hosted netbird setup 3. Go to `Interfaces` -> `Assignments` and assign the netbird interface (wt0) with the name `netbird` 4. Go to `Interfaces` -> `[netbird]` and enable the interface 5. Go to `Zenarmor` -> `Settings` -> `Configuration` -> `Please choose interfaces to protect` and select `wt0` 6. Save Zenarmor configuration and restart the service 7. Go to `Zenarmor` -> `Live Sessions` -> `Connections` and observe the connections. No traffic from wt0 will show up. **Expected behavior** Zenarmor should be able to inspect the traffic on Wireguard interfaces created by netbird. **Are you using NetBird Cloud?** - self-host NetBird's control plane. **NetBird version** - Netbird `0.59.1` - OPNsense `25.7.5` - Zenarmor `2.1` **Is any other VPN software installed?** If yes, which one? - Wireguard - OpenVPN - IPsec - Defguard **Debug output** To help us resolve the problem, please attach the following anonymized status output ``` # netbird status -dA Peers detail: nb-peer1.netbird.selfhosted: NetBird IP: 100.108.10.100 Public key: [removed] Status: Connecting -- detail -- Connection type: P2P ICE candidate (Local/Remote): -/- ICE candidate endpoints (Local/Remote): -/- Relay server address: Last connection update: 20 minutes, 36 seconds ago Last WireGuard handshake: - Transfer status (received/sent) 0 B/0 B Quantum resistance: false Networks: - Latency: 0s Events: [INFO] SYSTEM (4340e543-83ee-40d6-b801-94a5a757e570) Message: Network map updated Time: 20 minutes, 36 seconds ago OS: freebsd/amd64 Daemon version: 0.59.1 CLI version: 0.59.1 Profile: default Management: Connected to https://poc-nb.anon-Bh96S.domain:444 Signal: Connected to https://poc-nb.anon-Bh96S.domain:446 Relays: [stun:poc-nb.anon-Bh96S.domain:3478] is Unavailable, reason: stun request: context deadline exceeded [turn:poc-nb.anon-Bh96S.domain:3478?transport=udp] is Unavailable, reason: allocate: all retransmissions failed for WbBJ9AJYW2mtBZYZ [rels://poc-nb.anon-Bh96S.domain:443/relay] is Available Nameservers: [192.168.200.10:53] for [.] is Available FQDN: opn01.netbird.selfhosted NetBird IP: 100.108.10.50/16 Interface type: Userspace Quantum resistance: false Lazy connection: false Networks: - Forwarding rules: 0 Peers count: 0/1 Connected ``` **Additional context** Add any other context about the problem here. **Have you tried these troubleshooting steps?** - [x] Reviewed [client troubleshooting](https://docs.netbird.io/how-to/troubleshooting-client) (if applicable) - [x] Checked for newer NetBird versions - [x] Searched for similar issues on GitHub (including closed ones) - [x] Restarted the NetBird client - [ ] Disabled other VPN software - [x] Checked firewall settings
saavagebueno added the triage-needed label 2025-11-20 07:08:28 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
2021 Q4
2022 Q1
2022 Q1
accessibility
acl
agent
agent
Android
Android
api
authentik
automation
azure
battery-usage
bug
cache
client
client-ui
cloud
cloud-only
cloudflare
community
compatibility
config-idp
config-issue
connection
contribution
coturn
cross-vpn
dashboard
data-usage
distribution
dns
docker
documentation
duplicate
enhancement
enhancement
event-stream
feature-request
freebsd
getting-started
go
good first issue
gui
help wanted
home-assistant
idp
inconsistency
integration
integrations
ios
ipv6
jwt
k8s
keycloak
linux
login
macos
management-service
missing-docs
mobile
moved-internal
needs-review
netbird-ui
networking
new-platform
nginx
notification
okta
openwrt
packaging
peer-management
peer-management
peer-management
performance
postgres
posture-checks
psk
pull-request
Mirrored from GitHub Pull Request
 question
refactor
relay
release
rfc
routes
security
security-related
self-hosting
server
signal
sleep-issue
ssh
ssl
status
store
synology
system-compatibility-issue
test-suite
third-party-integration
triage
triage-needed
troubleshooting
UX
waiting-feedback
windows
wontfix
zitadel
No Label triage-needed
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
saavagebueno
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: SVI/netbird#2356
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?