RomM 遊戲管理器

第一部分：介紹大綱

RomM (Rom Manager) 是一個現代化的復古遊戲庫管理工具。它不只能整理遊戲檔案，還支援透過瀏覽器直接遊玩，就像是你的「私人復古遊戲 Netflix」。

運作原理：Server 端 (NAS) 負責掃描檔案與資料庫；Client 端 (瀏覽器) 負責顯示介面並利用電腦算力運行模擬器。

第二部分：如何架設 (Docker 部署)

本教學基於 Docker Compose，適用於 fnOS 或 Portainer 環境。

步驟 1：規劃資料夾結構

在 Docker 儲存空間下 (例如 /vol1/docker/) 建立 romm 資料夾，並在其下建立 5 個子資料夾：

• /romm/library/ (存放遊戲 ROM)
• /romm/config/ (存放設定檔)
• /romm/assets/ (存放資源)
• /romm/resources/ (存放圖片)
• /romm/database/ (存放資料庫數據)

步驟 2：準備 config.yml

在電腦上建立一個文字檔 config.yml，內容填入 version: 1 即可。將此檔案上傳至 NAS 的 /romm/config/ 資料夾中。
※重要：若無此檔案容器會啟動失敗。

步驟 3：建立 Docker Compose 堆疊

複製以下內容至 Docker Compose 編輯器：

version: "3"
services:
  romm:
    image: rommapp/romm:latest
    container_name: romm
    restart: unless-stopped
    environment:
      - DB_HOST=romm-db
      - DB_NAME=romm
      - DB_USER=romm-user
      - DB_PASSWD=password123  # 請自訂密碼
      - ROMM_AUTH_SECRET_KEY=random_key_here # 請輸入隨意亂碼
    volumes:
      - /vol1/docker/romm/resources:/romm/resources
      - /vol1/docker/romm/assets:/romm/assets
      - /vol1/docker/romm/config:/romm/config
      - /vol1/docker/romm/library:/romm/library
    ports:
      - 8080:8080
    depends_on:
      - romm-db

  romm-db:
    image: mariadb:10
    container_name: romm-db
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass # 請自訂 Root 密碼
      - MYSQL_DATABASE=romm
      - MYSQL_USER=romm-user
      - MYSQL_PASSWORD=password123 # 需與上方 DB_PASSWD 一致
    volumes:
      - /vol1/docker/romm/database:/var/lib/mysql

步驟 4：初始化設定

1. 啟動容器。
2. 瀏覽器訪問 http://NAS_IP:8080。
3. 建立管理員帳號 (Username/Password)。
4. (可選) IGDB API Key 設定可先跳過，稍後再補。

第三部分：下載與整理遊戲庫

1. 資源與格式

• 關鍵字：搜尋 "No-Intro" (卡帶類) 或 "Redump" (光碟類)。推薦來源：Internet Archive。
• 格式：卡帶類 (NES, GBA) 可直接使用 .zip 或 .7z (無需解壓)。若模擬器讀取失敗，才需解壓為原生格式 (如 .nes)。

2. 排除雜訊

下載的遊戲包通常包含 0-9, A, B 等分類資料夾。建議將這些資料夾內的遊戲檔案全部移出來，放在 roms 根目錄下，避免 RomM 將「A資料夾」誤判為一個遊戲。

第四部分：搜尋與掃描

1. 綁定路徑 (Manage Library)

由於 Docker 的隔離性，你需要告訴 RomM 哪個資料夾對應哪個主機。

1. 進入網頁 -> 點擊 MANAGE LIBRARY。
2. 點擊 Add 或 Edit。
3. 左側 (Folder)：選擇 nes (你建立的資料夾名)。
4. 右側 (Platform)：選擇 Nintendo Entertainment System。
5. 點擊 Confirm。

2. 執行掃描與遊玩

• 點擊左側選單的 Scan 圖示 -> Scan Library。
• 掃描完成後，點擊封面 -> 點擊 Play 即可開始遊戲。
• 操作鍵：方向鍵移動，Enter (Start)，Shift (Select)，Z/X/A/S 為功能鍵。

第五部分：疑難排解 (Troubleshooting)

問題現象	原因分析	解決方案
掃描不到遊戲	資料夾結構錯誤 或 權限不足	1. 確認遊戲是否在 roms 子資料夾內。 2. 在 NAS 開啟資料夾的遞歸讀寫權限。
封面顯示 "Not Identified"	未設定 IGDB API Key	這不影響遊玩。若需封面，需至 Twitch Developer 申請 API 並填入設定。
出現 "0-9", "A" 等奇怪遊戲	RomM 把分類資料夾當成遊戲了	將遊戲移出至 roms 根目錄，刪除空資料夾。
點 Play 後黑屏	瀏覽器無法解壓該 .7z 檔案	將該遊戲解壓縮，上傳原生格式 (.nes, .gba) 即可解決。
無法重複綁定資料夾	一個資料夾對應一個平台	這是正常機制。請為每個平台建立獨立資料夾。