Caution
项目仍在活跃开发中，功能和 API 可能随版本变动。遇到问题或有建议欢迎提交 Issue。
亮点特性
- 单文件部署 — Go + React 编译为单个二进制文件，下载即用，无需安装运行时或外部依赖
- 零配置启动 — 内置 SQLite，首次运行自动生成配置，30 秒完成部署
- 容器与虚拟机 — 同时管理 Linux 容器和完整虚拟机（含 Windows），统一操作界面
- 完整计费体系 — 套餐管理、按时/按月计费、订单流程、在线支付、优惠券、流量包、库存管控
- 多节点集群 — 节点分组与集群管理，支持实例在线热迁移与 HA 自动疏散
- 主题与插件 — 前端主题可替换，功能通过插件扩展，支付/短信/邮件/认证均为插件化配置
- 在线更新 — 一键升级，自动数据库迁移，SQLite 迁移失败自动回滚
- 开放集成 — 提供 Provisioning API 和 Webhook 回调，可对接任意外部系统
快速开始
# 下载并解压（以 amd64 为例）
wget https://github.com/huohuastudio/novaix-releases/releases/latest/download/novaix_linux_amd64.tar.gz
tar -xzf novaix_linux_amd64.tar.gz
# 运行
./novaix_linux_amd64/novaix
首次启动时，程序会在当前目录自动生成默认配置文件，使用 SQLite 数据库，无需额外依赖。
| 文件名 | 架构 | 说明 |
|---|---|---|
novaix_linux_amd64.tar.gz |
x86_64 | 大多数云服务器 |
novaix_linux_arm64.tar.gz |
ARM64 | ARM 架构服务器 |
前往 Releases 下载最新版本。详细部署指南请参阅文档。
免费版与授权版
部署即用，无需注册。免费版包含核心功能，足够运营一个小型 VPS 业务。
| 限制项 | 免费版 | 授权版 |
|---|---|---|
| 节点数 | ≤ 2 | 不限 |
| HA 高可用（自动疏散） | — | ✓ |
| 告警通知 | — | ✓ |
| 私有网络（VPC） | — | ✓ |
| 代理商系统 | — | ✓ |
| 共享 IP / NAT（支持独立 IPv6） | — | ✓ |
| 纯 IPv6 套餐 | — | ✓ |
| 插件系统 | — | ✓ |
| 集成方 | — | ✓ |
前往 Spark Studio 官网 获取激活码。
技术亮点
- 语言与框架 — Go (Gin) + React (TypeScript) + TailwindCSS
- 数据库 — SQLite（默认）/ MySQL / PostgreSQL
- 部署方式 — 单二进制文件，支持 x86_64 和 ARM64
- 前端架构 — SPA 嵌入二进制，支持主题热替换
- 扩展机制 — 插件化 Provider（支付、短信、邮件、对象存储、实名认证）
- API — RESTful API，Swagger 文档，Provisioning API + Webhook
功能全览
资源管理
- 多节点接入与监控，资源统计与告警，一键连通性测试，CPU/内存/磁盘超开比率，动态内存，KSM 状态展示
- 节点分组与集群，实例在线热迁移，HA 自动疏散与维护模式，节点停用与退役迁移
- 网络向导，NAT 模式一键配置 DHCP/NAT 和共享 IP，公网模式支持桥接或路由（Proxy ARP）接入
- 容器/虚拟机全生命周期管理（创建、启停、重装、快照、批量操作）
- 基于 OVN 的 VPC 私有网络，子网划分与安全组
- IP 池管理（节点绑定、单 IP 增删、状态管理），灵活的 IP 分配与回收，支持纯 IPv6 套餐（不分配 IPv4）
- 镜像分组管理，cloud-init 开机脚本，多节点分发，自定义 ISO（含双 ISO）
- 支持 Linux 和 Windows 虚拟机，Windows 支持代理自动密码重置和网络配置，Linux VM 支持通过虚拟机代理配置网络
- NAT 共享 IP 支持固定端口段和按需选端口两种模式，端口转发自动适配 nftables/iptables
计费与销售
- 套餐管理，支持按月/季/年/小时等多种计费周期，CPU 限制（容器支持小数核心如 0.5 核），试建验证
- 流量包（叠加/重置两种模式），按套餐限制可购范围
- 完整订单流程，自动扣费与余额不足暂停，资源预检，续费价格策略（跟随套餐/锁定购买价），退款策略定制（时间窗口/流量阈值/次数限制）
- 实例转移（Push），用户间通过转移码或邮箱邀请转移实例所有权，支持收费、实名要求、管理员审批
- 库存管理，资源不足自动拦截下单
- 支付集成（支付宝/微信/Stripe/PayPal/易支付），可扩展更多渠道，支持按渠道配置手续费
- 优惠券与促销
- 发票管理（申请、审核、录入、在线查看下载）
- 代理商分组，差异化返佣与分销折扣矩阵
- 用户自助申请代理，支持自动通过或管理员审核
用户与安全
- 邮箱/手机号注册登录，多邮箱管理，TOTP 两步验证
- 实名认证（二要素 / 人脸识别），内置阿里云、腾讯云、支付宝渠道
- 后台路径自定义，增强安全性
系统能力
- 短信服务（阿里云 / 腾讯云 / 通用 HTTP）
- 邮件服务（SMTP / Mailgun / Resend）
- 多渠道通知（Telegram / 钉钉 / 企业微信 / Webhook）
- S3 兼容对象存储（镜像归档与掉盘恢复）
- 任务大屏，WebSocket 实时日志流
- 工单系统
- CMS 内容管理（公告、文章、帮助中心、FAQ 等 14 个模块，均提供公开 API）
- CLI 管理工具（密码重置、插件管理、主题切换、系统信息等）
- 系统在线更新，数据库迁移失败自动回滚
主题市场
Novaix 支持通过主题系统自定义前端界面。前端源码开源在 novaix-ui 仓库，你可以基于它开发自己的主题。
提交主题到市场
如果你开发了一个主题并希望上架到 Novaix 主题市场，请通过 PR 提交：
- 将你的主题 zip 包放到
themes/目录下（如themes/my-theme.zip） - 在
themes/index.json的themes数组中添加一条记录 - 提交 PR
主题 zip 包要求：
my-theme.zip
├── theme.json # 必需
├── screenshot.png # 建议提供（1280×800，<500KB）
└── ui/ # 必需，pnpm build 的完整产物
├── index.html
└── assets/
index.json 条目格式：
{
"id": "my-theme",
"name": "主题名称",
"version": "1.0.0",
"description": "简短描述",
"author": {"name": "作者名", "url": "https://github.com/your-name"},
"requires": "~0.2.5",
"download_url": "https://raw.githubusercontent.com/huohuastudio/novaix-releases/main/themes/my-theme.zip"
}
download_url中的文件名必须与你放到themes/目录下的 zip 文件名一致。requires字段建议使用~x.y.z约束，表示兼容该 patch 版本范围。
审核标准： 主题能正常安装和使用、theme.json 字段完整且格式正确、不包含恶意代码或外部跟踪脚本、zip 大小不超过 50MB。
联系我们
- 官网：novaix.cc
- 演示：novaix.huohuastudio.com
- 文档：docs.huohuastudio.com/novaix
- 邮箱：support@huohuastudio.com
- QQ 群：点击加入
License
Copyright © Spark Studio. All rights reserved.