/debi

Reinstall your VPS to minimal Debian

Primary LanguageShellThe UnlicenseUnlicense

Debian Network Reinstall Script

中文说明 ↓

Introduction

This script is written to reinstall VPS/VMs to minimal Debian.

Platforms

  • ✔ KVM or physical machines ❌ Containers
  • ✔ Debian or Ubuntu or Red Hat Linux as original OS with GRUB 2 bootloader
  • ✔ MBR or GPT partition table
  • ✔ Multiple disks or LVM
  • ✔ IPv4 or IPv6
  • ✔ Legacy BIOS or UEFI boot
  • ✔ Most VPS or cloud providers
  • ⚠️ Google Compute Engine - MUST manually specify IP/CIDR and gateway of VPC
  • ⚠️ AWS EC2 or Lightsail - Does NOT work with UEFI boot

How It Works

  1. Generate a preseed file to automate installation
  2. Download the 'Debian-Installer' to the /boot directory
  3. Append a menu entry of the installer to the GRUB2 configuration file

Usage

1. Download

Download the script with curl:

curl -fLO https://raw.githubusercontent.com/bohanyang/debi/master/debi.sh

or wget:

wget -O debi.sh https://raw.githubusercontent.com/bohanyang/debi/master/debi.sh

2. Run

Run the script under root or using sudo:

chmod a+rx debi.sh
sudo ./debi.sh

By default, an admin user debian with sudo privilege will be created during the installation. Use --user root if you prefer.

3. Reboot

If everything looks good, reboot the machine:

sudo shutdown -r now

Otherwise, you can run this command to revert all changes made by the script:

sudo rm -rf debi.sh /etc/default/grub.d/zz-debi.cfg /boot/debian-* && { sudo update-grub || sudo grub2-mkconfig -o /boot/grub2/grub.cfg; }

Available Options

Presets

Region Alias Mirror DNS NTP
Global Default https://deb.debian.org Google time.google.com
Global --cloudflare https://deb.debian.org Cloudflare time.cloudflare.com
Global --aws https://cdn-aws.deb.debian.org Google time.aws.com
China --ustc https://mirrors.ustc.edu.cn DNSPod time.amazonaws.cn
China --tuna https://mirrors.tuna.tsinghua.edu.cn DNSPod time.amazonaws.cn
China --aliyun https://mirrors.aliyun.com AliDNS time.amazonaws.cn
  • --interface <string> Manually select a network interface, e.g. eth1
  • --ethx Disable Consistent Network Device Naming to get interface names like ethX back
  • --ip <string> Disable the auto network config (DHCP) and configure a static IP address, e.g. 10.0.0.2, 1.2.3.4/24, 2001:2345:6789:abcd::ef/48
  • --netmask <string> e.g. 255.255.255.0, ffff:ffff:ffff:ffff::
  • --gateway <string> e.g. 10.0.0.1, none if no gateway
  • --dns '8.8.8.8 8.8.4.4'
  • --dns6 '2001:4860:4860::8888 2001:4860:4860::8844' (effective only if IPv6 is specified)
  • --hostname <string> FQDN hostname (includes the domain name), e.g. server1.example.com
  • --network-console Enable the network console of the installer. ssh installer@ip to connect
  • --version 12 Supports: 10, 11, 12, 13
  • --suite bullseye Please use --version instead if you don't have special needs. e.g. stable, testing, sid
  • --release-d-i d-i (Debian Installer) for the released versions: 12 (bookworm), 11 (bullseye) and 10 (buster)
  • --daily-d-i Use latest daily build of d-i (Debian Installer) for the unreleased version: 13 (trixie), sid (unstable)
  • --mirror-protocol http or https or ftp
  • --https alias to --mirror-protocol https
  • --reuse-proxy Reuse the value of http(s)_proxy environment variable as the mirror proxy
  • --proxy, --mirror-proxy Set an HTTP proxy for APT and downloads
  • --mirror-host deb.debian.org
  • --mirror-directory /debian
  • --security-repository http://security.debian.org/debian-security Magic value: 'mirror' = <mirror-protocol>://<mirror-host>/<mirror-directory>/../debian-security
  • --no-account-setup, --no-user (Manual installation) Proceed account setup manually in VNC or remote console.
  • --username, --user debian New user with sudo privilege or root
  • --password <string> Password of the new user. You'll be prompted if you choose to not specify it here
  • --authorized-keys-url <string> URL to your authorized keys for SSH authentication. e.g. https://github.com/torvalds.keys
  • --sudo-with-password Require password when the user invokes sudo command
  • --timezone UTC e.g. Asia/Shanghai for China (UTC+8) https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
  • --ntp time.google.com
  • --no-disk-partitioning, --no-part (Manual installation) Proceed disk partitioning manually in VNC or remote console
  • --disk <string> Manually select a disk for installation. Please remember to specify this when more than one disk is available! e.g. /dev/sda
  • --no-force-gpt By default, GPT rather than MBR partition table will be created. This option disables it.
  • --bios Don't create EFI system partition. If GPT is being used, create a BIOS boot partition (bios_grub partition). Default if /sys/firmware/efi is absent. See
  • --efi Create an EFI system partition. Default if /sys/firmware/efi exists
  • --esp 106 Size of the EFI system partition. e.g. 106, 538 and 1075 result to 100 MiB, 512 MiB, 1 GiB respectively
  • --filesystem ext4
  • --kernel <string> Choose an package for the kernel image
  • --cloud-kernel Choose linux-image-cloud-amd64 or ...arm64 as the kernel image
  • --bpo-kernel Choose the kernel image from Debian Backports (newer version from the next Debian release)
  • --no-install-recommends
  • --apt-non-free-firmware, --apt-non-free, --apt-contrib, --apt-src, --apt-backports
  • --no-apt-non-free-firmware, --no-apt-non-free, --no-apt-contrib, --no-apt-src, --no-apt-backports
  • --install 'ca-certificates libpam-systemd' Install additional APT packages. Space-separated and quoted.
  • --safe-upgrade (Default) apt upgrade --with-new-pkgs. See
  • --full-upgrade apt dist-upgrade
  • --no-upgrade
  • --bbr Enable TCP BBR congestion control
  • --ssh-port <integer> SSH port
  • --hold Don't reboot or power off after installation
  • --power-off Power off after installation rather than reboot
  • --architecture <string> e.g. amd64, i386, arm64, armhf, etc.
  • --firmware Load additional non-free firmwares
  • --no-force-efi-extra-removable See
  • --grub-timeout 5 How many seconds the GRUB menu shows before entering the installer
  • --force-lowmem <integer> Valid values: 0, 1, 2. Force low memory level. Useful if your machine has memory less than 500M where level 2 is set (see issue #45). --force-lowmem 1 may solve it.
  • --dry-run Print generated preseed and GRUB entry without downloading the installer and actually saving them
  • --cidata ./cidata-example Custom data for cloud-init. VM provider's data source will be IGNORED. See example.

中文说明

下载脚本：

curl -fLO https://raw.githubusercontent.com/bohanyang/debi/master/debi.sh && chmod a+rx debi.sh

运行脚本：

sudo ./debi.sh --cdn --network-console --ethx --bbr --user root --password <新系统用户密码>
  • --bbr 开启 BBR
  • --ethx 网卡名称使用传统形式，如 eth0 而不是 ens3
  • --cloud-kernel 安装占用空间较小的 cloud 内核，但可能会导致 UEFI 启动的机器（如 Oracle、Azure 及 Hyper-V、Google Cloud 等）VNC 黑屏。BIOS 启动的普通 VPS 则没有此问题。
  • 默认时区为 UTC，添加 --timezone Asia/Shanghai 可使用**时区。
  • 默认使用 Debian 官方 CDN 镜像源（deb.debian.org），添加 --ustc 可使用中科大镜像源。

如果没有报错可以重启：

sudo shutdown -r now

约 30 秒后可以尝试 SSH 登录 installer 用户，密码与之前设置的相同。如果成功连接，可以按 Ctrl-A 然后再按 4 监控安装日志。安装完成后会自动重启进入新系统。