Files
GlobalProtect-openconnect/packaging/docker/README.md
T
Kevin Yue 86c8d188c4 feat: add connection dashboard and improve desktop authentication
Add tunnel configuration reporting, an optional CLI dashboard, manual browser authentication, native authentication controls, and broader client identity support. Improve TLS recovery, certificate validation, desktop notifications, and platform integration.
2026-10-19 23:26:38 +08:00

2.0 KiB

GlobalProtect-openconnect Docker image

This image provides the GlobalProtect-openconnect command-line tools on Alpine Linux. It includes:

  • gpclient - connect to and disconnect from GlobalProtect VPN portals and gateways
  • gpauth - authentication helper used by gpclient

The image does not include embedded webview authentication, gpgui-helper, or the graphical gpgui application.

Pull

docker pull yuezk/globalprotect-openconnect:<version>

Release images are tagged as vX.Y.Z, X.Y.Z, and latest.

Usage

VPN tunnel creation requires access to /dev/net/tun and the NET_ADMIN capability:

docker run --rm -it --cap-add=NET_ADMIN --device=/dev/net/tun \
  yuezk/globalprotect-openconnect:<version> \
  connect <portal>

For browser authentication in a headless environment, use manual browser authentication:

docker run --rm -it --cap-add=NET_ADMIN --device=/dev/net/tun \
  yuezk/globalprotect-openconnect:<version> \
  connect <portal> --browser manual

On a Linux host, add host networking if the VPN routes should affect the host network namespace:

docker run --rm -it --network host --cap-add=NET_ADMIN --device=/dev/net/tun \
  yuezk/globalprotect-openconnect:<version> \
  connect <portal> --browser manual

Without --network host, the VPN connection stays inside the container network namespace. Docker Desktop on macOS and Windows does not make the host use the VPN through --network host; run gpclient on the host or use a container gateway setup for host traffic.

Common commands

Show top-level help:

docker run --rm yuezk/globalprotect-openconnect:<version> --help

Show help for a command:

docker run --rm yuezk/globalprotect-openconnect:<version> help connect

Project

GlobalProtect-openconnect is a modern GlobalProtect VPN client for Linux, built on OpenConnect with support for SSO, non-SSO, FIDO2, client certificate authentication, multiple portals and gateways, and direct gateway connections.

Source: https://github.com/yuezk/GlobalProtect-openconnect