====== 安裝 AirSonic 音樂串流服務 ======
  * 安裝環境 :
    * VM : 2vCore / 4GRAM / 32GSSD
    * OS : Alpine 3 參考 - [[tech/alpine_docker]]

===== 安裝程序 =====
  * 建立相關資料目錄 <cli>
mkdir -p /airsonic/data
mkdir -p /airsonic/music
mkdir -p /airsonic/playlists
mkdir -p /airsonic/podcasts
chmod a+w /airsonic/data
chmod a+w /airsonic/playlists
chmod a+w /airsonic/podcasts
</cli>
  * 將 NAS 內的 mp3 目錄掛上 /airsonic/music <cli>
apk add cifs-utils
cat <<EOF | tee /root/.smb > /dev/null
username=jonathan
password=xxxxxxx
EOF
chmod 600 /root/.smb
</cli>
  * 驗證 /airsonic/music 掛載 NAS 的路徑, Exp. <cli>
pve-airsonic:~# mount -t cifs -o credentials=/root/.smb //192.168.11.246/mp3 /airsonic/music
pve-airsonic:~# df -h | grep airsonic
//192.168.11.246/mp3      4.5T    270.1G      4.2T   6% /airsonic/music
</cli>
  * 編輯 /etc/fstab 定義 /airsonic/music 掛載, Exp. <file>
:
//192.168.11.246/mp3    /airsonic/music cifs    credentials=/root/.smb  0 0
:
</file>
  * 設定開機自動掛載 <cli>
rc-update add netmount boot
</cli>
  * 使用非 root 身分來建立
    * docker-compose.yml <file>
version: "3"
services:
  airsonic:
    image: airsonic/airsonic:latest
    user: 1000:1000 # should be owner of volumes
    ports:
      - "4040:4040"
    restart: unless-stopped
    volumes:
      - "/airsonic/data:/airsonic/data"
      - "/airsonic/music:/airsonic/music"
      - "/airsonic/playlists:/airsonic/playlists"
      - "/airsonic/podcasts:/airsonic/podcasts"
</file>
    * 啟動 airsonic <cli>
docker compose up -d
</cli>

===== 在手機上安裝 Subsonic APP =====
  * 因為 AirSonice 有提供與 SubSonic 相同的 API, 因此可以直接輸入帳號密碼與網址就可使用
  * {{:tech:screenshot_20230204-173110.jpg?400|}} {{:tech:screenshot_20230204-173053.jpg?400|}}
===== FAQ =====
==== 1 使用 Nginx Proxy Manager(Reverse Proxy) 用 https 無法出現部分頁面問題 ====
  * 參考 - https://airsonic.github.io/docs/proxy/prerequisites/
  * 在 /airsonic/data/airsonic.properties 內加入 server.use-forward-headers=true <file>
:
server.use-forward-headers=true
:
</file>
  * 重新啟動 airsonic 讓設定生效 <cli>
docker-compose restart
</cli>

==== 2 部分檔案無法被掃描出來問題 ====
  * 可以透過 [[https://www.mediamonkey.com/download|MediaMonkey]] 對音樂檔案檔名進行批次修正即可再次掃描呈現出來

==== 3 ID Tag 的中文亂碼修正工具 ====
  * 如果在 AirSonic 內看到類似以下這樣的編碼錯亂問題, 透過 [[https://www.mp3tag.de/en/download.html|Mp3tag]] 讀取後如果可以正常呈現, 由 Mp3tag 寫入即可解決
  * {{:tech:2023-02-04_174120.png?600|}}

===== 參考網址 =====
  * https://airsonic.github.io/docs/install/docker/
  * https://airsonic.github.io/docs/apps/
  * https://techoverflow.net/2021/07/06/how-to-automount-cifs-smb-on-alpine-linux/

{{tag>mp3 mediaplayer}}