English version

一个通过网络启动（network boot）方式，将任何 VPS 或物理机重装为最小化 Debian 系统的脚本。其工作原理是将 Debian 安装程序注入到 GRUB 中，并自动完成安装过程的配置。

非常适合以下场景：

• 将 Oracle Cloud 的 Ubuntu 镜像更换为 Debian
• 移除云服务商内置的监控代理
• 创建最小、纯净的 Debian 环境
• 使用 preseed 或 cloud-init 实现自动化安装
• 拯救或恢复损坏的系统

以root用户运行以下脚本: (一般用户需先加上sudo运行)

bash <(wget -qO- https://git.io/debi.sh) --bbr --ethx --timezone America/New_York

• 开启TCP BBR.
• 设置网卡名称形式为eth0而不是ens3.
• 设置时区为New York,默认时区为UTC.
• 如果不加--user root，默认管理员用户debian将创建(带有sudo权限).
• 如果是一般的 x86 架构 64 位机器（非 ARM 架构），还可以添加--cloud-kernel使用轻量版内核.

如果脚本运行后没有报错，重启VPS进行自动安装.

reboot

(需等待5-10分钟，安装完毕后原登录key无效，仅使用密码登录.)

默认设置: Debian 13 (trixie)，DHCP 网络，创建一个名为 debian 并拥有 sudo 权限的用户，脚本会提示你为该用户设置密码。

IPv6参考:

Debian 10配置自动获取IPV6 (首选，ifupdown方式)

Debian 10配置自动获取IPv6 (systemd-networkd方式)

甲骨文云服务器纯 IPv6 网络（无公网 IPv4）下安装方法

A script that reinstalls any VPS or physical machine to minimal Debian via network boot. Works by injecting the Debian installer into GRUB and automatically configuring the installation process.

Perfect for:

• Converting Oracle Cloud's Ubuntu images to Debian
• Removing cloud provider surveillance agents
• Creating minimal, clean Debian environments
• Automating installations with preseed/cloud-init
• Rescuing broken systems

Run the script under root : (non-root user needs to add sudo to run)

bash <(wget -qO- https://git.io/debi.sh) --bbr --ethx --timezone America/New_York

• Enable TCP BBR.
• Set interface name to eth0 instead of ens3.
• Set timezone to New York. The default is UTC.
• If you don't use --user root, an admin user debian with sudo privilege will be created during the installation.

If everything looks good, reboot the machine:

reboot

Default settings: Debian 13 (trixie), DHCP networking, user debian with sudo access, you'll be prompted for password.

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

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

Configure IPV6 DHCP on Debian 10

Requirements:

• KVM or physical machine (not containers)
• GRUB 2 bootloader
• Root access

Network Console Usage:

1. Enable with --network-console and reboot
2. Wait 2-3 minutes for Debian installer to load components
3. SSH to your server: ssh installer@YOUR_IP
4. Use multiple terminals:
   • Alt+F1: Main installer interface
   • Alt+F2: Shell access
   • Alt+F3: Additional shell
   • Alt+F4: System logs (monitor automated installation progress)
   • Navigate with Alt+Left/Alt+Right

Cloud-Init Usage:

# Create cloud-init configuration
mkdir my-cloud-config
echo "instance-id: my-server" > my-cloud-config/meta-data
cat > my-cloud-config/user-data << 'EOF'
#cloud-config
hostname: my-server
packages:
  - htop
  - git
EOF

# Use with installation
sudo ./debi.sh --cidata my-cloud-config

sudo ./debi.sh --cloudflare --user debian

# GCP requires manual network (replace with your VPC settings)
sudo ./debi.sh --ip 10.128.0.100/24 --gateway 10.128.0.1

sudo ./debi.sh --no-install-recommends --install 'curl git vim' --no-upgrade

sudo ./debi.sh --ustc --timezone Asia/Shanghai --dns '119.29.29.29'

# Enable remote access during install (SSH keys for network, password still needed for VNC/sudo)
sudo ./debi.sh --network-console --authorized-keys-url https://github.com/yourusername.keys
# After reboot, SSH: ssh installer@YOUR_IP

sudo ./debi.sh --ip 192.168.1.100/24 --gateway 192.168.1.1 --cidata ./cloud-config/

sudo ./debi.sh \
  --version 13 \
  --user admin \
  --timezone Europe/London \
  --disk /dev/nvme0n1 \
  --filesystem btrfs \
  --cloud-kernel \
  --bbr \
  --ssh-port 2222 \
  --install 'htop iotop ncdu'

# Remove all modifications and restore original GRUB
sudo rm -rf /etc/default/grub.d/zz-debi.cfg /boot/debian-*
sudo update-grub || sudo grub2-mkconfig -o /boot/grub2/grub.cfg

Multiple disks detected:

# List available disks
lsblk
# Specify target disk
sudo ./debi.sh --disk /dev/sda

Low memory VPS (<512MB):

sudo ./debi.sh --force-lowmem 1

Network configuration fails:

# Use current network settings
sudo ./debi.sh --static-ipv4

# Or configure manually
sudo ./debi.sh --ip YOUR_IP/CIDR --gateway YOUR_GATEWAY

Need firmware for network card:

sudo ./debi.sh --firmware

Installation debugging:

# Generate preseed file only
sudo ./debi.sh --dry-run

# Enable network console for remote access (SSH keys for remote, password for VNC/sudo)
sudo ./debi.sh --network-console --authorized-keys-url YOUR_KEYS_URL

1. Downloads Debian installer to /boot/debian-$VERSION/
2. Generates preseed file with your configuration
3. Modifies GRUB configuration (adds installer menu entry)
4. Injects configuration into installer initramfs
5. Updates GRUB to include new boot option

Changes made to your system:

• Files added to /boot/debian-*/
• GRUB configuration in /etc/default/grub.d/zz-debi.cfg
• Updated GRUB menu

These changes are safe and reversible before reboot using the revert command above.

Created by @bohanyang • Issues • GitHub