文档
如何部署。如何运营。 如何离开。
完整的文档——每个端点、每个受支持的镜像、每个错误代码。没有营销，没有说教。
01
创建账户
邮箱和密码。无需电话，无需证件。30 天持久会话，可在设置中撤销。
02
充值余额
将任意受支持的币种发送至一次性地址。存款确认时，我们按当时汇率记入等值美元。
03
部署你的第一台服务器
选择方案、地区和系统镜像，粘贴 SSH 密钥。开通需要 30–90 秒。
04
通过 SSH 连接
默认仅限密钥登录。使用控制台中的 IPv4 以 root 身份登录。
计费与余额
余额、充值与按日扣费模式。
| 币种 | 最低充值 | 确认数 | 通常等待时间 |
|---|---|---|---|
| Bitcoin（BTC） | $10 | 2 | 约 20 分钟 |
| Monero（XMR） | $5 | 10 | 约 20 分钟 |
| Litecoin（LTC） | $5 | 6 | 约 15 分钟 |
| Ethereum（ETH） | $15 | 30 | 约 6 分钟 |
| USDT · TRC-20 | $10 | 20 | 约 1 分钟 |
充值流程：选择币种和金额——我们会生成一次性地址并将汇率锁定 30 分钟。确认后，余额按锁定汇率入账。
每日扣费：每个 UTC 日对所有运行中的服务器按比例扣费一次。如果余额不足以支付，服务器将被标记为 suspended（暂停），并在 7 天宽限期后销毁。
服务器生命周期
部署、重启、重装、救援、销毁。
provisioning正在分配虚拟机。需要 30–90 秒。
installing正在写入系统镜像并运行 cloud-init。
running服务器已启动；SSH 可连接。
stopped已正常关机。磁盘和 IP 仍被保留并计费。
suspended余额变为负数。已关机，无法连接。7 天宽限期。
操作系统
镜像目录。
| 系列 | 版本 | 初始化 | image_id |
|---|---|---|---|
| Debian | 11 · 12 · 13 | cloud-init | debian-13-minimal |
| Ubuntu | 20.04 · 22.04 · 24.04 LTS | cloud-init | ubuntu-24.04 |
| Alpine | 3.18 · 3.19 · 3.20 | cloud-init | alpine-3.20 |
| Arch | 滚动更新 | cloud-init | arch-rolling |
| Fedora | 40 · 41 | cloud-init | fedora-41 |
| Rocky | 9（兼容 RHEL） | cloud-init | rocky-9 |
| OpenBSD | 7.5 | autoinstall | openbsd-7.5 |
| FreeBSD | 14.0 | cloud-init | freebsd-14 |
| NixOS | 24.05 | nixos-rebuild | nixos-24.05 |
| 自定义 ISO | 上传 ≤ 4 GB | 任意 | custom |
API 参考
基于 HTTPS 的 REST，JSON 输入，JSON 输出。
基础 URL https://api.noctisnode.com/v1 · Bearer 令牌认证方式 Authorization: Bearer <token>
| 方法 | 路径 | 描述 |
|---|---|---|
GET | /servers | 列出你的服务器（分页）。 |
POST | /servers | 创建服务器。返回 provisioning 状态。 |
DELETE | /servers/{id} | 销毁服务器。不可逆。 |
POST | /servers/{id}/reboot | 软重启。使用 ?hard=true 进行断电重启。 |
POST | /servers/{id}/rebuild | 从镜像重装。会清除磁盘数据。 |
POST | /servers/{id}/rescue | 启动到救援 ISO（Alpine，4 GB tmpfs）。 |
POST | /servers/{id}/rdns | 设置反向 DNS。 |
GET | /servers/{id}/metrics | 30 天 CPU/RAM/磁盘/带宽汇总。 |
GET | /images | 列出可用的系统镜像。 |
GET | /regions | 列出地区及可用性。 |
GET | /plans | 列出方案及价格。 |
POST | /billing/topup | 生成一次性充值地址。 |
GET | /billing/ledger | 交易历史。 |