支援與意見回饋

1. 在 Mac 上打開「系統設定」>「一般」>「共享」。

2. 開啟「螢幕共享」。

   如果已經開啟「遠端管理」，「螢幕共享」會無法切換。這時不必另外開啟，但請在「遠端管理」的選項中確認你的帳號有「觀察」與「控制」權限；帳號沒有權限時，Mac 的回應和密碼錯誤一模一樣。

3. 按「螢幕共享」旁的資訊按鈕 ⓘ，確認允許存取的使用者包含你要登入的帳號。

4. 記下同一個畫面上顯示的位址，例如 vnc://192.168.1.20/。

5. 在 PocketDesk 中，同一個網路上的 Mac 會出現在「區域網路」裡，點「新增」即可；也可以點「新增連線」，主機填 192.168.1.20，連接埠用預設的 5900。

6. 認證方式選「macOS 帳號」（或「自動偵測」），連線時輸入這台 Mac 的使用者名稱與密碼。

以免費的 TightVNC 為例：

1. 到 TightVNC 官方網站下載 Windows 版安裝程式：tightvnc.com。

2. 執行安裝程式，選「Custom」只安裝「TightVNC Server」，或選「Typical」連同檢視器一起安裝。

3. 在「Select Additional Tasks」保留「Register TightVNC Server as a system service」與「Add exception for TightVNC to Windows Firewall」（預設已勾選）。

4. 在「Set Passwords」設定「Password for Remote Access」，這就是在 PocketDesk 輸入的 VNC 密碼（只有前 8 個字元有效）。也建議設定「Administrative Password」，避免伺服器設定被別人修改。

5. 打開「命令提示字元」執行下面的指令，記下「IPv4 位址」，例如 192.168.1.42：

   ipconfig

6. 在 PocketDesk 點「新增連線」，主機填 IPv4 位址，連接埠用預設的 5900，認證方式選「VNC 密碼」（或「自動偵測」）。

使用 UltraVNC 時，請在 UltraVNC Server 的設定中使用 VNC 密碼認證。PocketDesk 目前不支援 MS-Logon、加密外掛（DSM Plugin）與 UltraVNC Repeater。

Linux 依桌面環境使用不同的 VNC 伺服器。以下以 Ubuntu 與 Debian 為例，其他發行版請換成對應的套件管理工具。先用 hostname -I 查出電腦的 IP 位址。

分享目前螢幕上的桌面（X11）：x11vnc

1. 安裝 x11vnc：

   sudo apt install x11vnc

2. 設定 VNC 密碼（存在 ~/.vnc/passwd）：

   x11vnc -storepasswd

3. 在桌面上開啟終端機，執行：

   x11vnc -usepw -forever -shared -noncache

   -forever 讓 x11vnc 在你中斷連線後繼續執行（預設會結束）；-noncache 避免畫面下方多出一大塊快取區。

4. 在 PocketDesk 新增連線，連接埠 5900，認證方式選「VNC 密碼」。

x11vnc 只能分享 X11 桌面。使用 Wayland 的 wlroots 桌面（例如 Sway、labwc、Wayfire），請改用下面的 wayvnc。

另開一個虛擬桌面（伺服器或沒有螢幕的電腦）：TigerVNC

1. 安裝 TigerVNC（電腦需要已安裝桌面環境，例如 Xfce）：

   sudo apt install tigervnc-standalone-server

2. 設定 VNC 密碼：

   vncpasswd

3. 啟動虛擬桌面，並允許其他裝置連線：

   vncserver -localhost no :1

4. 在 PocketDesk 新增連線，連接埠填 5901（顯示編號 :1 對應 5901），認證方式選「VNC 密碼」。

Wayland 桌面：wayvnc

1. 安裝 wayvnc：

   sudo apt install wayvnc

2. 建立設定檔 ~/.config/wayvnc/config，把使用者名稱與密碼換成你自己的：

   address=0.0.0.0
   enable_auth=true
   username=你的使用者名稱
   password=你的密碼
   relax_encryption=true

   wayvnc 開啟認證後，預設只提供 PocketDesk 尚未支援的加密認證；relax_encryption=true 會改用以使用者名稱與密碼登入的方式。如果你的 wayvnc 不認得這個選項，請先更新 wayvnc。設定檔中有密碼，建議用 chmod 600 ~/.config/wayvnc/config 限制只有自己能讀取。

3. 在桌面上的終端機執行 wayvnc。

4. 在 PocketDesk 新增連線，連接埠 5900，認證方式選「自動偵測」，連線時輸入設定檔中的使用者名稱與密碼。

sudo ufw allow 5900/tcp

1. 開啟 VNC：在 Raspberry Pi 的終端機執行下面的指令，選「Interface Options」>「VNC」>「Yes」。也可以在桌面的 Raspberry Pi 設定工具中，於「Interfaces」分頁開啟 VNC。

   sudo raspi-config

2. 讓 PocketDesk 能夠登入。Raspberry Pi OS 的 VNC 伺服器預設只接受 PocketDesk 尚未支援的加密認證，請依你使用的桌面調整：

   • Wayland 桌面（Bookworm 以後的預設，伺服器為 wayvnc）：編輯設定檔，在檔案最後加上一行 relax_encryption=true，存檔後重新開機。

     sudo nano /etc/wayvnc/config

     sudo reboot

   • X11 桌面與 RealVNC Server（較舊的 Raspberry Pi OS）：在 RealVNC Server 的「Options」>「Security」中，把「Encryption」改為「Prefer off」、「Authentication」改為「VNC password」並設定 VNC 密碼；如果有「Allow connections from legacy VNC Viewers」選項，也請勾選。

3. 查出 Raspberry Pi 的 IP 位址；在同一個網路上，也可以用「主機名稱.local」，例如 raspberrypi.local。

   hostname -I

4. 在 PocketDesk 新增連線，連接埠 5900。使用 wayvnc 時認證方式選「自動偵測」，連線時輸入 Raspberry Pi 的使用者名稱與密碼；使用 RealVNC Server 時選「VNC 密碼」。

這些設定讓連線改用與其他 VNC 連線相同、不加密的方式，請只在信任的網路使用。