目錄
Docs / 說明文件 / 02
安裝
Windows、macOS 和 Linux 都有安裝程式。同一個安裝程式可以全新安裝,也可以從 1.x 升級。任何一步失敗,它都會還原。
選擇安裝檔
安裝檔從你取得 Cevix 的地方下載,或向賣家索取。選和你的系統、CPU 相同的檔案:一般 PC 和 Intel Mac 選 amd64;Apple 晶片的 Mac、樹莓派、Armbian 板子和 410 隨身棒選 arm64。
| 系統 | 安裝檔 |
|---|---|
| Windows | CevixSetup-…-windows-….exe |
| macOS | Cevix-…-macos-….pkg |
| Debian、Ubuntu、Raspberry Pi OS、Armbian | cevix-gateway_…_….deb |
| 其他 Linux | cevix-setup-…-linux-… |
裝好後,用瀏覽器打開 https://<這台機器的位址>:8443。在同一台機器上,是 https://localhost:8443。第一次瀏覽器會警告憑證,確認是你的機器後繼續。接著看第一次設定。
Windows
- 雙擊安裝檔,在使用者帳戶控制按「是」。
- 按「我同意」接受授權條款。
- 在「產品金鑰」頁貼上金鑰,或勾選「稍後在網頁輸入」。
- 完成時可以勾選「打開 Cevix 管理介面」。
之後從「開始」功能表的 Cevix Gateway 打開管理介面。要移除,到 Windows 的「設定 → 應用程式」解除安裝 Cevix Gateway。
SmartScreen 與防毒軟體
安裝程式沒有程式碼簽章,Windows 會顯示「Windows 已保護您的電腦」。按「其他資訊」→「仍要執行」。
有些防毒軟體會跳出信譽警告。選「信任此程式」,或把 C:\Program Files\CevixGateway 和 C:\ProgramData\CevixGateway 加入例外。安裝被擋到一半時,加好例外再執行一次安裝程式即可。
Windows 防火牆若擋了 8443 埠,請自己加規則。
macOS
安裝檔沒有 Apple 的簽章和公證,第一次 macOS 會說它「來自未識別的開發者」:
- macOS 14 以前:在 Finder 對檔案按右鍵 →「打開」→ 再按「打開」。
- macOS 15 以後:先雙擊一次並關掉警告。到「系統設定 → 隱私權與安全性」最下方按「仍要打開」,輸入密碼。
接著按「安裝」並輸入密碼。裝好後,瀏覽器會自動打開管理介面。
Linux
Debian 套件(建議)
適用 Debian 12 以上、Ubuntu 22.04 以上、Raspberry Pi OS 和 Armbian:
sudo apt install ./cevix-gateway_<版本>_<CPU>.deb
前面的 ./ 不能省。安裝時會問產品金鑰,留空就之後在網頁輸入。
sudo apt remove cevix-gateway:移除程式,資料保留。sudo apt purge cevix-gateway:連資料一起刪除,無法復原。
其他 Linux
chmod +x cevix-setup-<版本>-linux-<CPU>
sudo ./cevix-setup-<版本>-linux-<CPU>
410 隨身棒與小型板子
- 選 arm64 的檔案。
- 不要加 swap:會磨損內建的儲存空間。
- 保留 Wi-Fi 和 ModemManager。
- 記憶體少,不要同時開太多代理出口,見網路出口。
裝好後馬上登入
建立管理員之前,任何連得到這台機器的人都能建立管理員帳號。裝好後請立刻完成第一次設定。
從 1.x 升級
從 1.x 升到 2.0,請用安裝程式。不要在 1.x 的網頁上傳 2.0 的更新包,那會顯示「簽章不符」。
- 需要 1.3.6 以上。更舊的版本,請先在 1.x 裡升到 1.3.6。
- 管理員帳號、線路、設定、簡訊、通話紀錄和授權都會搬過來。手機 App 不需要重新配對。
- 升級時線路會離線一陣子,請預留 15 分鐘。建議先備份。
- 升級失敗時,安裝程式會放回舊版。
裝好 2.0 之後,之後的更新在網頁上就能完成,見更新與備份。
好用的指令
在 Linux 和 macOS 的終端機,或 Windows 以系統管理員身分開的命令提示字元:
cevix status # 版本、服務是否在執行、網址
cevix open # 用瀏覽器打開管理介面
sudo cevix restart # 重新啟動(也有 start、stop)
sudo cevix update apply # 安裝最新的官方更新