NKXCLOUD 文档

深色模式

常见问题 FAQ ​

部署 ​

主控登录页点登录没反应 / 404？

这是隐藏后台路径的坑：必须从 https://console.example.com/<隐藏路径>/login 进入并提交表单（新版已修）。 如果忘了路径：sqlite3 /opt/nkxconsole/console.db "select value from settings where key='admin_path';"

只有 NAT（没有 IPv6）的机器解析不了域名？

老版本模板的 nameserver 只配了 IPv6 DNS，没有 IPv6 的机器解析不了域名。 新版已在被控配置、云模板（9000-9004）、换 IP/NAT 生成的网络配置里都加了 1.1.1.1 8.8.8.8。 已有机器可在客户机内执行（临时）：

bash
resolvectl dns eth0 1.1.1.1 8.8.8.8 && resolvectl flush-caches
一键安装脚本从哪下载程序？仓库是私有的能用吗？

脚本与二进制托管在文档站（Cloudflare Pages），私有仓库也能下载。 仓库转为公开后，可用 BIN_BASE=https://github.com/OWNER/REPO/releases/latest/download 覆盖来源。

新杜甫怎么接入？（最短路径）
  1. 装 PVE（apt install proxmox-ve）
  2. 主控 → 被控节点 → 新增（名称/IP/地区）→ 生成安装命令
  3. 杜甫上执行 curl -fsSk 'https://console.example.com/install.sh?code=XXX' | bash
  4. 回主控确认节点在线 → 建云模板（VMID 9000）→ 开卖

详见 安装被控。

节点显示离线？
  • 主控「系统设置 → 主控出口 IP」是否填了主控真实出口 IP（不是 CF 的 IP）
  • 杜甫 8443 是否放行主控 IP
  • journalctl -u nkx-panel -n 50 看被控日志
安装码失效了？

安装码一次性 + 24 小时有效。主控节点详情 → 重新生成安装命令，再执行一次即可（可重复执行）。

能不能一台服务器同时装主控和被控？

可以但不推荐（主控轮询 + 被控管理会互相影响，且源站锁 / 白名单容易配错）。建议分开。

使用 ​

客户连不上机器？
  1. 确认机器「运行中」
  2. IPv6 是否配好（客户机内 ip -6 addr），或走 NAT：公网IP:映射端口
  3. 检查「自助防火墙」是否放行了对应端口
  4. 用 VNC 进控制台排查
DD 重装系统后，换 IP / 重置密码 / 扩容都失效？

客户自行 DD 会清掉 qemu-guest-agent 和网络配置。到机器详情页：

  1. 看「客户机代理」是否显示 未就绪
  2. 点「网络修复命令」，把生成的脚本复制到 VNC 控制台 执行即可恢复
  3. 或直接用「一键重装」恢复出厂

详见机器页提示。

客户忘记密码 / 邮箱收不到验证邮件？
  • 忘记密码：登录页「忘记密码」→ 邮箱收链接（需先在账号设置里填邮箱）
  • 收不到邮件：检查财务端 SMTP 配置；也可以管理员在后台「客户管理」直接改密
支付宝支付成功但没开通？
  1. 财务端「系统设置 → 支付宝」点诊断，确认配置无误
  2. 回调地址必须是公网可访问的 https://cloud.example.com/pay/alipay/notify
  3. 看财务端日志：journalctl -u nkxweb | grep -i alipay
  4. 未开通的订单可在「订单管理」手动用余额支付
游戏服务器首次启动很慢？

首次要下载服务端文件（Minecraft 约 1-2 分钟，整合包更久），属正常。看实时日志确认进度。

想给游戏服换服务端 / 装插件？
  • 换服务端：详情页「切换服务端」（Paper/Purpur/基岩版/帕鲁…，可带 Modrinth 整合包）
  • 装插件：详情页「一键装插件」搜 Modrinth，装完自动重启
怎么给游戏服绑域名（play.example.com）？

当前版本需要客户自己在 DNS 把域名指向服务器 IP（A/AAAA），或使用 SRV 记录指向端口。反向代理功能规划中。

计费 ​

按小时怎么扣费？

每小时从余额扣一次；余额不足先提醒，欠费 3 小时后自动停机，充值后自动恢复。可在机器页看到计费方式与下次扣费时间。

自动续费什么时候扣？

到期前 3 天，余额足够就自动扣 1 个月并延长到期时间；不足则发提醒。

怎么退款？

因平台原因无法开通的订单可联系客服全额退到余额；已使用的机器按剩余天数协商。

运维 ​

怎么备份数据库？

见 升级 / 备份，建议 cron 每天备份并保留 14 天。

忘了隐藏后台路径？
bash
# 主控
sqlite3 /opt/nkxconsole/console.db "select value from settings where key='admin_path';"
# 财务端
sqlite3 /opt/nkxweb/web.db "select value from settings where key='admin_path';"
忘记管理员密码？

用二进制的内置命令重置：

bash
/opt/nkxconsole/nkxconsole reset-admin -config /opt/nkxconsole/config.json -password 新密码
/opt/nkxweb/nkxweb reset-admin -config /opt/nkxweb/config.json -password 新密码
资源水位显示 100% 了还能卖吗？

不能。任一资源（CPU/内存/硬盘）达到「物理 × 超开比例」上限后，该节点会拒绝新订单。可以：

  • 提高超开比例（管理后台 → 资源水位）
  • 加节点
  • 清理闲置机器

联系 ​

  • 仓库 Issues：NKXCLOUD-Wiki
  • 业务问题请在系统内提交工单

NKXCLOUD · 自研云服务器 / 游戏服务器管理系统

© 2026 NKXCLOUD