在 Docker 中為 Brother DCP-T310 安裝 CUPS 驅動程序

本指南將引導您如何在 Docker 容器中設定 CUPS 服務，並為 Brother DCP-T310 多功能印表機安裝驅動程序。由於 Brother DCP-T310 沒有官方的 64 位 Linux 驅動程序，我們將利用 Brother 官方提供的安裝腳本來解決此問題。

必要條件：

• 已安裝 Docker 和 Portainer (或 Docker CLI)。
• Brother DCP-T310 印表機已連接到您的主機。

---

步驟 1：部署 CUPS Docker 容器

我們將使用 olbat/cupsd 映像來創建 CUPS 服務容器。

使用 Portainer 部署 (推薦)：

1. 登入您的 Portainer 儀表板。
2. 導航到 "Containers" (容器) -> "Add container" (添加容器)。
3. Image (映像): 輸入 olbat/cupsd
4. Name (名稱): 輸入 cupsd (或其他您喜歡的名稱)
5. Port mappings (端口映射):
   • 將 631 (Host) 映射到 631 (Container)。這將允許您通過主機的 631 端口訪問 CUPS 網頁介面。
6. Volumes (儲存卷):
   • Bind (綁定): 將 /var/run/dbus (Host) 映射到 /var/run/dbus (Container)。這是為了讓 CUPS 能與主機的 D-Bus 系統通信，尤其對於 USB 設備管理很重要。
   • Bind (綁定): 將 /dev/bus/usb (Host) 映射到 /dev/bus/usb (Container)。這一步至關重要，它允許容器直接訪問主機的 USB 設備，包括您的印表機。
7. Runtime & Resources (運行時與資源):
   • 勾選 "Privileged mode" (特權模式)。由於容器需要直接訪問 USB 設備和底層系統資源，特權模式是必需的。

使用 Docker CLI 部署：

在您的終端機中運行以下命令：

Bash

docker run -d \
  -p 631:631 \
  -v /var/run/dbus:/var/run/dbus \
  -v /dev/bus/usb:/dev/bus/usb \
  --name cupsd \
  --privileged \
  olbat/cupsd

---

步驟 2：在 CUPS 容器內安裝 Brother DCP-T310 驅動程序

由於 Brother DCP-T310 沒有現成的 64 位驅動程序，我們需要進入容器內部，執行 Brother 官方提供的安裝腳本。

1. 進入 CUPS 容器的 Shell：

   • 使用 Portainer： 導航到 "Containers" (容器)，找到您的 cupsd 容器，點擊其名稱，然後點擊 "Console" (控制台) 或 "Exec console" (執行控制台)，選擇 sh 或 bash。
   • 使用 Docker CLI：
     Bash

     docker exec -it cupsd bash
     

2. 下載並運行 Brother 印表機安裝程序： 在容器的 Shell 內，依序執行以下命令：

   Bash

   # 下載 Brother 官方安裝腳本
   wget https://download.brother.com/welcome/dlf006893/linux-brprinter-installer-2.2.3-1.gz
   
   # 解壓縮
   gzip -d linux-brprinter-installer-2.2.3-1.gz
   
   # 賦予執行權限並運行安裝腳本
   # 當腳本提示您輸入印表機名稱時，輸入 "DCP-T310"
   bash linux-brprinter-installer-2.2.3-1 DCP-T310
   

   注意：

   • 安裝腳本會引導您完成安裝過程。當提示您選擇印表機型號時，請確認輸入 DCP-T310。
   • 腳本可能會詢問您是否要安裝相關依賴、配置網路等，請根據提示操作。通常，對於 USB 連接，您可能需要選擇 USB 或自動檢測選項。

3. 退出容器 Shell： 完成驅動程序安裝後，輸入 exit 退出容器的 Shell。

---

步驟 3：在 CUPS 伺服器中添加印表機

現在驅動程序已經安裝在容器中，您可以通過 CUPS 網頁介面添加您的印表機。

1. 訪問 CUPS 網頁介面： 在您的網頁瀏覽器中打開 http://127.0.0.1:631 (如果您的 Docker 主機 IP 地址不是 127.0.0.1，請替換為實際 IP)。

2. 登入 CUPS 介面： 點擊 "Administration" (管理)。當要求輸入使用者名和密碼時：

   • 使用者名稱： print
   • 密碼： print

3. 添加印表機： 在 "Administration" 頁面下，點擊 "Printers" (印表機) 部分的 "Add Printer" (添加印表機)。

   • CUPS 應該會自動檢測到通過 USB 連接的 Brother DCP-T310。選擇它並繼續。
   • 按照提示命名您的印表機，添加描述和位置。
   • 在驅動程序選擇步驟，CUPS 應該會推薦已安裝的 Brother DCP-T310 驅動程序。選擇它並完成設置。

---

完成這些步驟後，您的 Brother DCP-T310 印表機應該就能通過 CUPS 伺服器（運行在 Docker 容器中）正常工作了。您可以嘗試列印測試頁來確認其功能。