Skip to content

Latest commit

 

History

History
251 lines (172 loc) · 7.93 KB

README.md

File metadata and controls

251 lines (172 loc) · 7.93 KB
Raw

made-with-bash CodeFactor

Raspberry Pi Image Builder

Herramienta para crear imágenes Debian/Raspios arm64/armhf para Raspberry Pi 3B/3B+/4B

Pre-compiled images

Operating system | Variant | Arch | Download image url | Hash

Debian Buster | Lite | 64-bit | debian-buster-lite-arm64.img.xz | sha256

Debian Buster | Lite | 32-bit | debian-buster-lite-armhf.img.xz | sha256

Debian Bullseye | Lite | 64-bit | debian-bullseye-lite-arm64.img.xz | sha256

Debian Bullseye | Lite | 32-bit | debian-bullseye-lite-armhf.img.xz | sha256

RasPiOS Buster | Lite | 64-bit | raspios-buster-lite-arm64.img.xz | sha256

RasPiOS Buster | Lite | 32-bit | raspios-buster-lite-armhf.img.xz | sha256

RasPiOS Bullseye | Lite | 64-bit | raspios-bullseye-lite-arm64.img.xz | sha256

RasPiOS Bullseye | Lite | 32-bit | raspios-bullseye-lite-armhf.img.xz | sha256

Ver todas las imágenes

Dependencias

rpi-img-builder se ejecuta en sistemas operativos basados ​​en Debian y Ubuntu.

El script instalara automáticamente todas las dependencias necesarias.

Las dependencias necesarias son:

qemu-user-static debian-archive-keyring binfmt-support dosfstools rsync wget

lsof git parted systemd-container debootstrap xz-utils gnupg kmod udev

Configuración

Podemos establecer las variables del entorno por defecto sin modificar el script y adaptarlo a nuestras necesidades.

Las variables configurables son:

  • OS (Default: "debian")

Podemos seleccionar diferentes sistemas operativos ( Debian / Raspios).

sudo OS="raspios" ./rpi-img-builder.sh
  • RELEASE (Default: "buster")

Podemos seleccionar diferentes release entre buster y bullseye.

sudo RELEASE="bullseye" ./rpi-img-builder.sh
  • VARIANT (Default: "lite")

Puede elegir entra las variantes lite y slim con el sistema mínimo.

sudo VARIANT="slim" ./rpi-img-builder.sh
  • ARCHITECTURE (Default: "arm64")

Seleccionar arquitectura de la compilación entre arm64 y armhf.

sudo ARCHITECTURE="armhf" ./rpi-img-builder.sh
  • FSTYPE (Default: "ext4")

Seleccionar el sistema de archivos de la partición /root entre ext4 y f2fs.

sudo FSTYPE="f2fs" ./rpi-img-builder.sh # Experimental
  • NETWORK (Default: "dhcp")

Podemos definir manualmente la configuración de red.

echo 'IPV4="192.168.10.100"'     > config.txt
echo 'NETMASK="255.255.255.0"'  >> config.txt
echo 'ROUTER="192.168.10.1"'    >> config.txt
echo 'DNS="8.8.8.8"'            >> config.txt
  • WIRELESS

Configuración de nuestra red wifi.

WPA_ESSID="tu red wifi"
WPA_PASSWORD="contraseña wifi"
WPA_COUNTRY="es" # Región para España
  • COMPRESS (Default: "none" )

Podremos generar una imagen comprimidas en formato gz o xz.

sudo COMPRESS="gzip" ./rpi-img-builder.sh

sudo COMPRESS="xz" ./rpi-img-builder.sh
  • TIMEZONE (Default: "Europe/Madrid" )

Establecera la zona horaria.

sudo TIMEZONE="Europe/London" ./rpi-img-builder.sh
  • LOCALES (Default: "es_ES.UTF-8" )

Establecera locale del sistema.

sudo LOCALES="en_GB.UTF-8" ./rpi-img-builder.sh
  • ROOT_PASSWORD (Default: "raspberry" )

Establecer la contraseña a los usuarios root y pi.

sudo ROOT_PASSWORD="tupassword" ./rpi-img-builder.sh
  • HOST_NAME (Default: "rpi" )

Definir el nombre del host manualmente.

sudo HOST_NAME="rpi4b" ./rpi-img-builder.sh
  • ADDPKG (Default: "none" )

Añadir paquetes a la compilación de la imagen.

sudo ADDPKG="nano htop" ./rpi-img-builder.sh
  • BOOT_MB (Default: "136" )

Cambiar el tamaño de la partición BOOT.

sudo BOOT_MB="150" ./rpi-img-builder.sh

El uso de http proxy se habilita automáticamente si tiene instalado en su sistemas apt-cacher-ng.

Si desea deshabilitar el uso de proxy ejecute:

sudo PROXY_URL="" ./rpi-img-builder.sh

Si desea utilizar un proxy externo ejecute:

sudo PROXY_URL="http://external.proxy.loc:3142" ./rpi-img-builder.sh

Ejemplos de uso

Podremos ejecutar el script con las configuraciones por defecto ejecutando:

sudo bash <(wget -qO- https://git.io/rpi-img-builder.sh)

Si desea construir una compilación personalizada:

wget https://git.io/rpi-img-builder.sh

echo 'ARCHITECTURE="arm64"'      > config.txt
echo 'HOST_NAME="rpi3"'         >> config.txt
echo 'COMPRESS="gzip"'          >> config.txt
echo 'ROOT_PASSWORD="password"' >> config.txt
echo 'ADDPKG="nano htop"'       >> config.txt
echo 'BOOT_MB="150"'            >> config.txt
echo 'IPV4="192.168.10.100"'    >> config.txt
echo 'NETMASK="255.255.255.0"'  >> config.txt
echo 'ROUTER="192.168.10.1"'    >> config.txt
echo 'DNS="8.8.8.8"'            >> config.txt
echo 'TIMEZONE="Europe/Madrid"' >> config.txt
echo 'LOCALES="es_ES.UTF-8"'    >> config.txt

chmod +x rpi-img-builder.sh

sudo ./rpi-img-builder.sh

Contenedor de Docker para crear imágenes

wget https://git.io/rpi-images-builder.yml

docker-compose -f rpi-images-builder.yml --compatibility up -d

docker exec -it rpi-images git pull

docker exec -it rpi-images bash -c "COMPRESS=xz ./rpi-img-builder.sh"

docker cp rpi-images:/images/debian-buster-lite-arm64.img.xz .

Instalar la imagen en la Raspberry Pi

Conecte una tarjeta SD que le gustaría sobrescribir por completo en su lector de tarjetas SD.

Suponiendo que su lector de tarjetas SD proporcione el dispositivo /dev/sdX

Tenga cuidado si elige el dispositivo incorrecto, puede sobrescribir partes importantes de su sistema.

Verifique que sea correcto dispositivo!, copie la imagen en la tarjeta SD:

# Imagen comprimida en gz
gzip -c debian-buster-arm64.img.gz|sudo dd of=/dev/sdX bs=64k oflag=dsync status=progress

# Imagen comprimida en xz
xzcat debian-buster-arm64.img.xz|sudo dd of=/dev/sdX bs=64k oflag=dsync status=progress

# Imagen sin comprimir
sudo dd if=debian-buster-arm64.img of=/dev/sdX bs=64k oflag=dsync status=progress