跳至主要内容

安裝與設定

一鍵安裝(建議)​

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​

  1. 開啟發行版頁面,下載 scweb-<版本>-windows-<架構>.zip 並解壓。
  2. 在解壓目錄執行 install.ps1,完成程式檔案安裝與啟動。
  3. 也可直接執行以下兩個程式(不註冊服務,關閉終端機即停止):
.\scweb-daemon.exe -dir .\data
.\scweb-panel.exe

面板會在目前目錄產生 data 與 config.json。

Linux​

  1. 開啟發行版頁面,下載 scweb-<版本>-linux-<架構>.tar.gz 並解壓。
  2. 在解壓目錄執行 bash install.sh,完成程式檔案安裝,並以 nohup 方式在背景啟動守護行程與面板。
  3. 也可直接執行:
./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,選擇「解除安裝」即可移除程式檔案與自啟項目。解除安裝不會自動刪除實例與備份,請自行確認資料處置方式。