mirror of
https://github.com/Termix-SSH/Termix.git
synced 2026-07-15 04:43:36 +00:00
604 lines
18 KiB
TypeScript
604 lines
18 KiB
TypeScript
import {
|
|
useEffect,
|
|
useRef,
|
|
useState,
|
|
useImperativeHandle,
|
|
forwardRef,
|
|
useCallback,
|
|
} from "react";
|
|
import Guacamole from "guacamole-common-js";
|
|
import { useTranslation } from "react-i18next";
|
|
import { getGuacamoleToken, isElectron, isEmbeddedMode } from "@/main-axios.ts";
|
|
import { SimpleLoader } from "@/lib/SimpleLoader.tsx";
|
|
import { WifiOff, RefreshCw } from "lucide-react";
|
|
import { Button } from "@/components/button.tsx";
|
|
|
|
export type GuacamoleConnectionType = "rdp" | "vnc" | "telnet";
|
|
|
|
export interface GuacamoleConnectionConfig {
|
|
token?: string;
|
|
protocol?: GuacamoleConnectionType;
|
|
type?: GuacamoleConnectionType;
|
|
hostname?: string;
|
|
port?: number;
|
|
username?: string;
|
|
password?: string;
|
|
domain?: string;
|
|
width?: number;
|
|
height?: number;
|
|
dpi?: number;
|
|
[key: string]: unknown;
|
|
}
|
|
|
|
export interface GuacamoleDisplayHandle {
|
|
disconnect: () => void;
|
|
sendKey: (keysym: number, pressed: boolean) => void;
|
|
sendMouse: (x: number, y: number, buttonMask: number) => void;
|
|
setClipboard: (data: string) => void;
|
|
}
|
|
|
|
interface GuacamoleDisplayProps {
|
|
connectionConfig: GuacamoleConnectionConfig;
|
|
isVisible: boolean;
|
|
onConnect?: () => void;
|
|
onDisconnect?: () => void;
|
|
onError?: (error: string) => void;
|
|
}
|
|
|
|
const isDev = import.meta.env.DEV;
|
|
|
|
export const GuacamoleDisplay = forwardRef<
|
|
GuacamoleDisplayHandle,
|
|
GuacamoleDisplayProps
|
|
>(function GuacamoleDisplay(
|
|
{ connectionConfig, isVisible, onConnect, onDisconnect, onError },
|
|
ref,
|
|
) {
|
|
const { t } = useTranslation();
|
|
const containerRef = useRef<HTMLDivElement>(null);
|
|
const displayRef = useRef<HTMLDivElement>(null);
|
|
const displayElementRef = useRef<HTMLElement | null>(null);
|
|
const clientRef = useRef<Guacamole.Client | null>(null);
|
|
const keyboardRef = useRef<Guacamole.Keyboard | null>(null);
|
|
const scaleRef = useRef<number>(1);
|
|
const resizeTimeoutRef = useRef<NodeJS.Timeout | null>(null);
|
|
const hasKeyboardFocusRef = useRef(false);
|
|
const windowFocusedRef = useRef(
|
|
typeof document === "undefined" ? true : document.hasFocus(),
|
|
);
|
|
const [isReady, setIsReady] = useState(false);
|
|
const [connectionError, setConnectionError] = useState<string | null>(null);
|
|
|
|
useImperativeHandle(ref, () => ({
|
|
disconnect: () => {
|
|
if (clientRef.current) {
|
|
clientRef.current.disconnect();
|
|
}
|
|
},
|
|
sendKey: (keysym: number, pressed: boolean) => {
|
|
if (clientRef.current) {
|
|
clientRef.current.sendKeyEvent(pressed ? 1 : 0, keysym);
|
|
}
|
|
},
|
|
sendMouse: (x: number, y: number, buttonMask: number) => {
|
|
if (clientRef.current) {
|
|
clientRef.current.sendMouseState(
|
|
new Guacamole.Mouse.State({
|
|
x,
|
|
y,
|
|
left: !!(buttonMask & 1),
|
|
middle: !!(buttonMask & 2),
|
|
right: !!(buttonMask & 4),
|
|
}),
|
|
);
|
|
}
|
|
},
|
|
setClipboard: (data: string) => {
|
|
if (clientRef.current) {
|
|
const stream = clientRef.current.createClipboardStream("text/plain");
|
|
const writer = new Guacamole.StringWriter(stream);
|
|
writer.sendText(data);
|
|
writer.sendEnd();
|
|
}
|
|
},
|
|
}));
|
|
|
|
const getWebSocketUrl = useCallback(
|
|
async (
|
|
containerWidth: number,
|
|
containerHeight: number,
|
|
): Promise<string | null> => {
|
|
try {
|
|
let token: string;
|
|
const protocol = connectionConfig.protocol ?? connectionConfig.type;
|
|
|
|
if (connectionConfig.token) {
|
|
token = connectionConfig.token;
|
|
} else {
|
|
const data = await getGuacamoleToken({
|
|
protocol: protocol ?? "rdp",
|
|
hostname: String(connectionConfig.hostname ?? ""),
|
|
port: connectionConfig.port,
|
|
username: connectionConfig.username,
|
|
password: connectionConfig.password,
|
|
domain: connectionConfig.domain,
|
|
security:
|
|
typeof connectionConfig.security === "string"
|
|
? connectionConfig.security
|
|
: undefined,
|
|
ignoreCert:
|
|
typeof connectionConfig.ignoreCert === "boolean"
|
|
? connectionConfig.ignoreCert
|
|
: undefined,
|
|
guacamoleConfig: connectionConfig.guacamoleConfig as Parameters<
|
|
typeof getGuacamoleToken
|
|
>[0]["guacamoleConfig"],
|
|
});
|
|
token = data.token;
|
|
}
|
|
|
|
const width = connectionConfig.width ?? containerWidth ?? 1280;
|
|
const height = connectionConfig.height ?? containerHeight ?? 720;
|
|
|
|
const wsBase = isDev
|
|
? `ws://localhost:30008`
|
|
: isElectron()
|
|
? (() => {
|
|
const configuredUrl = (
|
|
window as { configuredServerUrl?: string }
|
|
).configuredServerUrl;
|
|
|
|
// Embedded mode or no configured remote server: connect directly
|
|
// to the local guacamole websocket service.
|
|
if (isEmbeddedMode() || !configuredUrl) {
|
|
return "ws://127.0.0.1:30008";
|
|
}
|
|
|
|
const wsProtocol = configuredUrl.startsWith("https://")
|
|
? "wss://"
|
|
: "ws://";
|
|
const wsHost = configuredUrl
|
|
.replace(/^https?:\/\//, "")
|
|
.replace(/\/$/, "");
|
|
return `${wsProtocol}${wsHost}/guacamole/websocket/`;
|
|
})()
|
|
: `${window.location.protocol === "https:" ? "wss" : "ws"}://${window.location.host}/guacamole/websocket/`;
|
|
|
|
const params = new URLSearchParams({
|
|
token,
|
|
width: String(width),
|
|
height: String(height),
|
|
});
|
|
return `${wsBase}?${params.toString()}`;
|
|
} catch (error) {
|
|
const errorMessage =
|
|
error instanceof Error ? error.message : "Unknown error";
|
|
onError?.(errorMessage);
|
|
return null;
|
|
}
|
|
},
|
|
[connectionConfig, onError],
|
|
);
|
|
|
|
const refreshKeyboardHandlers = useCallback(() => {
|
|
const keyboard = keyboardRef.current;
|
|
const client = clientRef.current;
|
|
const displayElement = displayElementRef.current;
|
|
|
|
if (!keyboard) return;
|
|
|
|
const documentVisible =
|
|
typeof document === "undefined" || document.visibilityState === "visible";
|
|
const displayIsFocused =
|
|
!!displayElement &&
|
|
typeof document !== "undefined" &&
|
|
document.activeElement === displayElement;
|
|
const shouldCaptureInput =
|
|
!!client &&
|
|
!!displayElement &&
|
|
isVisible &&
|
|
documentVisible &&
|
|
windowFocusedRef.current &&
|
|
(hasKeyboardFocusRef.current || displayIsFocused);
|
|
|
|
if (!shouldCaptureInput) {
|
|
keyboard.onkeydown = null;
|
|
keyboard.onkeyup = null;
|
|
keyboard.reset();
|
|
return;
|
|
}
|
|
|
|
keyboard.onkeydown = (keysym: number) => {
|
|
if (!clientRef.current) return;
|
|
if (!isVisible || !windowFocusedRef.current) return;
|
|
|
|
const activeDisplay = displayElementRef.current;
|
|
const stillFocused =
|
|
!!activeDisplay &&
|
|
typeof document !== "undefined" &&
|
|
document.activeElement === activeDisplay;
|
|
|
|
if (!hasKeyboardFocusRef.current && !stillFocused) return;
|
|
clientRef.current.sendKeyEvent(1, keysym);
|
|
};
|
|
|
|
keyboard.onkeyup = (keysym: number) => {
|
|
if (!clientRef.current) return;
|
|
if (!isVisible || !windowFocusedRef.current) return;
|
|
|
|
const activeDisplay = displayElementRef.current;
|
|
const stillFocused =
|
|
!!activeDisplay &&
|
|
typeof document !== "undefined" &&
|
|
document.activeElement === activeDisplay;
|
|
|
|
if (!hasKeyboardFocusRef.current && !stillFocused) return;
|
|
clientRef.current.sendKeyEvent(0, keysym);
|
|
};
|
|
}, [isVisible]);
|
|
|
|
const rescaleDisplay = useCallback((immediate: boolean = false) => {
|
|
if (!clientRef.current || !containerRef.current) return;
|
|
|
|
const performRescale = () => {
|
|
if (!clientRef.current || !containerRef.current) return;
|
|
|
|
const display = clientRef.current.getDisplay();
|
|
const cWidth = containerRef.current.clientWidth;
|
|
const cHeight = containerRef.current.clientHeight;
|
|
const displayWidth = display.getWidth();
|
|
const displayHeight = display.getHeight();
|
|
|
|
if (displayWidth > 0 && displayHeight > 0 && cWidth > 0 && cHeight > 0) {
|
|
const scale = Math.min(cWidth / displayWidth, cHeight / displayHeight);
|
|
scaleRef.current = scale;
|
|
display.scale(scale);
|
|
}
|
|
};
|
|
|
|
if (immediate) {
|
|
performRescale();
|
|
} else {
|
|
if (resizeTimeoutRef.current) {
|
|
clearTimeout(resizeTimeoutRef.current);
|
|
}
|
|
resizeTimeoutRef.current = setTimeout(performRescale, 200);
|
|
}
|
|
}, []);
|
|
|
|
const connect = useCallback(async () => {
|
|
if (isConnectingRef.current) return;
|
|
isConnectingRef.current = true;
|
|
setIsReady(false);
|
|
setConnectionError(null);
|
|
|
|
let containerWidth = containerRef.current?.clientWidth || 0;
|
|
let containerHeight = containerRef.current?.clientHeight || 0;
|
|
|
|
if (containerWidth < 100 || containerHeight < 100) {
|
|
containerWidth = 1280;
|
|
containerHeight = 720;
|
|
}
|
|
|
|
const wsUrl = await getWebSocketUrl(containerWidth, containerHeight);
|
|
if (!wsUrl) {
|
|
isConnectingRef.current = false;
|
|
return;
|
|
}
|
|
|
|
const tunnel = new Guacamole.WebSocketTunnel(wsUrl);
|
|
const client = new Guacamole.Client(tunnel);
|
|
clientRef.current = client;
|
|
|
|
const display = client.getDisplay();
|
|
const displayElement = display.getElement();
|
|
displayElementRef.current = displayElement;
|
|
|
|
if (displayRef.current) {
|
|
displayRef.current.innerHTML = "";
|
|
displayRef.current.appendChild(displayElement);
|
|
}
|
|
|
|
displayElement.setAttribute("tabindex", "0");
|
|
displayElement.style.outline = "none";
|
|
|
|
display.onresize = () => {
|
|
rescaleDisplay(true);
|
|
setIsReady(true);
|
|
};
|
|
|
|
const mouse = new Guacamole.Mouse(displayElement);
|
|
const sendMouseState = (state: Guacamole.Mouse.State) => {
|
|
displayElement.focus({ preventScroll: true });
|
|
const scale = scaleRef.current;
|
|
const adjustedX = Math.round(state.x / scale);
|
|
const adjustedY = Math.round(state.y / scale);
|
|
|
|
const adjustedState = new Guacamole.Mouse.State(
|
|
adjustedX,
|
|
adjustedY,
|
|
state.left,
|
|
state.middle,
|
|
state.right,
|
|
state.up,
|
|
state.down,
|
|
) as Guacamole.Mouse.State;
|
|
|
|
client.sendMouseState(adjustedState);
|
|
};
|
|
mouse.onmousedown = mouse.onmouseup = mouse.onmousemove = sendMouseState;
|
|
|
|
const keyboard = new Guacamole.Keyboard(displayElement);
|
|
keyboardRef.current = keyboard;
|
|
|
|
const handleDisplayFocus = () => {
|
|
hasKeyboardFocusRef.current = true;
|
|
refreshKeyboardHandlers();
|
|
};
|
|
|
|
const handleDisplayBlur = () => {
|
|
hasKeyboardFocusRef.current = false;
|
|
refreshKeyboardHandlers();
|
|
};
|
|
|
|
displayElement.addEventListener("focus", handleDisplayFocus);
|
|
displayElement.addEventListener("blur", handleDisplayBlur);
|
|
displayElement.addEventListener("mousedown", handleDisplayFocus);
|
|
refreshKeyboardHandlers();
|
|
|
|
client.onstatechange = (state: number) => {
|
|
switch (state) {
|
|
case 0:
|
|
break;
|
|
case 1:
|
|
break;
|
|
case 2:
|
|
break;
|
|
case 3:
|
|
isConnectingRef.current = false;
|
|
setIsReady(true);
|
|
onConnect?.();
|
|
break;
|
|
case 4:
|
|
break;
|
|
case 5:
|
|
setIsReady(false);
|
|
hasKeyboardFocusRef.current = false;
|
|
refreshKeyboardHandlers();
|
|
onDisconnect?.();
|
|
break;
|
|
}
|
|
};
|
|
|
|
client.onerror = (error: Guacamole.Status) => {
|
|
const errorMessage = error.message || t("guacamole.connectionError");
|
|
setIsReady(false);
|
|
setConnectionError(errorMessage);
|
|
isConnectingRef.current = false;
|
|
onError?.(errorMessage);
|
|
};
|
|
|
|
client.onclipboard = (stream: Guacamole.InputStream, mimetype: string) => {
|
|
if (mimetype === "text/plain") {
|
|
const reader = new Guacamole.StringReader(stream);
|
|
let data = "";
|
|
reader.ontext = (text: string) => {
|
|
data += text;
|
|
};
|
|
reader.onend = () => {
|
|
navigator.clipboard?.writeText?.(data).catch(() => {});
|
|
};
|
|
}
|
|
};
|
|
|
|
client.onaudio = (stream: Guacamole.InputStream, mimetype: string) => {
|
|
Guacamole.AudioPlayer.getInstance(stream, mimetype);
|
|
};
|
|
|
|
client.connect();
|
|
}, [
|
|
getWebSocketUrl,
|
|
onConnect,
|
|
onDisconnect,
|
|
onError,
|
|
refreshKeyboardHandlers,
|
|
rescaleDisplay,
|
|
]);
|
|
|
|
const hasInitiatedRef = useRef(false);
|
|
const isMountedRef = useRef(false);
|
|
const isConnectingRef = useRef(false);
|
|
|
|
useEffect(() => {
|
|
isMountedRef.current = true;
|
|
|
|
if (isVisible && !hasInitiatedRef.current) {
|
|
hasInitiatedRef.current = true;
|
|
requestAnimationFrame(() => {
|
|
if (isMountedRef.current) {
|
|
connect();
|
|
}
|
|
});
|
|
}
|
|
}, [isVisible, connect]);
|
|
|
|
useEffect(() => {
|
|
if (!isVisible) {
|
|
hasKeyboardFocusRef.current = false;
|
|
}
|
|
|
|
refreshKeyboardHandlers();
|
|
}, [isVisible, refreshKeyboardHandlers]);
|
|
|
|
useEffect(() => {
|
|
const handleWindowFocus = () => {
|
|
windowFocusedRef.current = true;
|
|
refreshKeyboardHandlers();
|
|
};
|
|
|
|
const handleWindowBlur = () => {
|
|
windowFocusedRef.current = false;
|
|
hasKeyboardFocusRef.current = false;
|
|
refreshKeyboardHandlers();
|
|
};
|
|
|
|
const handleVisibilityChange = () => {
|
|
windowFocusedRef.current =
|
|
document.visibilityState === "visible" && document.hasFocus();
|
|
if (document.visibilityState !== "visible") {
|
|
hasKeyboardFocusRef.current = false;
|
|
}
|
|
refreshKeyboardHandlers();
|
|
};
|
|
|
|
window.addEventListener("focus", handleWindowFocus);
|
|
window.addEventListener("blur", handleWindowBlur);
|
|
document.addEventListener("visibilitychange", handleVisibilityChange);
|
|
|
|
return () => {
|
|
window.removeEventListener("focus", handleWindowFocus);
|
|
window.removeEventListener("blur", handleWindowBlur);
|
|
document.removeEventListener("visibilitychange", handleVisibilityChange);
|
|
};
|
|
}, [refreshKeyboardHandlers]);
|
|
|
|
useEffect(() => {
|
|
return () => {
|
|
isMountedRef.current = false;
|
|
hasInitiatedRef.current = false;
|
|
isConnectingRef.current = false;
|
|
if (resizeTimeoutRef.current) {
|
|
clearTimeout(resizeTimeoutRef.current);
|
|
}
|
|
if (clientRef.current) {
|
|
clientRef.current.disconnect();
|
|
clientRef.current = null;
|
|
}
|
|
displayElementRef.current = null;
|
|
};
|
|
}, []);
|
|
|
|
useEffect(() => {
|
|
if (!containerRef.current) return;
|
|
|
|
const resizeObserver = new ResizeObserver(() => {
|
|
rescaleDisplay(false);
|
|
if (resizeTimeoutRef.current) clearTimeout(resizeTimeoutRef.current);
|
|
resizeTimeoutRef.current = setTimeout(() => {
|
|
if (clientRef.current && containerRef.current) {
|
|
const w = containerRef.current.clientWidth;
|
|
const h = containerRef.current.clientHeight;
|
|
if (w > 0 && h > 0) clientRef.current.sendSize(w, h);
|
|
}
|
|
}, 200);
|
|
});
|
|
|
|
resizeObserver.observe(containerRef.current);
|
|
|
|
const initialTimeout = setTimeout(() => rescaleDisplay(true), 100);
|
|
|
|
return () => {
|
|
resizeObserver.disconnect();
|
|
clearTimeout(initialTimeout);
|
|
};
|
|
}, [rescaleDisplay]);
|
|
|
|
const syncClipboard = useCallback(() => {
|
|
const client = clientRef.current;
|
|
if (!client || !navigator.clipboard?.readText) return;
|
|
navigator.clipboard
|
|
.readText()
|
|
.then((text) => {
|
|
if (text) {
|
|
const stream = client.createClipboardStream("text/plain");
|
|
const writer = new Guacamole.StringWriter(stream);
|
|
writer.sendText(text);
|
|
writer.sendEnd();
|
|
}
|
|
})
|
|
.catch(() => {});
|
|
}, []);
|
|
|
|
useEffect(() => {
|
|
if (isVisible && isReady) {
|
|
syncClipboard();
|
|
}
|
|
}, [isVisible, isReady, syncClipboard]);
|
|
|
|
useEffect(() => {
|
|
const container = containerRef.current;
|
|
if (!container || !isReady) return;
|
|
|
|
const handleFocus = () => syncClipboard();
|
|
container.addEventListener("mouseenter", handleFocus);
|
|
|
|
return () => {
|
|
container.removeEventListener("mouseenter", handleFocus);
|
|
};
|
|
}, [isReady, syncClipboard]);
|
|
|
|
const handleReconnect = useCallback(() => {
|
|
setConnectionError(null);
|
|
hasInitiatedRef.current = false;
|
|
isConnectingRef.current = false;
|
|
if (clientRef.current) {
|
|
clientRef.current.disconnect();
|
|
clientRef.current = null;
|
|
}
|
|
displayElementRef.current = null;
|
|
connect();
|
|
}, [connect]);
|
|
|
|
const connectingMessage = t("guacamole.connecting", {
|
|
type: (
|
|
connectionConfig.protocol ||
|
|
connectionConfig.type ||
|
|
"remote"
|
|
).toUpperCase(),
|
|
});
|
|
|
|
return (
|
|
<div
|
|
ref={containerRef}
|
|
className="absolute inset-0 overflow-hidden"
|
|
style={{ backgroundColor: "var(--bg-base)" }}
|
|
>
|
|
<div
|
|
ref={displayRef}
|
|
className="relative w-full h-full flex items-center justify-center"
|
|
style={{
|
|
cursor: isReady ? "none" : "default",
|
|
visibility: isReady ? "visible" : "hidden",
|
|
}}
|
|
/>
|
|
|
|
{connectionError ? (
|
|
<div
|
|
className="absolute inset-0 flex flex-col items-center justify-center gap-4 z-[100]"
|
|
style={{ backgroundColor: "var(--bg-base)" }}
|
|
>
|
|
<WifiOff className="size-10" style={{ color: "var(--foreground)" }} />
|
|
<p
|
|
className="text-sm font-semibold"
|
|
style={{ color: "var(--foreground)" }}
|
|
>
|
|
{t("guacamole.connectionFailed")}
|
|
</p>
|
|
<p
|
|
className="text-xs max-w-xs text-center"
|
|
style={{ color: "var(--foreground-secondary)" }}
|
|
>
|
|
{connectionError}
|
|
</p>
|
|
<Button variant="outline" size="sm" onClick={handleReconnect}>
|
|
<RefreshCw className="size-4 mr-2" />
|
|
{t("guacamole.reconnect")}
|
|
</Button>
|
|
</div>
|
|
) : (
|
|
<SimpleLoader visible={!isReady} message={connectingMessage} />
|
|
)}
|
|
</div>
|
|
);
|
|
});
|