pxesrv

About

This repository contains code that provides a working PXE server (via HTTP, TFTP, DHCP, and/or iPXE) implemented purely in Golang.

Currently, only Linux(CentOS[6/7/8], RHEL[6/7/8], Debian and Ubuntu) which is boot from pxe is supported. See the issues page for open issues, bugs, and enhancements/improvements.

Usage

QuickStart

pxesrv uses all three services in combination. Run pxesrv with --help or -h to see what command line arguments you can pass.

The following are configs that can be passed to pxesrv when running from the command line:

# server config
global:
  ip_address: 192.168.1.61
  #doc_root: E:\ProgramData\Go\workspace\pxesrv
  doc_root: /usr/local/pxeserver/

pxe:
  listen_ip: 0.0.0.0
  http_port: 80
  http_root: netboot
  tftp_port: 69
  tftp_root: netboot
  dhcp_port: 67
  start_ip: 192.168.1.201
  end_ip: 192.168.1.220
  netmask: 255.255.255.0
  router: 192.168.1.1
  dns_server: 114.114.114.114
  #pxe_file: undionly.kpxe
  pxe_file: ipxe.pxe
  enable_ipxe: true 
  ipxe_file: menu.ipxe

How to use it

Requirements

• Redhat based OS (CentOS, Redhat Linux, Fedora...)
• Some packages: rpmbuild, zip, tar, ...

Build

git clone https://github.com/DongJeremy/pxesrv
cd pxesrv
sh build

Install

Execute the following command in CentOS7/RHEL7

rpm -ivh /tmp/dist/pxesrv-0.0.1-1.el7.x86_64.rpm
systemctl start pxesrv.service

Systemd (to start up on boot)

systemctl enable pxesrv.service

or use the following command in the console.

/usr/local/pxeserver/pxesrv -c /usr/local/pxeserver/pxe.yml

Configure

Edit the configuration file "/usr/local/pxeserver/pxe.yml"

then mount the iso file to Specific directory. for example:

mount /root/CentOS-7-x86_64-Minimal-1908.iso /usr/local/pxeserver/netboot/centos/7 -o loop

License

MIT