GMSSH Product ManualGMSSH Product Manual
Changelog
Official Site
  • 简体中文
  • English
Changelog
Official Site
  • 简体中文
  • English
  • 📖 Documentation

    • Product Overview
    • Introduction
    • Quick Start
    • GMSSH Client

      • Machine Management
      • Command Center
      • Terminal
      • Batch Tasks
      • Settings
    • GMSSH Desktop

      • Built-in Apps
      • App Center
      • Docker Manager
      • PHP Manager
      • MySQL Manager
      • Nginx Manager
      • Site Manager
      • Firewall Manager
      • WAF Firewall
      • Redis Manager
      • Proxy Manager
      • VPN Manager
      • Source Manager
    • Gemius AI
    • FAQ

VPN Manager

GMSSH VPN Manager is a visual VPN service management tool for Linux servers. It covers User Certificates, Permissions, Permission Groups, Configuration, Logs, and User Monitoring.

Core Features

ModulePurposeCore Capabilities
User CertificatesUser ManagementVPN client certificate creation and management
PermissionsAccess ControlUser-level access permission configuration
Permission GroupsGroup ManagementGroup-based permission policy management
ConfigurationGlobal SettingsVPN service global parameter configuration
LogsOperations MonitorVPN service runtime log viewing
User MonitoringReal-Time MonitorOnline user real-time status monitoring

Initialization

Auto Install

On first launch, the system detects VPN Admin installation status. If not installed, automatic installation begins.

Auto Install

  • Auto Detection & Install: Automatically installs VPN Admin stable version with progress display.
  • View Logs: Click "View Logs" during installation to monitor progress.

Service Startup

After installation, if the VPN service is not running, the page guides you to start it.

Service Startup

  • Service Status: Bottom-left shows status ("Not Running" in red).
  • Auth Method: Bottom-left shows current auth method (e.g., "No Auth").
  • Start Now: Center prompt with "Start Now" button.

User Certificates

VPN Client Certificate Management. Create, download, and manage client certificates.

User Certificates

  • Certificate List: Table showing client name, IP, notes, creation time, and actions.
  • Search: Top search box with client name dropdown filter.
  • Batch Operations: Bottom batch operations dropdown with pagination.
  • Certificate Actions: Each record provides:
    • Certificate Icon: View certificate details.
    • Download: Download client certificate file.
    • More Menu (⋮): View permissions, edit, delete.

Create Certificate

Create Certificate

FieldDescription
Batch CreateToggle for creating multiple certificates at once
Client NameClient name (required, max 15 characters)
Permission GroupDropdown for permission group selection (multi-select)
Additional PermissionsDropdown for extra permissions (multi-select)
NotesNotes (max 50 characters)

Permissions

Fine-Grained VPN Access Control. Define target IPs and policies for VPN user access.

Permissions

  • Permission List: Table showing name, target, policy, creation time, and actions.
  • Search: Top search box with permission name filter.
  • Permission Actions: Four operations per record:
    • Assign to User: Assign permission to specific users.
    • Association Config: Manage permission-group associations.
    • Edit: Modify permission info.
    • Delete: Remove the permission rule.

Create Permission

Create Permission

FieldDescription
Batch CreateToggle for batch creation
NamePermission name (required, max 16 characters)
TargetTarget IP address (required), must be on the VPN internal network

Permission Groups

Group-Based Batch Permission Management. Group multiple permissions together for batch assignment to users.

Permission Groups

  • Group List: Table showing name, creation time, default permission toggle, and actions.
  • Search: Quick search for permission groups.
  • Default Permission: Toggle per group — when set as default, new users automatically inherit the group's permissions.
  • Actions: Association config, edit, and delete.

Association Config

Association Config

  • All Permissions (left): Available permissions with search and select-all.
  • Permission Group (right): Currently associated permissions.
  • Operation: Move permissions from left to right, click "Confirm" to save.

Configuration

VPN Global Parameter Configuration. Visual adjustment of VPN service core parameters.

Configuration

ParameterExampleDescription
Routing Modetuntun (Layer 3 routing) or tap (Layer 2 bridging)
Access Subnet10.8.0.0 / 255.255.255.0VPN internal network segment and mask
Protocoludpudp (recommended, better performance) or tcp
User Offline NotificationNoSend notification when users disconnect
keepAlive120 secHeartbeat keepalive interval
Log Level4Log verbosity level
Max Clients100Maximum simultaneous client connections
Inter-Client CommunicationNoAllow VPN clients to communicate with each other
Multi-Client LoginNoAllow same certificate on multiple clients
Transport CompressionNoEnable data transmission compression
  • Open Config File: Top-right button for direct OpenVPN config editing.
  • Save: Click "Save" to restart service with new settings.

Logs

VPN Runtime Log Viewer. View complete VPN service status logs.

Logs

  • Log Content: Terminal-style display of VPN runtime parameters — IPv6 config, inter-client communication, rate limiting, max clients, routing restrictions, auth script config, etc.
  • Real-Time Refresh: Logs update in real-time as the service runs.

User Monitoring

Real-Time Online User Status. Table display of all currently connected VPN users.

User Monitoring

  • Monitor Table:
ColumnDescription
UserConnected client name
SourceClient's real IP address
Virtual AddressVPN-assigned virtual IP
Bytes ReceivedTotal received data
Bytes SentTotal sent data
Connected TimeConnection duration
  • Search: Quick user lookup.
  • Pagination: Bottom pagination (default 20 per page).
Last Updated: 3/19/26, 4:26 PM
Contributors: xiarui
Prev
Proxy Manager
Next
Source Manager