本文記錄在 Mac 環境中安裝 pomelo(一個 Node.js 遊戲伺服器框架)的完整過程,目標是成功運行官方的 HelloWorld 範例。
環境:OS X 10.9.4 + Xcode 6.0
先安裝 Xcode,再安裝對應版本的 Command Line Tools。下載 Command Line Tools 需要一個 Apple 開發者帳號,沒有的話註冊一個即可。
Tip:在桌面按
command + shift + g(開啟「前往檔案夾」視窗),輸入/Library/Developer/CommandLineTools並按 Enter。若該目錄存在,代表安裝成功。
從官方網站下載安裝即可。安裝後 node 位於 /usr/local/bin/node,npm 位於 /usr/local/bin/npm。正常情況下 $PATH 中應該已包含 /usr/local/bin;若沒有,記得補上。
打開終端並切換到 root 權限:
$ sudo -i
接著輸入本機使用者密碼(即登入密碼)。然後切換到你想安裝的目錄:
$ cd /Users/apple/Documents/WorkSpace
執行安裝:
$ npm install pomelo -g
可能的錯誤
錯誤訊息:
xcrun: error: active developer path ("/Volumes/Xcode/Xcode.app/Contents/Developer") does not exist, use xcode-select to change解法:
$ sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
$ pomelo init ./HelloWorld
每次新建專案都需要安裝這兩個相依庫。
切換到專案目錄:
$ cd /private/var/root/HelloWorld
執行安裝腳本:
$ sh npm-install.sh
腳本會處理相依庫下載。若覺得下載速度慢,也可以自行下載這兩個庫手動放置。
$ cd game-server $ pomelo start
可能的錯誤
throw err; ^ Error: Cannot find module 'pomelo' at Function.Module._resolveFilename (module.js:338:15) at Function.Module._load (module.js:280:25) at Module.require (module.js:364:17) at require (module.js:380:17) at Object.<anonymous> (.../HelloWorld/game-server/app.js:1:76)解法:在
/usr/local/lib/node_modules/路徑下建立名為pomelo的資料夾。若沒有安裝相依庫也會出現同類錯誤。
另開一個終端視窗:
$ sudo -i $ cd /private/var/root/HelloWorld/web-server $ node app
啟動後會輸出一個位址,例如 https://127.0.0.1:3001/index.html。在瀏覽器中開啟它,點擊 Test Game Server,若跳出成功對話框,代表 HelloWorld 已連通。

進入 game-server 目錄後執行:
$ pomelo stop
需要提醒的是,pomelo 這個專案已多年未活躍維護,其相依的 Node.js 版本(範例中的 module.js 錯誤堆疊顯示為 Node 0.10 era)與目前主流版本差距甚大,直接在現代 Node 上安裝很可能失敗。
若你的目的是評估它作為遊戲伺服器方案,建議先確認社群活躍度與相容性;若只是要讀懂分散式遊戲伺服器的設計思路(frontend/backend 分離、session 路由、channel 廣播),pomelo 的原始碼與架構文件仍具有相當的學習價值。實作時強烈建議搭配 nvm 安裝對應的舊版 Node,避免污染系統環境。