目录
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
- 双击安装文件,在“用户账户控制”中点击“是”。
- 点击“I Agree”接受许可协议。
- 在“Product key”页粘贴密钥,或勾选“Enter it later on the web page”。
- 完成时可以勾选“Open the Cevix web interface”。
之后从“开始”菜单的 Cevix Gateway 文件夹打开管理界面。要删除,到 Windows 的“设置 → 应用”中卸载 Cevix Gateway。
SmartScreen 与杀毒软件
安装程序没有代码签名,Windows 会显示“Windows 已保护你的电脑”。请点击“更多信息”→“仍要运行”。
部分杀毒软件会弹出信誉警告。选择信任此程序,或把 C:\Program Files\CevixGateway 和 C:\ProgramData\CevixGateway 加入例外。安装中途被拦截时,加好例外后重新运行安装程序即可。
如果 Windows 防火墙拦截了 8443 端口,请自己添加规则。
macOS
安装文件没有 Apple 的签名和公证,第一次打开时 macOS 会提示它“来自身份不明的开发者”:
- macOS 14 及更早版本:在“访达”中右键点击文件 →“打开”→ 再点击“打开”。
- 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 # 安装最新的官方更新