HrnrOS

Appearance

快速入门：HrnrKitOS Nexus 服务端 ​

本教程将引导您完成 HrnrKitOS Nexus 服务端程序的安装、首次配置和基本操作，帮助您快速将平台运行起来。

步骤 1：环境准备 ​

1.1 操作系统支持 ​

本系统支持主流 Linux 发行版，安装程序会自动检测兼容性：

  • 1：Rocky Linux 8+, AlmaLinux 8+, RHEL 8+, Fedora, Ubuntu/Debian。

1.2 硬件要求 ​

  • 网络接口：建议配置 两张网卡。
    • 一张连接管理网络（SSH / 办公区访问）。
    • 一张专用于 PXE 引导目标服务器（内网）。
  • 内存：最低 8 GB（推荐 16 GB 以上以获得最佳性能）。
  • 存储（重要）：
    • 请准备一块 独立硬盘或分区（容量 ≥ 100GB），用于存储系统镜像、日志和数据库。
    • 注意：安装程序将引导您对该磁盘进行 格式化 并自动挂载到 /pxedata。

步骤 2：安装与部署 ​

不再需要手动复制文件或配置开机自启，请使用集成的安装程序。

  1. 获取安装包
    将安装包（.tar.gz）上传至服务器并解压：

    bash
    tar -zxvf hrnrkitos-nexus-v1.2.0.tar.gz
cd hrnrkitos-nexus-v1.2.0

  2. 运行安装脚本
    使用 root 权限运行安装程序：

    bash
    sudo ./install

  3. 存储配置交互
    安装过程中，程序会列出当前系统所有可用磁盘。请根据提示输入要使用的设备路径（例如 /dev/sdb）。

    ⚠️ 警告：选定的磁盘将被格式化为 ext4 文件系统，原有数据将丢失！

  4. 完成安装
    安装程序会自动完成以下操作：

    • 格式化并挂载数据盘。
    • 部署核心程序与内核文件。
    • 注册 Systemd 系统服务并设置开机自启。

步骤 3：首次访问与初始化 ​

安装完成后，服务会自动启动。您可以通过命令行查看访问信息。

3.1 查看服务状态 ​

在终端直接输入以下命令：

bash
HrnrKitOS-Nexus

或

bash
HrnrKitOS-Nexus --status

系统将显示如下信息面板：

text
============================================================
                    HrnrKit OS PXE Nexus
============================================================

 🚀 Web 管理界面已启动:
   ├─ 访问地址:        http://192.168.1.100:8080
   │  (或使用本机IP地址访问)
   ├─ 用户名:         admin
   ├─ 密码:           hrnrkit (默认密码，请登陆后修改)
   └─ PXE服务器IP:    192.168.1.100 (未配置/自动获取中)
...

3.2 登录 Web 界面 ​

  1. 打开浏览器，访问面板中提示的地址（例如 http://192.168.1.100:8080）。
  2. 输入默认账号 admin 和密码 hrnrkit 登录。

3.3 特殊情况：无 IP 地址（紧急模式） ​

如果服务器没有获取到 IP，CLI 面板会提示 未配置。此时 Web 服务会启动 紧急配置向导：

  1. 用网线将笔记本电脑 直连 到服务器网口。
  2. 笔记本电脑会自动获取一个 169.254.x.x 的临时地址。
  3. 访问服务器控制台显示的临时地址（如 http://169.254.100.100:8080）进入配置页。

步骤 4：在 Web 界面完成网络配置 ​

首次登录后，系统会自动跳转至 “网络服务配置” 页面。

  1. 选择 PXE 接口
    在网卡列表中，找到规划用于 PXE 引导的网卡。

  2. 配置静态 IP
    点击该网卡右侧的 设置（齿轮）图标：

    • IP 地址 (CIDR)：输入规划的静态 IP，例如 192.168.50.254/24。
    • 网关：如需上网可配置，纯内网环境可留空。
    • DNS：可选配置。
    • 接口标签：必须 勾选 PXE网络。
    • 点击 保存。

  3. 应用配置
    点击页面底部的 “保存并应用所有配置”。

    注意：服务会自动重启以应用新的网络设置（约需 5-10 秒）。重启后，请使用新设置的静态 IP 重新访问 Web 界面。

步骤 5：日常服务管理 ​

本系统完全通过 Systemd 托管，同时也提供了便捷的 CLI 命令。

操作目标推荐命令 (CLI 快捷方式)标准 Systemd 命令
查看状态/信息HrnrKitOS-Nexus --statussystemctl status HrnrKitOS-Nexus
停止服务HrnrKitOS-Nexus --stopsystemctl stop HrnrKitOS-Nexus
启动服务HrnrKitOS-Nexus --startsystemctl start HrnrKitOS-Nexus
重启服务HrnrKitOS-Nexus --restartsystemctl restart HrnrKitOS-Nexus

软件维护（卸载与重装） ​

如果需要升级版本或卸载软件，请再次使用安装包中的 install 工具：

  • 软件升级/修复（保留数据库和配置）：
    bash
    sudo ./install --reinstall
  • 卸载软件（保留数据盘数据）：
    bash
    sudo ./install --uninstall
  • 彻底清除（卸载并删除所有数据，慎用）：
    bash
    sudo ./install --uninstall --purge

常见问题排除 ​

现象解决建议
安装时提示 "OS not supported"请检查 /etc/os-release，确保使用的是受支持的操作系统版本（如 Rocky 8+, CentOS 7）。
安装时提示 "Disk too small"请确保选择的硬盘或分区容量 大于 100GB。
CLI 提示 "服务未运行"执行 systemctl status HrnrKitOS-Nexus 查看详细报错日志，通常是端口冲突或权限问题。
修改 IP 后无法访问服务器 IP 变更后，请确保您的管理电脑已切换到同一网段。

Copyright © 2025 HrnrKitOS