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.
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 gatewaysgpauth- authentication helper used bygpclient
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.