Files
Kevin Yue 4faa2ecb0d feat: prepare 3.1.0 with connection details and improved authentication
Add tunnel statistics and an optional CLI dashboard, native sign-in controls and recovery, and broader client certificate support. Include platform integration fixes and the approved release notes.
2026-10-19 23:47:11 +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