feat: support self-hosted firmware WebUI interface

Add support for the self-hosted firmware WebUI interface.

Signed-off-by: GL.iNet-Yongping.Xie <yongping.xie@gl-inet.com>

Author: yongpingxie

docker-compose/.env.arm64.example

@@ -22,6 +22,21 @@ COTURN_IMAGE=coturn/coturn:edge-alpine-arm64v8
 # https://github.com/gl-inet/glkvm-cloud/blob/main/docker-compose/nginx-reverse-proxy-example.conf
 REVERSE_PROXY_ENABLED=false
 
+# =====================================================
+# Selfhost WebUI URL (Optional)
+# =====================================================
+# The full URL (including scheme) of the self-hosted cloud WebUI.
+# This URL is written to the KVM device as /etc/kvmd/user/selfhost-cloud.json
+# so firmware can read it and create a navigation link in the device's web page.
+#
+# If left empty, the URL is automatically derived from the browser's current
+# address when copying the installation script.
+#
+# Examples:
+#   SELFHOST_WEBUI_URL=https://kvm.example.com
+#   SELFHOST_WEBUI_URL=https://192.168.1.100
+SELFHOST_WEBUI_URL=
+
 # =====================================================
 # Device Remote Access Domain (Reverse Proxy Mode Only)
 # =====================================================

docker-compose/.env.example

@@ -22,6 +22,22 @@ COTURN_IMAGE=coturn/coturn:edge-alpine
 # https://github.com/gl-inet/glkvm-cloud/blob/main/docker-compose/nginx-reverse-proxy-example.conf
 REVERSE_PROXY_ENABLED=false
 
+# =====================================================
+# Selfhost WebUI URL (Optional)
+# =====================================================
+# The full URL (including scheme) of the self-hosted cloud WebUI.
+# This URL is written to the KVM device as /etc/kvmd/user/selfhost-cloud.json
+# so firmware can read it and create a navigation link in the device's web page.
+#
+# If left empty, the URL is automatically derived from the browser's current
+# address when copying the installation script.
+#
+# Examples:
+#   SELFHOST_WEBUI_URL=https://kvm.example.com
+#   SELFHOST_WEBUI_URL=https://192.168.1.100
+SELFHOST_WEBUI_URL=
+
+
 # =====================================================
 # Device Remote Access Domain (Reverse Proxy Mode Only)
 # =====================================================

docker-compose/docker-compose.yml

@@ -53,6 +53,9 @@ services:
       OIDC_ADMIN_GROUP: ${OIDC_ADMIN_GROUP:-}
       OIDC_ADMIN_USERS: ${OIDC_ADMIN_USERS:-}
 
+      # ---- Selfhost WebUI URL ----
+      SELFHOST_WEBUI_URL: ${SELFHOST_WEBUI_URL:-}
+
       # ---- Reverse Proxy ----
       REVERSE_PROXY_ENABLED: ${REVERSE_PROXY_ENABLED:-false}
 

internal/http/router.go

@@ -90,6 +90,19 @@ func RegisterAPIRoutes(r *gin.Engine, d Deps) {
             }
         }
 
+        // Determine selfhost WebUI URL
+        webUIURL := strings.TrimSpace(cfg.SelfhostWebUIURL)
+        if webUIURL == "" {
+            scheme := "https"
+            if c.Request.TLS == nil {
+                scheme = "http"
+            }
+            if fwdProto := c.GetHeader("X-Forwarded-Proto"); fwdProto != "" {
+                scheme = fwdProto
+            }
+            webUIURL = scheme + "://" + c.Request.Host
+        }
+
         data := scriptInfoResp{
             Hostname:       chosen, // reuse the same chosen value
             Port:           cfg.AddrDev,
@@ -98,6 +111,7 @@ func RegisterAPIRoutes(r *gin.Engine, d Deps) {
             WebrtcPort:     cfg.WebrtcPort,
             WebrtcUsername: cfg.WebrtcUsername,
             WebrtcPassword: cfg.WebrtcPassword,
+            WebUIURL:       webUIURL,
         }
 
         dto.Write(c, dto.Ok(traceID, data))
@@ -158,6 +172,7 @@ type scriptInfoResp struct {
     WebrtcPort     string `json:"webrtcPort"`
     WebrtcUsername string `json:"webrtcUsername"`
     WebrtcPassword string `json:"webrtcPassword"`
+    WebUIURL       string `json:"webUIURL"`
 }
 
 func isIP(addr string) bool {

internal/server/version.go

@@ -1,7 +1,7 @@
 package server
 
 const RttysVersion = "5.2.0"
-const KVMCloudVersion = "v2.4.0"
+const KVMCloudVersion = "v2.5.0"
 
 var (
 	GitCommit = ""

ui/src/views/device/components/addDeviceDialog.vue

@@ -70,7 +70,7 @@ const OperatingSystemTranslated = computed(() => {
     ])
 })
 
-const generateScript = (hostname: string, port:string, token: string, webrtcIP: string, webrtcPort: string, webrtcUsername: string, webrtcPassword: string) => {
+const generateScript = (hostname: string, port:string, token: string, webrtcIP: string, webrtcPort: string, webrtcUsername: string, webrtcPassword: string, webUIURL: string) => {
     if (state.operatingSystem === OperatingSystemEnum.GL_KVM) {
         return `#!/bin/sh
 
@@ -81,15 +81,25 @@ WEBRTC_IP="${webrtcIP}"
 WEBRTC_PORT="${webrtcPort}"
 WEBRTC_USERNAME="${webrtcUsername}"
 WEBRTC_PASSWORD="${webrtcPassword}"
+WEBUI_URL="${webUIURL}"
 
 TARGET_DIR="/etc/kvmd/user/scripts"
 SCRIPT_FILE="$TARGET_DIR/S01selfCloud"
 WATCHDOG_SCRIPT="$TARGET_DIR/rtty-loop.sh"
+CLOUD_CONFIG="/etc/kvmd/user/selfhost-cloud.json"
 
 # 1. Create directory
 mkdir -p "$TARGET_DIR"
 
-# 2. Write S01selfCloud script
+# 2. Write selfhost cloud config JSON
+cat <<CLOUDCFG > "$CLOUD_CONFIG"
+{
+    "webui_url": "$WEBUI_URL",
+    "updated_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+}
+CLOUDCFG
+
+# 3. Write S01selfCloud script
 cat <<'EOF' > "$SCRIPT_FILE"
 #!/bin/sh
 
@@ -181,10 +191,10 @@ esac
 exit 0
 EOF
 
-# 3. Add execution permissions
+# 4. Add execution permissions
 chmod +x "$SCRIPT_FILE"
 
-# 4. Execute restart once
+# 5. Execute restart once
 "$SCRIPT_FILE" restart
 
 `
@@ -202,8 +212,8 @@ chmod +x "$SCRIPT_FILE"
 
 /** 组装脚本 */
 const handleGenerateScript = () => {
-    const { hostname, port, token, webrtcIP, webrtcPort, webrtcUsername, webrtcPassword } = state.scriptData as any
-    state.scriptContent = generateScript(hostname, port, token, webrtcIP, webrtcPort, webrtcUsername, webrtcPassword)
+    const { hostname, port, token, webrtcIP, webrtcPort, webrtcUsername, webrtcPassword, webUIURL } = state.scriptData as any
+    state.scriptContent = generateScript(hostname, port, token, webrtcIP, webrtcPort, webrtcUsername, webrtcPassword, webUIURL)
 }
 
 /** 复制脚本 */

xconfig/config.go

@@ -105,6 +105,15 @@ type Config struct {
     // Platform access domain restriction.
     // When set, only requests with a matching domain are allowed to access the platform.
     WebUIHost string
+
+    // =====================================================
+    // Selfhost WebUI URL
+    // =====================================================
+    // The full URL (including scheme) of the self-hosted cloud WebUI.
+    // Written to the KVM device as /etc/kvmd/user/selfhost-cloud.json
+    // so firmware can read it and create a link in the device's web page.
+    // If empty, the URL is derived from the browser's current request.
+    SelfhostWebUIURL string
 }
 
 // docker mode fixed path for reading certificate
@@ -202,6 +211,9 @@ func parseYamlCfg(cfg *Config, conf string) error {
     getConfigOpt(yamlCfg, "ldap-admin-group", &cfg.LdapAdminGroup)
     getConfigOpt(yamlCfg, "ldap-admin-users", &cfg.LdapAdminUsers)
 
+    // Selfhost WebUI URL
+    getConfigOpt(yamlCfg, "selfhost-webui-url", &cfg.SelfhostWebUIURL)
+
     // ===== OIDC configuration (generic OIDC provider) =====
     // Switch and basic endpoints
     getConfigOpt(yamlCfg, "oidc-enabled", &cfg.OIDCEnabled)
@@ -342,6 +354,10 @@ func applyEnvCfg(cfg *Config) error {
         cfg.DeviceEndpointHost = cleaned
     }
 
+    if v := strings.TrimSpace(os.Getenv("SELFHOST_WEBUI_URL")); v != "" {
+        cfg.SelfhostWebUIURL = v
+    }
+
     if v := strings.TrimSpace(os.Getenv("WEB_UI_HOST")); v != "" {
         cleaned := v
         // 1. Remove scheme if present (http:// or https://)