# 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**: 0
- **Forks**: 1
- **Created**: 2025-03-27
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**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)

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

### 能做什么

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

### 不能做什么

- 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 等开源项目


### 测试列表


|  机型  | 架构 |     系统      | 版本 |      手动安装     |自动安装|
| :----: | :--: | :-----------: | :--: | :-------------: |:-------------: |
| VMware | x86  | Kylin Server  | V10SP3 | :white_check_mark: |:white_check_mark: |
| VMware | x86  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| KVM | x86  | Kylin Server | V10SP3 | :white_check_mark: |:white_check_mark: |
| KVM | x86  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| KVM | arm64  | Kylin Server | V10SP3 | :white_check_mark: |:white_check_mark: |
| KVM | arm64  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| KVM | arm64|openKylin-Desktop|2.0|:white_check_mark: |未测试 |
| 龙芯中科 | loongarch64 | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| 龙芯中科 | loongarch64 | Kylin Server | V10SP3 | :white_check_mark: |:white_check_mark: |
| 联想启天M425-D245 | x86  | Kylin Server | V10SP3 | :white_check_mark: |:white_check_mark: |
| 联想启天M425-D245 | x86  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| 中科W3335HA2 | C86  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| 太极P730P | loongarch64  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| 太极P730P | loongarch64  | Kylin Server | V10SP3 | :white_check_mark: |:white_check_mark: |
| 超越DT3030-L | loongarch64  | Kylin Desktop | V10SP1 | 使用带wol标记网口，兼容模式 |使用带wol标记网口，兼容模式 |
| 超越DT3030-L | loongarch64  | Kylin Server | V10SP3 | 引导失败 |引导失败 |
| 开天M70h-G1t | C86  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| 开天M70h-G1t | C86  | Kylin Server | V10SP3 | :white_check_mark: |:white_check_mark: |
| 开天M70d-G1s | loongarch64  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |
| 开天M70d-G1s | loongarch64  | Kylin Server | V10SP3 | :white_check_mark: |:white_check_mark: |
| 华为擎云W515x | arm64  | Kylin Desktop | V10SP1 | :white_check_mark: |:white_check_mark: |