支持操作系统
Debian 13 / Debian 12
部署方式
Zero-Disk SSH 向导
安装阶段
4 个自动化步骤
默认版本
Lite ($0) 或 Pro / Ultra

第 1 步:准备 VPS 并确认前置条件

在启动安装程序前,请准备一台干净的 VPS/VDS(可使用您自己的云厂商,或通过 /vps 与 /cabinet 中的推荐合作伙伴购买):

  • 操作系统:纯净的 Debian 13(推荐)或 Debian 12 x86_64。请避免预装其他控制面板或存在冲突的防火墙规则。
  • 访问凭据:公网 IPv4 地址、SSH 端口(通常为 22)、用户名(root 或具备 sudo 权限的用户),以及 SSH 密码或 OpenSSH/PEM 格式私钥(-----BEGIN OPENSSH PRIVATE KEY-----)。
  • 域名(安装前可选):部署完成后,您可以直接在 Apium Cloud OS 管理面板内绑定自定义域名并签发 TLS 证书。
  • 许可证槽位(可选):如果您计划使用 Pro(最多 100 用户、完整 REST API、级联路由)或 Ultra(最多 1,000 用户),可提前在 /cabinet 购买永久槽位——也可以先免费使用 Lite(最多 25 用户)并随时升级。

第 2 步:在个人中心启动 Zero-Disk SSH 向导

登录 /cabinet(支持 2FA),选择「安装到我的服务器」并填写部署表单:

  • 填写服务器的 IP / 主机名、SSH 端口与 SSH 用户名。
  • 选择认证方式:SSH 密码或SSH 私钥。凭据仅在当前 SSH 会话期间严格驻留于内存中,绝不会写入磁盘(Zero-Disk 架构)。
  • 可选择未绑定的付费许可证槽位(Pro 或 Ultra)在部署期间自动绑定,或保留默认的 Lite。
  • 点击「在服务器上安装 Apium Cloud OS」并观察实时进度控制台。

第 3 步:4 个自动化安装阶段

部署过程中服务器上的执行细节

自动化流水线

向导会在您的目标 Debian 服务器上依次执行四个确定性阶段,并将实时日志流式传输至个人中心。

阶段标识符在目标 VPS 上执行的操作
阶段 1SSH Preflight & OS Check验证 SSH 连通性、root/sudo 权限、Debian 12/13 兼容性及可用系统资源。
阶段 2Prepare Apium Cloud OS Environment配置软件源、安装系统依赖、调优内核网络参数并准备隔离目录。
阶段 3Bootstrap Runtime & Panel部署 Rust 控制守护进程、systemd 服务、Xray/Hysteria2/accel-ppp/strongSwan 引擎、nftables 规则,并在已选时绑定许可证。
阶段 4Health & Readiness Verification对核心守护进程执行健康检查,并输出一次性面板 URL、管理员用户名与临时密码。

第 4 步:首次登录与面板初始化配置

阶段 4 完成后,请保存向导输出的一次性凭据并打开您的管理控制台 URL:

  • 1. 加固管理员账号:使用临时凭据登录并立即修改管理员密码。
  • 2. 选择运行模式:保留 Cascade VPN 用于多协议上网与上游中继路由,或启用 Corporate Gateway 以获得独立数据库、X.509 CA、AD/RADIUS 与网段 ACL。
  • 3. 配置域名与协议:将 DNS A 记录指向 VPS IP,在面板设置中绑定域名以启用 TLS(Windows SSTP / HTTPS 控制台),并开启所需协议(VLESS Reality、Hysteria 2、Windows SSTP、L2TP/IPsec)。
  • 4. 设置防火墙与整形策略:选择 nftables 等级(Basic、Restricted 或用于阻断 P2P/SMTP 的 Paranoid),并为不同分组配置 tc 带宽上限。

第 5 步:许可证管理、导入与迁移

  • 通过向导自动绑定:在第 2 步中选择的许可证会在阶段 3 自动在节点上激活。
  • 手动导入(独立服务器):从管理面板顶部复制服务器标识符,在个人中心生成 license.key 并导入面板。
  • 一键迁移 VPS:更换新服务器时,在个人中心点击「从服务器解绑」即可吊销旧绑定,并在新 VPS 上复用您的永久槽位。

第 6 步:安装后核查清单

技术健康检查

  • 确认 Apium 仪表盘上所有需要的隧道服务均显示 ONLINE(MS-SSTP、L2TP、strongSwan、sing-box/Xray)。
  • 验证实时 CPU、内存与通道负载遥测数据正在正常刷新。

客户端与路由验证

  • 创建一个测试账号,检查配额与限速策略,并使用目标客户端(代理应用、Windows SSTP 或 MikroTik/Keenetic)测试连通性。
  • 若启用了 Upstream Relay,请确认面向多国出口节点的 15 秒健康探测均正常通过。