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.