安裝 ABM

一個容器、三個資料夾、一行指令。整個安裝就在這一頁。

尚未發行這些安裝步驟要等第一個版本推出後才能用。

資料庫是 /config 裡的一個 SQLite 檔案，所以不用另外架資料庫服務。

你需要：

有 Compose 的 Docker
一個放有聲書書庫的資料夾
下載用戶端放完成下載的資料夾
一個給 ABM 存放自己資料的資料夾

安裝

建立 compose 檔。 把這段存成 docker-compose.yml：

services:
  audiobook-manager:
    image: ghcr.io/sunbrolynk/audiobook-manager:latest
    container_name: audiobook-manager
    restart: unless-stopped
    ports:
      - "${PORT:-5173}:5173"
    environment:
      TIMEZONE: ${TIMEZONE:-UTC}
      LOCAL_NETWORKS: ${LOCAL_NETWORKS:-}
      TRUSTED_PROXIES: ${TRUSTED_PROXIES:-}
    volumes:
      - /path/to/library:/audiobooks
      - /path/to/downloads:/downloads
      - /path/to/config:/config

指向你的資料夾。 把每個 volume 左邊改成你電腦上真正的資料夾，右邊不要動。

主機路徑	容器路徑	放什麼
`/path/to/library`	`/audiobooks`	你的有聲書書庫。必填。
`/path/to/downloads`	`/downloads`	下載用戶端放完成下載的地方。必填。
`/path/to/config`	`/config`	SQLite 資料庫、備份、記錄檔、資源回收筒和自動產生的應用程式金鑰。要保留好。

啟動它。 在 compose 檔所在的資料夾執行：
終端機視窗
```
docker compose up -d
```
打開它。 前往 http://your-server:5173。第一次開啟時會帶你設定登入帳號。

第一次執行

在 compose 檔裡用 TIMEZONE 設定你的時區。接著在 Settings 裡，到 Media Management 新增根資料夾、到 Indexers 新增索引器、到 Download Clients 新增下載用戶端。環境變數和反向代理的說明在〈設定〉。

從原始碼建置

想自己建置映像檔的話，clone 這個 repo，把 image: 那一行換成 build: .，然後執行：

docker compose up -d --build

其他安裝方式

目前只能用 Docker。原生安裝方式已經在計畫中，讓 ABM 可以跑在你本來就在自架的地方：

平台	計畫的形式
Linux	原生套件和系統服務
Windows	`.exe` 安裝程式
macOS	原生 App
Kubernetes	叢集部署
Unraid	Community Apps 範本
Proxmox	LXC 安裝腳本

這些目前都還沒有。每一個推出時都會出現在〈更新〉頁面上。

更新

拉取新的映像檔，然後重新建立容器。〈更新〉頁面列出每個版本改了什麼。

有東西不對勁？

頁面打不開。 檢查 compose 檔裡的連接埠對應，然後執行 docker logs audiobook-manager。
從我的網域做的變更被拒絕。 ABM 會拒絕來自不是你連到它的那個位址的變更。先讓你的代理轉送原本的 Host 標頭。如果還是不夠，就到 Settings > General 把你的網域加進 CORS Allowed Domains（這是進階設定，所以要先打開 Show Advanced），然後重新啟動 ABM。請看〈疑難排解〉。
下載完成了卻一直沒有匯入。 檢查上面提示裡說的資料夾對應。