x11vnc 無法識別 Caps Lock 大寫鎖定鍵的解決方法

x11vnc 無法識別 Caps Lock 大寫鎖定鍵的解決方法

現象：通過 x11vnc 遠程桌面連接 Linux 時，按 Caps Lock 切換大小寫無效，始終輸入小寫字母，必須按住 Shift 才能輸入大寫。

原因分析

x11vnc 默認不同步鍵盤 LED 狀態（Caps Lock、Num Lock、Scroll Lock），導致服務端 X 服務器認為鎖定鍵未按下，繼續發送小寫鍵碼。

解決方法

啟動 x11vnc 時添加 -capslock 參數：

x11vnc -capslock -display :0 -auth /var/run/lightdm/root/:0 -forever -loop -noxdamage -repeat -rfbauth /home/user/.vnc/passwd -rfbport 5900

或寫入 systemd 服務單元：

[Unit]
Description=x11vnc VNC Server
After=graphical.target

[Service]
Type=simple
User=user
ExecStart=/usr/bin/x11vnc -capslock -display :0 -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/user/.vnc/passwd -rfbport 5900
Restart=on-failure

[Install]
WantedBy=multi-user.target

參數說明

• -capslock：同步 Caps Lock 狀態（核心修復）。
• -display :0：目標 X 顯示器。
• -auth guess：自動尋找 Xauthority 文件（支持 GDM/LightDM/SDDM）。
• -forever -loop：持續運行，客戶端斷開後繼續監聽。
• -noxdamage：禁用 XDamage 擴展（兼容性更好）。
• -repeat：啟用按鍵重複。
• -rfbauth：VNC 密碼文件（vncpasswd 生成）。
• -rfbport 5900：VNC 端口。

客戶端推薦

• Windows：RealVNC Viewer、TightVNC Viewer、MobaXterm。
• 跨平台：Remmina (Linux/Windows/macOS)、Vinagre (GNOME)。

其他常見問題

參考文檔

• man x11vnc 官方手冊
• x11vnc 官網
• Ubuntu 16.04/18.04/20.04 一鍵安裝腳本：one-click-vnc

添加 -capslock 參數後，遠程桌面大小寫切換即可正常工作，體驗與本地操作一致。

1. 上一篇文章： macOS 原生啟用 NTFS 讀寫支持：掛載命令、fstab 配置與 Mounty 工具
2. 下一篇文章： Eclipse 安裝 SVN 插件與 TortoiseSVN 客戶端完整指南

Java 綜合教學

Java 類別實戰：銀行帳戶系統的設計與測試

Java 類別實戰：銀行帳戶系統的設計與測試 本文透過設計一

JVM 學習筆記（一）：垃圾回收算法全景解析與 HotSpot 實踐

前言 垃圾回收 (GC) 是 Java 自動內存管理的核心支

數據可視化實戰：阿里雲公益雲圖創新大賽技術架構揭秘

項目背景 2016 年 9 月，數據秀團隊參加由阿里巴巴與國

Servlet 基础回顾：接口五大方法、生命周期与手写 HelloWorld 实战

Servlet 基础回顾：从接口到生命周期 Servlet