# Windows 文字貼到 VirtualBox 中 Ubuntu 24.04 的完整設定步驟

本文說明如何讓 **Windows 主機**中的文字，可以複製並貼到 **VirtualBox 裡的 Ubuntu 24.04**。

適用情境：

- Windows 是主機系統
- Ubuntu 24.04 是 VirtualBox 虛擬機
- 想從 Windows 複製文字，貼到 Ubuntu
- 想在 Ubuntu Terminal、文字編輯器、瀏覽器等地方貼上文字

---

## 一、核心概念

VirtualBox 要讓 Windows 和 Ubuntu 互相複製貼上，通常需要兩件事：

1. 在 VirtualBox 裡啟用 **Shared Clipboard / 共享剪貼簿**
2. 在 Ubuntu 24.04 裡安裝 **Guest Additions**

其中：

- **Shared Clipboard** 負責開啟主機與虛擬機之間的剪貼簿功能
- **Guest Additions** 負責讓 Ubuntu 支援更完整的 VirtualBox 整合功能

---

## 二、先關閉 Ubuntu 虛擬機

建議先完整關閉 Ubuntu，不要只暫停。

在 Ubuntu 裡點：

```text
右上角電源圖示 → Power Off / 關機
```

或在 Ubuntu Terminal 執行：

```bash
sudo poweroff
```

等待 VirtualBox 中的 Ubuntu 完全關閉後，再進行下一步。

---

## 三、在 VirtualBox 啟用共享剪貼簿

在 Windows 中打開 VirtualBox 管理器。

### 步驟

1. 選取你的 Ubuntu 24.04 虛擬機
2. 點選 **Settings / 設定**
3. 進入 **General / 一般**
4. 切換到 **Function / 功能**
5. 找到 **Shared Clipboard / 共享剪貼簿**
6. 選擇：

```text
Bidirectional / 雙向
```

7. 按下 **OK**

---

## 四、Shared Clipboard 選項說明

VirtualBox 的共享剪貼簿有幾種模式：

| 選項 | 說明 |
|---|---|
| Disabled | 關閉共享剪貼簿 |
| Host to Guest | 只能從 Windows 複製到 Ubuntu |
| Guest to Host | 只能從 Ubuntu 複製到 Windows |
| Bidirectional | Windows 和 Ubuntu 可以互相複製貼上 |

建議選：

```text
Bidirectional
```

這樣 Windows 和 Ubuntu 可以雙向複製貼上。

如果你只想從 Windows 貼到 Ubuntu，也可以選：

```text
Host to Guest
```

---

## 五、啟動 Ubuntu 24.04

回到 VirtualBox 管理器，啟動 Ubuntu 24.04。

進入桌面後，開啟 Terminal。

快捷鍵通常是：

```text
Ctrl + Alt + T
```

---

## 六、安裝 Guest Additions 前的必要套件

在 Ubuntu Terminal 執行：

```bash
sudo apt update
```

接著安裝必要套件：

```bash
sudo apt install -y build-essential dkms linux-headers-$(uname -r)
```

這些套件用途如下：

| 套件 | 用途 |
|---|---|
| build-essential | 提供編譯工具 |
| dkms | 協助 VirtualBox 模組跟隨 Linux kernel 更新 |
| linux-headers-$(uname -r) | 提供目前 kernel 對應的標頭檔 |

---

## 七、插入 Guest Additions CD Image

在 Ubuntu 虛擬機視窗上方的 VirtualBox 選單中，點選：

```text
Devices / 裝置
→ Insert Guest Additions CD Image... / 插入 Guest Additions CD 映像...
```

---

## 八、安裝 Guest Additions

### 方法 1：使用自動掛載路徑

在 Ubuntu Terminal 執行：

```bash
cd /media/$USER/VBox_GAs_*
```

接著執行安裝程式：

```bash
sudo ./VBoxLinuxAdditions.run
```

等待安裝完成。

---

### 方法 2：如果找不到 `/media/$USER/VBox_GAs_*`

如果上一個方法出現類似錯誤：

```text
No such file or directory
```

可以改用手動掛載。

先建立掛載目錄：

```bash
sudo mkdir -p /mnt/cdrom
```

掛載光碟：

```bash
sudo mount /dev/cdrom /mnt/cdrom
```

進入光碟目錄：

```bash
cd /mnt/cdrom
```

執行安裝程式：

```bash
sudo sh ./VBoxLinuxAdditions.run
```

---

## 九、重新啟動 Ubuntu

Guest Additions 安裝完成後，重新啟動 Ubuntu：

```bash
sudo reboot
```

等待 Ubuntu 重新登入桌面。

---

## 十、確認共享剪貼簿是否仍為 Bidirectional

Ubuntu 開機後，在 VirtualBox 視窗上方確認：

```text
Devices / 裝置
→ Shared Clipboard / 共享剪貼簿
→ Bidirectional
```

如果不是 `Bidirectional`，請重新選一次。

---

## 十一、測試 Windows 貼到 Ubuntu

### 1. 在 Windows 中複製文字

例如在 Windows 記事本中輸入：

```text
Hello from Windows
```

選取文字後按：

```text
Ctrl + C
```

---

### 2. 貼到 Ubuntu 一般應用程式

例如貼到 Ubuntu 的文字編輯器、瀏覽器、LibreOffice 等。

通常使用：

```text
Ctrl + V
```

---

### 3. 貼到 Ubuntu Terminal

Ubuntu Terminal 裡貼上文字通常不是 `Ctrl + V`。

請使用：

```text
Ctrl + Shift + V
```

也可以用滑鼠右鍵：

```text
右鍵 → Paste / 貼上
```

---

## 十二、常見問題排查

---

## 問題 1：Windows 複製後，Ubuntu 完全貼不上

請確認 VirtualBox 的 Shared Clipboard 設定。

在 VirtualBox 虛擬機視窗上方選：

```text
Devices
→ Shared Clipboard
→ Bidirectional
```

或至少選：

```text
Host to Guest
```

---

## 問題 2：Guest Additions 好像沒有安裝成功

在 Ubuntu Terminal 執行：

```bash
lsmod | grep vbox
```

正常情況可能會看到類似：

```text
vboxguest
vboxsf
vboxvideo
```

如果完全沒有輸出，代表 Guest Additions 可能沒有正常載入。

可以重新執行：

```bash
sudo apt update
sudo apt install -y build-essential dkms linux-headers-$(uname -r)
```

然後重新安裝 Guest Additions。

---

## 問題 3：`VBoxClient --clipboard` 沒有啟動

檢查 VirtualBox clipboard client：

```bash
pgrep -a VBoxClient
```

正常可能會看到：

```text
VBoxClient --clipboard
VBoxClient --draganddrop
VBoxClient --seamless
VBoxClient --vmsvga
```

如果沒有看到：

```text
VBoxClient --clipboard
```

可以手動啟動：

```bash
VBoxClient --clipboard &
```

然後再試一次從 Windows 複製文字貼到 Ubuntu。

---

## 問題 4：貼到 Terminal 沒反應

Ubuntu Terminal 中：

```text
Ctrl + V
```

通常不是貼上。

請改用：

```text
Ctrl + Shift + V
```

或：

```text
右鍵 → Paste
```

---

## 問題 5：Ubuntu 24.04 使用 Wayland，剪貼簿異常

Ubuntu 24.04 預設可能使用 Wayland。

如果 Guest Additions 已安裝，但共享剪貼簿仍不穩定，可以改用 Xorg 登入。

### 切換到 Xorg 的步驟

1. 登出 Ubuntu
2. 回到登入畫面
3. 點選你的使用者名稱
4. 找右下角齒輪圖示
5. 選擇：

```text
Ubuntu on Xorg
```

6. 輸入密碼登入
7. 再測試共享剪貼簿

---

## 問題 6：改完設定還是不行

可以試以下順序：

1. 關閉 Ubuntu
2. 關閉 VirtualBox
3. 重新開啟 VirtualBox
4. 啟動 Ubuntu
5. 確認：

```text
Devices → Shared Clipboard → Bidirectional
```

6. 再測試貼上

---

## 十三、使用 VBoxManage 指令設定共享剪貼簿

也可以在 Windows 用指令設定。

### 1. 開啟 PowerShell 或 CMD

進入 VirtualBox 安裝目錄：

```powershell
cd "C:\Program Files\Oracle\VirtualBox"
```

---

### 2. 列出所有虛擬機名稱

```powershell
.\VBoxManage.exe list vms
```

你會看到類似：

```text
"Ubuntu 24.04" {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
```

記下虛擬機名稱，例如：

```text
Ubuntu 24.04
```

---

### 3. 設定雙向共享剪貼簿

```powershell
.\VBoxManage.exe modifyvm "Ubuntu 24.04" --clipboard bidirectional
```

---

### 4. 只允許 Windows 貼到 Ubuntu

```powershell
.\VBoxManage.exe modifyvm "Ubuntu 24.04" --clipboard hosttoguest
```

---

## 十四、完整快速流程

以下是最常用的一次完成流程。

### 1. VirtualBox 設定

在 Windows VirtualBox 中設定：

```text
Settings
→ General
→ Advanced
→ Shared Clipboard
→ Bidirectional
```

---

### 2. Ubuntu 安裝必要套件

```bash
sudo apt update
sudo apt install -y build-essential dkms linux-headers-$(uname -r)
```

---

### 3. 插入 Guest Additions

VirtualBox 選單：

```text
Devices
→ Insert Guest Additions CD Image...
```

---

### 4. 安裝 Guest Additions

```bash
cd /media/$USER/VBox_GAs_*
sudo ./VBoxLinuxAdditions.run
```

如果找不到路徑，改用：

```bash
sudo mkdir -p /mnt/cdrom
sudo mount /dev/cdrom /mnt/cdrom
cd /mnt/cdrom
sudo sh ./VBoxLinuxAdditions.run
```

---

### 5. 重新啟動

```bash
sudo reboot
```

---

### 6. 測試貼上

Windows 複製文字：

```text
Ctrl + C
```

貼到 Ubuntu 一般程式：

```text
Ctrl + V
```

貼到 Ubuntu Terminal：

```text
Ctrl + Shift + V
```

---

## 十五、建議設定

建議最後確認以下設定：

| 項目 | 建議值 |
|---|---|
| Shared Clipboard | Bidirectional |
| Drag and Drop | Bidirectional，可選 |
| Guest Additions | 已安裝 |
| Ubuntu Terminal 貼上 | Ctrl + Shift + V |
| Ubuntu 登入模式 | Xorg 較穩定，Wayland 視情況使用 |

---

## 十六、結論

要把 Windows 中的文字貼到 VirtualBox 裡的 Ubuntu 24.04，最重要的是：

1. VirtualBox 開啟：

```text
Shared Clipboard → Bidirectional
```

2. Ubuntu 安裝 Guest Additions
3. 重新啟動 Ubuntu
4. 貼到 Terminal 時使用：

```text
Ctrl + Shift + V
```

完成後，就可以從 Windows 複製文字，貼到 Ubuntu 24.04 中使用。