還記得我之前分享過如何在 Windows 和 Mac 上安裝 ebook2audiobook，把電子書變成有聲書嗎？那兩支影片推出後，很多網友在底下留言詢問：「阿發，可不可以出一個 Docker 的部署教學？」

你們的聲音我都聽到了！今天這篇文章就是要來回應大家的需求，手把手教你在 Mac 跟 Windows 上使用 Docker 來安裝 ebook2audiobook。

⚠️ 安裝前重要須知 (必看！)

在使用 Docker 版本之前，有兩點關於硬體加速（GPU）的限制必須先跟各位說明，請評估後再決定要用 Docker 版還是原生版：

  1. Mac 用戶：Docker 部署是運行在 Linux 容器內，目前無法支援 Apple Silicon (M1/M2/M3) 的 MPS 加速。這意味著用 Docker 版只能靠 CPU 運算，速度會比原生安裝慢。如果你追求速度，建議參考我之前的[Mac 原生安裝教學]。
  2. Windows 用戶：最近 Docker 對於 NVIDIA 顯卡的支援有些問題（偵測不到 GPU），作者目前還在修復調整中。所以現階段在 Windows 用 Docker 部署，也暫時只能使用 CPU 模式。

簡單來說：想省事、怕環境弄亂電腦的人選 Docker；想追求極致轉檔速度的人，請選原生安裝！

準備工作：安裝 Docker

無論你是 Mac 還是 Windows，第一步都是要先安裝 Docker Desktop。

  • Mac：你可以去官網下載，或是像我一樣習慣用終端機，透過 brew 安裝。
  • Windows：直接去 Docker 官網下載安裝檔。

Mac 安裝教學 🍎

Step 1：下載專案

首先，前往 ebook2audiobook 的 GitHub 頁面（或點擊影片下方連結）下載程式碼壓縮檔，並解壓縮。我習慣把它放在「下載項目 (Downloads)」資料夾。

Step 2：執行 Docker 指令

打開你的終端機 (Terminal)：

  1. 輸入 cd Downloads 進入下載資料夾。
  2. 輸入 cd ebook2audiobook-main (或是你解壓後的資料夾名稱) 進入專案目錄。
  3. 執行部署指令：請複製專案頁面提供的 Docker 執行指令（通常以 docker run 開頭），貼上並按下 Enter。

這時候 Docker 就會開始自動下載環境並安裝，稍等它跑完。

Step 3：開啟網頁介面

當終端機顯示安裝完成並在背景執行後，打開瀏覽器輸入以下網址： http://127.0.0.1:7860

你就成功進入 ebook2audiobook 的介面啦！操作方式跟我之前介紹的一模一樣，上傳電子書就能開始轉檔了。

Windows 安裝教學 🪟

Step 1：開啟虛擬化功能

在安裝 Docker 前，請先確認 Windows 已開啟虛擬化支援：

  1. 在搜尋欄輸入「開啟或關閉 Windows 功能」。
  2. 勾選 「虛擬機器平台 (Virtual Machine Platform)」 以及 「適用於 Linux 的 Windows 子系統 (Windows Subsystem for Linux)」。
  3. 按下確定（可能需要重開機）。

Step 2：執行部署

安裝好 Docker Desktop 後：

  1. 下載並解壓縮 ebook2audiobook 專案檔（建議放在 D 槽或其他非系統槽）。
  2. 開啟「命令提示字元 (CMD)」或 PowerShell。
  3. 使用 cd 指令切換到專案資料夾。
  4. 同樣貼上專案提供的 Docker 執行指令並執行。

Step 3：開始使用

安裝完成後，同樣在瀏覽器打開 http://127.0.0.1:7860 即可使用！

如何關閉與重啟服務？

因為 Docker 是在背景執行的，如果不使用了，該怎麼關掉呢？

  • 關閉服務：在終端機輸入停止指令（通常是 docker stop <container_id> 或專案提供的 script，若在終端機前台執行直接按 Ctrl+C 即可）。
  • 重新啟動：下次要用時，不需要再重新安裝，只要輸入啟動指令（如 docker start 相關指令）即可恢復運作。

總結

雖然目前的 Docker 版本在 GPU 支援上還有點小遺憾，但對於不想處理複雜 Python 環境的朋友來說，Docker 還是一個非常乾淨、快速的選擇！希望作者能儘快修復 Windows GPU 的問題，到時候我會再更新資訊給大家。

如果今天的教學對你有幫助，歡迎在底下留言告訴我！

喜歡我的影片別忘了按讚、訂閱、分享，並開啟小鈴鐺，這樣才不會錯過最新的軟體教學喔！我是 AFA，我們下次見！👋