安裝與設定
一鍵安裝(建議)
Windows(PowerShell):
irm https://gitee.com/JIILStudio/jiilsc-web-manger/raw/master/install.ps1 | iex
Linux:
curl -fsSL https://gitee.com/JIILStudio/jiilsc-web-manger/raw/master/install.sh | bash
安裝腳本會識別平台與 CPU 架構,從發行版清單下載對應發行包並驗證,隨後啟動守護行程與面板,輸出存取位址與初始管理員帳號。
預設安裝目錄:
| 平台 | 預設目錄 |
|---|---|
| Windows | %LOCALAPPDATA%\SCWebManager |
| Linux(root) | /opt/scweb |
| Linux(一般使用者) | ~/.local/share/scweb |
腳本執行時可在預設目錄、手動輸入目錄之間選擇。安裝完成後會落地維護工具 scweb(Windows 為 scweb-manage),用於啟動面板、檢視自啟狀態、修復安裝、全新安裝、解除安裝、檢查更新與設定別名。
常用參數:
| 參數 | 說明 |
|---|---|
-1 <目錄> | 指定安裝目錄 |
-2 <版本> | 指定版本(latest 或具體版本號) |
-f | 靜默安裝,使用預設值 |
-json | 僅輸出一行 JSON 結果 |
安裝完成後在瀏覽器開啟 http://127.0.0.1:18233,使用安裝日誌中的初始帳號登入。
手動安裝(備選)
僅在一鍵腳本無法執行(離線、受限代理、舊版 PowerShell)時使用。
Windows
- 開啟發行版頁面,下載
scweb-<版本>-windows-<架構>.zip並解壓。 - 在解壓目錄執行
install.ps1,完成程式檔案安裝與啟動。 - 也可直接執行以下兩個程式(不註冊服務,關閉終端機即停止):
.\scweb-daemon.exe -dir .\data
.\scweb-panel.exe
面板會在目前目錄產生 data 與 config.json。
Linux
- 開啟發行版頁面,下載
scweb-<版本>-linux-<架構>.tar.gz並解壓。 - 在解壓目錄執行
bash install.sh,完成程式檔案安裝,並以nohup方式在背景啟動守護行程與面板。 - 也可直接執行:
./scweb-daemon -dir ./data &
./scweb-panel
防火牆與存取範圍
預設存取範圍為「僅本機」。如需區域網路存取,請在「設定 → 面板設定」中改為「允許區域網路」,並在系統防火牆中放行面板連接埠。
目錄結構
| 路徑 | 內容 |
|---|---|
config.json | 面板、守護行程與實例設定 |
data/ | 使用者、工作階段、稽核與執行資料 |
instances/ | 由面板託管的實例目錄 |
backups/ | 備份檔案 |
logs/ | 執行日誌 |
升級時請保留 config.json 與 data/,替換程式檔案即可。
連接埠
| 連接埠 | 用途 | 監聽範圍 |
|---|---|---|
18233 | 面板 HTTP | 可設定 |
18234 | 守護行程 API | 僅 127.0.0.1 |
18235 起 | 遊戲外掛 API | 僅 127.0.0.1 |
外掛連接埠被佔用時,會自動在 18235–18245 範圍內選擇空閒連接埠,並寫回設定。
升級
面板登入後會自動檢查更新,也可在「設定 → 更新管理」手動檢查;更新為整包更新,由守護行程在所有 實例停止時替換程式檔案並重啟面板。
也可以在終端機執行維護工具 scweb,選擇「檢查更新」,支援指定版本並驗證雜湊。
解除安裝
執行維護工具 scweb,選擇「解除安裝」即可移除程式檔案與自啟項目。解除安裝不會自動刪除實例與備份,請自行確認資料處置方式。