← 返回命令列表

Linux command

pixiecore 命令

安全

权限或系统影响较大,执行前请核对目标。

常用示例

Boot from kernel and initrd

sudo pixiecore boot [vmlinuz] [initrd.img]

Boot with kernel command-line args

sudo pixiecore boot [vmlinuz] [initrd.img] --cmdline "[console=ttyS0]"

Boot alongside an existing DHCP server

sudo pixiecore boot [vmlinuz] [initrd.img] --dhcp-no-bind

Serve boot config via external API endpoint

sudo pixiecore api [http://localhost:8080]

Listen on a specific address

sudo pixiecore boot [vmlinuz] [initrd.img] --listen-addr [192.168.1.1]

Enable debug output

sudo pixiecore boot [vmlinuz] [initrd.img] --debug

说明

pixiecore is an all-in-one network boot server that combines DHCP/ProxyDHCP, TFTP, and HTTP services into a single binary for PXE booting machines on a local network. Unlike traditional PXE setups that require configuring separate DHCP, TFTP, and boot menu services, pixiecore handles the entire boot process internally and can operate alongside an existing DHCP server without any changes to the network's DHCP configuration. The tool offers three operating modes. In static boot mode, a fixed kernel and initrd are served to all clients with the same configuration. API mode delegates boot configuration to an external HTTP service, enabling per-machine customization based on MAC address or other identifiers, which is particularly useful for large-scale provisioning. Quick mode provides ready-made presets for common Linux distributions, requiring minimal configuration to get machines booting over the network.

参数

boot _KERNEL_ _INITRD_...
Serve a static boot configuration to all clients.
api _URL_
Delegate boot configuration to an external HTTP API (per-machine config via MAC address).
--cmdline _ARGS_
Kernel command-line arguments passed to booting machines.
--listen-addr _IP_
Address to listen on (default: all interfaces).
--port _N_
HTTP port for serving boot files (default: 80).
--dhcp-no-bind
Do not bind DHCP ports; operate as ProxyDHCP alongside an existing DHCP server.
--log-timestamps
Add timestamps to log output.
--debug
Enable verbose debug output.

FAQ

What is the pixiecore command used for?

pixiecore is an all-in-one network boot server that combines DHCP/ProxyDHCP, TFTP, and HTTP services into a single binary for PXE booting machines on a local network. Unlike traditional PXE setups that require configuring separate DHCP, TFTP, and boot menu services, pixiecore handles the entire boot process internally and can operate alongside an existing DHCP server without any changes to the network's DHCP configuration. The tool offers three operating modes. In static boot mode, a fixed kernel and initrd are served to all clients with the same configuration. API mode delegates boot configuration to an external HTTP service, enabling per-machine customization based on MAC address or other identifiers, which is particularly useful for large-scale provisioning. Quick mode provides ready-made presets for common Linux distributions, requiring minimal configuration to get machines booting over the network.

How do I run a basic pixiecore example?

Run `sudo pixiecore boot [vmlinuz] [initrd.img]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does boot _KERNEL_ _INITRD_... do in pixiecore?

Serve a static boot configuration to all clients.