PXE Server - Revision history

Guilherme: /* Passo 7: Configurando o Menu Customizado */

2026-04-30T19:19:22Z

‎Passo 7: Configurando o Menu Customizado

Guilherme: /* Passo 5: Script de Automação para Imagens Windows */

2026-04-30T19:04:42Z

‎Passo 5: Script de Automação para Imagens Windows

Guilherme: /* Passo 4: Configurar o Samba (Para Boot do Windows) */

2026-04-30T19:02:15Z

‎Passo 4: Configurar o Samba (Para Boot do Windows)

Guilherme: /* Passo 3: Compilar o iPXE Customizado */

2026-04-30T18:56:21Z

‎Passo 3: Compilar o iPXE Customizado

Guilherme: /* Passo 2: Configurar o Servidor TFTP */

2026-04-30T18:54:22Z

‎Passo 2: Configurar o Servidor TFTP

Guilherme: /* Passo 1: Preparar a Estrutura Web e Baixar os Menus */

2026-04-30T18:52:33Z

‎Passo 1: Preparar a Estrutura Web e Baixar os Menus

Guilherme: /* Passo 1: Preparar a Estrutura Web e Baixar os Menus */

2026-04-30T18:48:04Z

‎Passo 1: Preparar a Estrutura Web e Baixar os Menus

Guilherme: /* Servidor PXE Local com Netboot.xyz no Debian */

2026-04-30T18:45:09Z

‎Servidor PXE Local com Netboot.xyz no Debian

Guilherme at 18:44, 30 April 2026

2026-04-30T18:44:11Z

Show changes

Guilherme: Created page with "= Servidor PXE Local com Netboot.xyz no Debian = Este guia detalha a implementação de um servidor de boot PXE local utilizando o '''netboot.xyz'''. A estrutura utiliza o Apa..."

2026-04-30T18:33:41Z

Created page with "= Servidor PXE Local com Netboot.xyz no Debian = Este guia detalha a implementação de um servidor de boot PXE local utilizando o '''netboot.xyz'''. A estrutura utiliza o Apa..."

Página nova

= Servidor PXE Local com Netboot.xyz no Debian =
Este guia detalha a implementação de um servidor de boot PXE local utilizando o '''netboot.xyz'''. A estrutura utiliza o Apache (HTTP) para transferência rápida de arquivos, TFTP para o boot inicial, Samba (SMB) para instalação automatizada do Windows e uma compilação customizada do iPXE para operar de forma 100% offline.
== Pré-requisitos ==
Antes de começar, atualize seu servidor Debian e instale todos os pacotes necessários:
<pre>
sudo apt update && sudo apt upgrade -y
sudo apt install -y apache2 tftpd-hpa samba wimtools genisoimage build-essential git liblzma-dev wget nano
</pre>
== Passo 1: Preparar o Servidor Web (Apache) e Baixar os Menus ==
Vamos criar a estrutura de pastas que vai hospedar as imagens e baixar os menus oficiais do netboot.xyz para o Apache local.
<pre>
# Criar diretórios do netboot e das categorias de imagens
sudo mkdir -p /var/www/html/netboot
sudo mkdir -p /var/www/html/assets/{Windows,Linux,Utilitarios}

# Acessar a pasta do netboot e baixar os menus
cd /var/www/html/netboot
sudo wget https://github.com/netbootxyz/netboot.xyz/releases/latest/download/netboot.xyz.tar.gz

# Extrair e limpar
sudo tar -xzf netboot.xyz.tar.gz
sudo rm netboot.xyz.tar.gz

# Ajustar permissões para o Apache
sudo chown -R www-data:www-data /var/www/html/
</pre>
== Passo 2: Configurar o Servidor TFTP ==
O TFTP é responsável por entregar os primeiros megabytes do boot. No Debian, o pacote <code>tftpd-hpa</code> utiliza o diretório <code>/srv/tftp</code> por padrão.
<pre>
# Garantir que o diretório exista
sudo mkdir -p /srv/tftp

# Reiniciar e habilitar o serviço
sudo systemctl restart tftpd-hpa
sudo systemctl enable tftpd-hpa
</pre>
== Passo 3: Compilar o iPXE Customizado ==
Para que o boot não dependa da internet, vamos compilar os arquivos de boot (EFI e BIOS) injetando um script que aponta diretamente para o IP do seu servidor Debian.
'''Atenção:''' Substitua <code>IP_DO_SEU_SERVIDOR</code> pelo endereço IP real da sua máquina Debian.
<pre>
cd ~
git clone https://github.com/ipxe/ipxe.git
cd ipxe/src

# Criar o script de redirecionamento (chainload)
cat <<EOF > boot.ipxe
#!ipxe
dhcp
chain http://IP_DO_SEU_SERVIDOR/netboot/menu.ipxe
EOF

# Compilar arquivo para máquinas antigas (Legacy/BIOS)
make bin/undionly.kpxe EMBED=boot.ipxe

# Compilar arquivo para máquinas novas (UEFI)
make bin-x86_64-efi/ipxe.efi EMBED=boot.ipxe

# Mover os arquivos gerados para o TFTP
sudo cp bin/undionly.kpxe /srv/tftp/
sudo cp bin-x86_64-efi/ipxe.efi /srv/tftp/
</pre>
== Passo 4: Configurar o Samba (Para Boot do Windows) ==
A instalação de Windows via rede exige mapeamento de disco na fase do Setup. O Samba compartilhará a pasta de arquivos do Windows.
Edite o arquivo de configuração do Samba:
<pre>
sudo nano /etc/samba/smb.conf
</pre>
Vá até o final do arquivo e adicione as seguintes linhas:
<pre>
[PXEWIN]
path = /var/www/html/assets/Windows
guest ok = yes
read only = yes
browseable = yes
</pre>
Reinicie o Samba para aplicar:
<pre>
sudo systemctl restart smbd
sudo systemctl enable smbd
</pre>
== Passo 5: Script de Automação para Extração do Windows ==
Este script extrai a ISO do Windows, baixa o injetor <code>wimboot</code> e modifica o <code>boot.wim</code> para montar o diretório Samba automaticamente e iniciar a instalação.
Crie o arquivo do script:
<pre>
cd ~
nano preparar_windows.sh
</pre>
Cole o conteúdo abaixo. '''Não se esqueça de alterar a variável IP_SERVIDOR''':
<pre>
#!/bin/bash

# ==========================================
# CONFIGURAÇÕES - ALTERE O IP ABAIXO
# ==========================================
IP_SERVIDOR="192.168.1.100"
DESTINO="/var/www/html/assets/Windows"
# ==========================================

ARQUIVO_ISO=$1
NOME_PASTA=$2
PASTA_WINDOWS="$DESTINO/$NOME_PASTA"

if [ -z "$ARQUIVO_ISO" ] || [ -z "$NOME_PASTA" ]; then
echo "Uso: sudo ./preparar_windows.sh <caminho_da_iso> <nome_da_pasta>"
echo "Exemplo: sudo ./preparar_windows.sh /home/usuario/win10.iso Win10"
exit 1
fi

echo "1. Criando pasta $PASTA_WINDOWS..."
mkdir -p "$PASTA_WINDOWS"

echo "2. Montando a ISO e copiando os arquivos..."
mkdir -p /mnt/iso_temp
mount -o loop "$ARQUIVO_ISO" /mnt/iso_temp
cp -r /mnt/iso_temp/* "$PASTA_WINDOWS/"
umount /mnt/iso_temp
rm -rf /mnt/iso_temp

echo "3. Baixando o arquivo wimboot oficial..."
if [ ! -f "$DESTINO/wimboot" ]; then
wget -qO "$DESTINO/wimboot" https://github.com/ipxe/wimboot/releases/latest/download/wimboot
fi

echo "4. Criando script de auto-conexao (startnet.cmd)..."
cat <<EOF > startnet.cmd
wpeinit
@echo Aguardando rede...
ping -n 5 127.0.0.1 >nul
@echo Conectando ao servidor $IP_SERVIDOR...
net use z: \\\\$IP_SERVIDOR\\PXEWIN\\$NOME_PASTA /user:nobody ""
z:\\setup.exe
EOF

echo "5. Injetando o script dentro do boot.wim..."
wimupdate "$PASTA_WINDOWS/sources/boot.wim" 2 <<EOF
add startnet.cmd /Windows/System32/startnet.cmd
EOF
rm startnet.cmd

echo "6. Ajustando permissoes..."
chmod -R 777 "$PASTA_WINDOWS"

echo "CONCLUIDO! Arquivos preparados com sucesso."
</pre>
Dê permissão de execução:
<pre>
chmod +x preparar_windows.sh
</pre>
'''Como usar:'''
<pre>sudo ./preparar_windows.sh /caminho/para/imagem-windows.iso Win11</pre>
== Passo 6: Preparando as Imagens Linux (Live CD) ==
Para o Linux funcionar como Live CD sem perder a conexão de rede:
Extraia a ISO do Linux (ex: Ubuntu).
Copie os arquivos <code>vmlinuz</code> (Kernel) e <code>initrd</code> (geralmente encontrados na pasta <code>casper</code> ou <code>boot</code>) para <code>/var/www/html/assets/Linux/</code>.
Copie a ISO inteira do Linux também para <code>/var/www/html/assets/Linux/ubuntu.iso</code>.
== Passo 7: Configurando o Menu Customizado ==
Edite o arquivo que gerencia o menu local do netboot:
<pre>
sudo nano /var/www/html/netboot/custom.ipxe
</pre>
Substitua tudo pelo código abaixo (altere o <code>IP_DO_SEU_SERVIDOR</code>):
<pre>
#!ipxe

# --- MENU PRINCIPAL ---
:custom_menu
clear custom_choice
menu Menu PXE Local - Debian
item --gap Selecione uma Categoria:
item menu_windows Instaladores Windows
item menu_linux Distribuicoes Linux (Live)
item menu_utils Ferramentas e Utilitarios
item --gap
item return Voltar ao Menu Anterior

choose custom_choice || goto custom_exit
goto ${custom_choice}

# --- SUBMENU WINDOWS ---
:menu_windows
clear win_choice
menu Instaladores Windows
item win11 Windows 11 (Automatizado)
item --gap
item custom_menu [ Voltar ]
choose win_choice || goto custom_menu
goto ${win_choice}

:win11
kernel http://IP_DO_SEU_SERVIDOR/assets/Windows/wimboot
initrd http://IP_DO_SEU_SERVIDOR/assets/Windows/Win11/boot/bcd bcd
initrd http://IP_DO_SEU_SERVIDOR/assets/Windows/Win11/boot/boot.sdi boot.sdi
initrd http://IP_DO_SEU_SERVIDOR/assets/Windows/Win11/sources/boot.wim boot.wim
boot || goto custom_menu

# --- SUBMENU LINUX ---
:menu_linux
clear lin_choice
menu Distribuicoes Linux
item ubuntu_live Ubuntu Live CD
item --gap
item custom_menu [ Voltar ]
choose lin_choice || goto custom_menu
goto ${lin_choice}

:ubuntu_live
kernel http://IP_DO_SEU_SERVIDOR/assets/Linux/vmlinuz
initrd http://IP_DO_SEU_SERVIDOR/assets/Linux/initrd
imgargs vmlinuz initrd=initrd ip=dhcp url=http://IP_DO_SEU_SERVIDOR/assets/Linux/ubuntu.iso
boot || goto custom_menu

# --- SUBMENU UTILITÁRIOS ---
:menu_utils
clear util_choice
menu Ferramentas e Utilitarios
item hirens Hirens BootCD PE
item --gap
item custom_menu [ Voltar ]
choose util_choice || goto custom_menu
goto ${util_choice}

:hirens
sanboot http://IP_DO_SEU_SERVIDOR/assets/Utilitarios/hirens.iso || goto custom_menu

# --- SAÍDA ---
:custom_exit
exit
</pre>
== Passo 8: Configuração do Servidor DHCP (Roteador/Firewall) ==
Para que os clientes da rede saibam onde buscar o boot, vá no seu servidor DHCP (Roteador, pfSense, Mikrotik, Windows Server) e configure as Opções de PXE:
'''Next-Server (Servidor TFTP):''' IP do seu Servidor Debian.
'''Boot Filename (Arquivo de Boot):'''
** Para máquinas UEFI: <code>ipxe.efi</code>
** Para máquinas Legacy/BIOS: <code>undionly.kpxe</code>
Acesse o Boot via Rede (F12) nos computadores clientes, entre na opção '''Custom Menu''' do painel do netboot e utilize o seu sistema de boot de forma totalmente local!

@@ Linha 196: / Linha 196: @@
 clear win_choice
 menu Instaladores Windows
-item win11 Windows 11 (Automatizado)
+item win11_25h2 Windows 11 (25H2)
 item --gap
 item custom_menu [ Voltar ]
@@ Linha 202: / Linha 202: @@
 goto ${win_choice}
-:win11
+:win11_25h2
 kernel http://pxe.franca.unesp.br/assets/Windows/wimboot
-initrd http://pxe.franca.unesp.br/assets/Windows/Win11/boot/bcd bcd
+initrd http://pxe.franca.unesp.br/assets/Windows/Win11_25H2/boot/bcd bcd
-initrd http://pxe.franca.unesp.br/assets/Windows/Win11/boot/boot.sdi boot.sdi
+initrd http://pxe.franca.unesp.br/assets/Windows/Win11_25H2/boot/boot.sdi boot.sdi
-initrd http://pxe.franca.unesp.br/assets/Windows/Win11/sources/boot.wim boot.wim
+initrd http://pxe.franca.unesp.br/assets/Windows/Win11_25H2/sources/boot.wim boot.wim
 boot || goto custom_menu
@@ Linha 214: / Linha 214: @@
 clear lin_choice
 menu Distribuicoes Linux
-item ubuntu_live Ubuntu Live CD
+item mint_live Linux Mint (Live CD)
 item --gap
 item custom_menu [ Voltar ]
@@ Linha 220: / Linha 220: @@
 goto ${lin_choice}
-:ubuntu_live
+:mint_live
 kernel http://pxe.franca.unesp.br/assets/Linux/vmlinuz
 initrd http://pxe.franca.unesp.br/assets/Linux/initrd
-imgargs vmlinuz initrd=initrd ip=dhcp url=http://pxe.franca.unesp.br/assets/Linux/ubuntu.iso
+imgargs vmlinuz initrd=initrd ip=dhcp url=http://pxe.franca.unesp.br/assets/Linux/linuxmint.iso
 boot || goto custom_menu
@@ Linha 231: / Linha 232: @@
 clear util_choice
 menu Ferramentas e Utilitarios
-item hirens Hirens BootCD PE
+item hbcd_152 Hirens Boot CD 15.2 (Versao Classica)
 item --gap
-item custom_menu[ Voltar ]
+item custom_menu [ Voltar ]
 choose util_choice || goto custom_menu
 goto ${util_choice}
-:hirens
+:hbcd_152
-sanboot http://pxe.franca.unesp.br/assets/Utilitarios/hirens.iso || goto custom_menu
+sanboot http://pxe.franca.unesp.br/assets/Utilitarios/Hiren_s.BootCD.15.2.iso || goto custom_menu
@@ Linha 245: / Linha 254: @@
 exit
 </pre>
 == Passo 8: Configuração do Servidor DHCP (Roteador/Firewall da Rede) ==
 Para que os clientes localizem o servidor de boot automaticamente na rede, configure o servidor DHCP informando:

@@ Linha 37: / Linha 37: @@
 # Acessa a pasta do netboot e baixa os menus
 cd /var/www/pxe/netboot
-wget https://github.com/netbootxyz/netboot.xyz/releases/latest/download/netboot.xyz.tar.gz
+wget https://github.com/netbootxyz/netboot.xyz/releases/latest/download/menus.tar.gz
-# Extrai e limpa o arquivo compactado
+# Extrair os arquivos (o comando tar extrai o conteúdo direto na pasta atual)
-tar -xzf netboot.xyz.tar.gz
+sudo tar -xzf menus.tar.gz
-rm netboot.xyz.tar.gz
 </pre>

@@ Linha 33: / Linha 33: @@
 <pre>
 # Cria a estrutura principal e os subdiretórios de categorias
-sudo mkdir -p /var/www/pxe/{netboot,assets/{Windows,Linux,Utilitarios}}
+mkdir -p /var/www/pxe/{netboot,assets/{Windows,Linux,Utilitarios}}
 # Acessa a pasta do netboot e baixa os menus
 cd /var/www/pxe/netboot
-sudo wget https://github.com/netbootxyz/netboot.xyz/releases/latest/download/netboot.xyz.tar.gz
+wget https://github.com/netbootxyz/netboot.xyz/releases/latest/download/netboot.xyz.tar.gz
 # Extrai e limpa o arquivo compactado
-sudo tar -xzf netboot.xyz.tar.gz
+tar -xzf netboot.xyz.tar.gz
-sudo rm netboot.xyz.tar.gz
+rm netboot.xyz.tar.gz
 # Ajusta as permissões para o Apache gerenciar os arquivos
 sudo chown -R www-data:www-data /var/www/pxe/
 </pre>
 == Passo 2: Configurar o Servidor TFTP ==
 O TFTP entrega os primeiros megabytes do boot. Utilizaremos o diretório padrão <code>/srv/tftp</code>.

@@ Linha 15: / Linha 15: @@
 <pre>
 # Libera porta HTTP (Apache)
-sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
+iptables -A INPUT -p tcp --dport 80 -j ACCEPT
 # Libera porta TFTP (Boot inicial)
-sudo iptables -A INPUT -p udp --dport 69 -j ACCEPT
+iptables -A INPUT -p udp --dport 69 -j ACCEPT
 # Libera portas do Samba (Mapeamento do Windows)
-sudo iptables -A INPUT -p tcp --dport 139 -j ACCEPT
+iptables -A INPUT -p tcp --dport 139 -j ACCEPT
-sudo iptables -A INPUT -p tcp --dport 445 -j ACCEPT
+iptables -A INPUT -p tcp --dport 445 -j ACCEPT
-sudo iptables -A INPUT -p udp --dport 137 -j ACCEPT
+iptables -A INPUT -p udp --dport 137 -j ACCEPT
-sudo iptables -A INPUT -p udp --dport 138 -j ACCEPT
+iptables -A INPUT -p udp --dport 138 -j ACCEPT
 # Salva as regras para persistirem após a reinicialização (requer iptables-persistent)
-sudo netfilter-persistent save
+netfilter-persistent save
 </pre>
 == Passo 1: Preparar a Estrutura Web e Baixar os Menus ==

@@ Linha 165: / Linha 165: @@
 </pre>
 '''Como usar:'''
-<pre>sudo ./preparar_windows.sh /caminho/para/imagem-windows.iso Win11</pre>
+<pre> ./preparar_windows.sh /caminho/para/imagem-windows.iso Win11</pre>
 == Passo 6: Preparando as Imagens Linux (Live CD) ==
 Para o Linux funcionar corretamente sem perder a conexão HTTP ao iniciar:

@@ Linha 98: / Linha 98: @@
 Após salvar, reinicie o serviço do Samba:
 <pre>
-sudo systemctl restart smbd
+systemctl restart smbd
-sudo systemctl enable smbd
+systemctl enable smbd
 </pre>
 == Passo 5: Script de Automação para Imagens Windows ==
 Abra e edite o arquivo <code>~/preparar_windows.sh</code> conforme as instruções abaixo, colando o conteúdo a seguir:

@@ Linha 82: / Linha 82: @@
 # Mover os arquivos gerados para o TFTP
-sudo cp bin/undionly.kpxe /srv/tftp/
+cp bin/undionly.kpxe /srv/tftp/
-sudo cp bin-x86_64-efi/ipxe.efi /srv/tftp/
+cp bin-x86_64-efi/ipxe.efi /srv/tftp/
 </pre>
 == Passo 4: Configurar o Samba (Para Boot do Windows) ==
 Abra e edite o arquivo <code>/etc/samba/smb.conf</code> conforme as instruções abaixo:

@@ Linha 54: / Linha 54: @@
 <pre>
 # Garante que o diretório exista
-sudo mkdir -p /srv/tftp
+mkdir -p /srv/tftp
 # Reinicia e habilita o serviço
-sudo systemctl restart tftpd-hpa
+systemctl restart tftpd-hpa
-sudo systemctl enable tftpd-hpa
+systemctl enable tftpd-hpa
 </pre>
 == Passo 3: Compilar o iPXE Customizado ==
 Para o boot offline, vamos compilar os arquivos injetando um script que aponta diretamente para o endereço web do servidor da UNESP.