# mpxe

**Repository Path**: misstar/mpxe

## Basic Information

- **Project Name**: mpxe
- **Description**: 云刻：全架构信创PXE搭建工具，一键启动支持x86/arm/loongarch架构的PXE服务器。无需繁琐配置，只需将镜像放置在iso目录，即可一键启动支持无人值守、多镜像共存的PXE服务器。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: http://mpxe.misstar.com
- **GVP Project**: No

## Statistics

- **Stars**: 16
- **Forks**: 4
- **Created**: 2025-03-27
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: os

**Tags**: None

## README

### 是什么

云刻是一个针对信创环境的一键PXE安装环境。兼容c86、arm64、loogarch64架构。纯python实现http、dhcp、tftp服务，搭配系统nfs服务。通过网络引导给桌面终端和服务器安装操作系统。

#### 效果图

![Image1](https://gitee.com/misstar/mpxe/raw/main/netboot/web/static/images/1.png)

![Image3](https://gitee.com/misstar/mpxe/raw/main/netboot/web/static/images/3.png)

![Image4](https://gitee.com/misstar/mpxe/raw/main/netboot/web/static/images/4.png)

![Image2](https://gitee.com/misstar/mpxe/raw/main/netboot/web/static/images/2.png)

### 功能列表

| 功能 | 说明 |
| ---- | ---- |
| **多架构PXE引导** | 支持 x86_64、ARM64、LoongArch64 架构的网络引导 |
| **多镜像管理** | 支持同时配置多个ISO镜像，通过Web界面切换选择 |
| **无人值守安装** | 支持自动应答文件（Preseed/Kickstart），实现全程自动安装 |
| **安装进度监控** | 实时监控客户端安装进度和状态 |
| **外挂文件** | 支持附加外部文件到镜像，满足自定义需求 |
| **NFS网络启动** | 通过NFS服务提供镜像文件，支持大文件高效传输 |
| **DHCP黑白名单** | 可配置MAC地址黑白名单，控制客户端访问权限 |
| **HTTP端口修改** | 支持自定义HTTP服务端口 |
| **日志查看** | Web界面实时查看服务运行日志 |
| **多系统兼容** | 兼容银河麒麟、OpenEuler、CentOS、Anolis、Deepin、UOS等国产系统 |

### 能做什么

- 国产操作系统批量安装
- 多架构多镜像选择支持
- 无人值守自动安装

### 不能做什么

- windows系统安装
- 龙芯3A3000/4000等mips架构系统安装

### 怎么用

#### 获取安装包

> 云刻只支持Linux系统环境，要求已安装python3。
> 银河麒麟桌面和服务器操作系统内置Python，可下载直接运行。

- 网页[下载](https://gitee.com/misstar/mpxe/releases/latest)并解压工具包。

#### 解压并复制镜像

-下载之后解压，解压之后目录结果如下：

```
├── config
├── iso
├── LICENSE.md
├── logs
├── mpxe.desktop
├── netboot
├── README.md
├── run.py
├── scripts
├── services
└── tasklist.md
```

- 复制系统镜像到iso目录，也可以使用`ln -s`命令从其他目录软链接过来。
#### 安装nfs服务

mPXE依赖系统自带nfs服务，启动服务前需要安装好nfs服务。安装即可，不需要配置和手动起服务。
服务器：

> sudo yum install nfs-utils

桌面系统：

> sudo apt install nfs-kernel-server

#### 启动服务

##### 图形化环境

双击`云刻-信创PXE`图标，按提示输入管理员密码。

##### 命令行环境

cd到解压出来的文件夹，执行命令：`sudo python3 run.py`

#### 检查服务

浏览器输入`http://ip/`打开管理页面，检查服务状态。

### 注意事项

#### 关闭自动睡眠

设置-电源-此段时间后系统进入睡眠-永不

#### 关闭防火墙

> 网络部署需关闭mpxe服务端防火墙或开放相关端口。

##### 银河麒麟桌面操作系统

关闭安全中心-应用保护
关闭安全中心-网络保护

##### 银河麒麟服务器系统

关闭防火墙服务：`systemctl disabled firewalld --now`

#### 开放端口
| 端口 | 协议 | 用途               |
| ---- | ---- | ------------------ |
| 80   | tcp  | http服务、管理页面 |
|  67	|udp|dhcp服务|
| 69| udp | tftp服务|
|111,2049|tcp|nfs服务|

### 常见问题
#### Q:桌面无人值守安装过程中设置账号密码
> 在grub配置中autoinstall所在选项的linux开头行的oem-config/enable=true

#### Q:服务器无人值守安装自动分区失败
> anaconda默认不会自动格式化盘，需要修改配置中的clearpart --none --initlabel为clearpart --all --initlabel

### 加入内测/问题反馈/意见建议

Q群：390480890

### 致谢
ipxe/pypxe/grub/uefi 等开源项目


### 测试列表


|  系统  |   版本 |      手动安装     |自动安装| 安装进度|外挂文件|
| :----: |  :-----------: | :--: | :-------------: |:-------------: |:----:|
|银河麒麟桌面|V10/V10SP1/V11|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|
|银河麒麟服务器|V10SP1/SP2/SP3/SP3-2403/V11|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|
|OpenEuler|22/24|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|
|Centos|7/8|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|
|龙蜥|8.9|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|
|凝思|6_el22|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|
|deepin|25|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|
|UOS桌面|1060/1070|:white_check_mark:|:x:|:x:|:white_check_mark:|
|UOS服务器|1070|:white_check_mark:|:white_check_mark:|:white_check_mark:|:white_check_mark:|