logo
0
0
Login
Brent, Yang Bohan<8384161+bohanyang@users.noreply.github.com>
Update Debian version to 13 (trixie) in documentation and script

Debian Network Reinstall Script

このスクリプトについて

これは、あらゆるVPSや物理マシンを、ネットワークブート経由で最小構成のDebianに再インストールするためのスクリプトです。GRUBにDebianインストーラーを組み込み、インストールプロセスを自動的に設定することで動作します。

主な用途:

  • Oracle CloudのUbuntuイメージをDebianに変換
  • クラウドプロバイダーの監視エージェントの削除
  • クリーンで最小限のDebian環境の構築
  • Preseedやcloud-initを使用したインストールの自動化
  • 破損したシステムのレスキュー

クイックスタート

# スクリプトをダウンロード curl -fLO [https://raw.githubusercontent.com/bohanyang/debi/master/debi.sh](https://raw.githubusercontent.com/bohanyang/debi/master/debi.sh) chmod +x debi.sh # 基本的なインストール(sudo権限を持つ 'debian' ユーザーを作成) sudo ./debi.sh # もしくは、rootユーザーとしてインストール sudo ./debi.sh --user root # 準備ができたら再起動 sudo reboot

デフォルト設定: Debian 13 (trixie)、DHCPによるネットワーク設定、sudo権限を持つdebianユーザーが作成され、パスワードの入力を求められます。

プラットフォームサポート

プラットフォームステータス備考
KVM/物理マシンフルサポート全ての機能が動作します
ほとんどのVPSフルサポートDigitalOcean, Vultr, Linodeなど
⚠️ Google Cloud手動でのネットワーク設定が必要DHCPが機能しないため--ip, --gatewayが必須
⚠️ AWS EC2BIOSのみUEFIブートはまだサポートされていません
コンテナサポート対象外GRUBブートローダーが必要です

要件:

  • KVMまたは物理マシン(コンテナは不可)
  • GRUB 2 ブートローダー
  • rootアクセス権限

地域別プリセット

プリセットミラーDNSNTP最適な環境
Defaultdeb.debian.orgGoogle DNStime.google.comグローバル
--cloudflaredeb.debian.orgCloudflaretime.cloudflare.comグローバル (プライバシー重視)
--awscdn-aws.deb.debian.orgGoogle DNStime.aws.comAWSインスタンス
--aliyunmirrors.aliyun.comAliDNStime.amazonaws.cn中国
--ustcmirrors.ustc.edu.cnDNSPodtime.amazonaws.cn中国
--tunamirrors.tuna.tsinghua.edu.cnDNSPodtime.amazonaws.cn中国

全オプションリファレンス

システムとユーザー設定

オプションデフォルト値説明
--version 1313Debianのバージョン: 10, 11, 12, 13, 14
--suite trixietrixieDebianのスイート: stable, testing, sid など
--user debiandebianユーザー名 (rootを指定するとrootユーザーのみ)
--password PASSWORDプロンプトユーザーのパスワード(指定しない場合はプロンプト表示)
--authorized-keys-url URLパスワード認証URLからSSH公開鍵を設定 (例: https://github.com/user.keys)
--no-account-setupユーザー作成ユーザー作成をスキップ(コンソールでの手動設定が必要)
--sudo-with-passwordパスワード不要sudoコマンド実行時にパスワードを要求する
--timezone UTCUTCシステムのタイムゾーン (例: Asia/Tokyo)
--hostname NAME現在の値システムのホスト名

ネットワーク設定

オプションデフォルト値説明
--interface autoautoネットワークインターフェース (例: eth0, eth1)
--ip ADDRESSDHCP静的IP: 10.0.0.100, 1.2.3.4/24, 2001:db8::1/64
--static-ipv4DHCP現在のIPv4設定を自動的に使用
--netmask MASKautoネットマスク: 255.255.255.0, ffff:ffff:ffff:ffff::
--gateway ADDRESSautoゲートウェイIP (noneでゲートウェイなし)
--dns '8.8.8.8 8.8.4.4'1.1.1.1 1.0.0.1IPv4用のDNSサーバー
--dns6 '2001:4860:4860::8888'2606:4700:4700::1111IPv6用のDNSサーバー
--ethx予測可能な名前enp0s3形式の代わりにeth0/eth1を使用
--ntp time.google.comtime.google.comNTPサーバー

ネットワークコンソール(リモートインストール)

オプションデフォルト値説明
--network-console無効インストール中にSSHアクセスを有効化

ネットワークコンソールの使い方:

  1. --network-console を付けて有効化し、再起動します
  2. Debianインストーラーがコンポーネントをロードするまで2〜3分待ちます
  3. サーバーにSSH接続します: ssh installer@YOUR_IP
  4. 複数のターミナルを利用できます:
    • Alt+F1: メインのインストーラー画面
    • Alt+F2: シェルアクセス
    • Alt+F3: 追加のシェル
    • Alt+F4: システムログ(自動インストールの進捗を監視)
    • Alt+Left/Alt+Rightで画面を切り替え

⚠️ 注意事項

--authorized-keys-url を使用した場合、SSHのパスワード認証は無効になります(SSHキーが必須)。ただし、ユーザーパスワードの設定が必要です(VNCコンソールやsudoでのアクセスのため)。

ストレージとパーティショニング

オプションデフォルト値説明
--disk /dev/sda自動検出対象ディスク(複数ディスクがある場合は必須
--no-disk-partitioning自動パーティションコンソールで手動パーティショニングを行う
--filesystem ext4ext4ルートファイルシステムのタイプ
--force-gpt有効GPTパーティションテーブルを作成
--no-force-gptGPTを使用代わりにMBRパーティションテーブルを使用
--bios自動検出BIOSブートを強制(BIOSブートパーティションを作成)
--efi自動検出EFIブートを強制(EFIシステムパーティションを作成)
--esp 106106EFIシステムパーティションのサイズ (106=100MB, 538=512MB, 1075=1GB)

ミラーとリポジトリの設定

オプションデフォルト値説明
--mirror-protocol httpshttpsミラーのプロトコル: http, https, ftp
--https有効--mirror-protocol https のエイリアス
--mirror-host deb.debian.orgdeb.debian.orgミラーのホスト名
--mirror-directory /debian/debianミラーのディレクトリパス
--mirror-proxy URLなしダウンロードとAPT用のHTTPプロキシ
--reuse-proxyなし既存のhttp_proxy環境変数を使用
--security-repository URLautoセキュリティアップデート用リポジトリ (mirrorでメインミラーを使用)

APTリポジトリコンポーネント

オプションデフォルト値説明
--apt-non-free-firmware有効non-free-firmwareを含める (Debian 12以降)
--apt-non-free無効non-freeリポジトリを有効化
--apt-contrib無効contribリポジトリを有効化
--apt-src有効ソースリポジトリを有効化
--apt-backports有効backportsリポジトリを有効化
--no-apt-non-free-firmwareデフォルトを使用non-free-firmwareを無効化
--no-apt-non-freeデフォルトを使用non-freeを無効化
--no-apt-contribデフォルトを使用contribを無効化
--no-apt-srcデフォルトを使用ソースリポジトリを無効化
--no-apt-backportsデフォルトを使用backportsを無効化

パッケージインストール

オプションデフォルト値説明
--install 'pkg1 pkg2'最小構成追加パッケージ(スペース区切り、引用符で囲む)
--install-recommends有効推奨パッケージをインストール
--no-install-recommends推奨をインストール推奨パッケージをスキップ
--upgrade safe-upgradesafe-upgradeパッケージのアップグレードモード
--safe-upgradeデフォルトインストール中に安全なパッケージアップグレードを実行
--full-upgradesafe upgradeフルシステムアップグレード (dist-upgrade)
--no-upgradesafe upgradeパッケージのアップグレードを完全にスキップ

カーネルオプション

オプションデフォルト値説明
--kernel PACKAGElinux-image-ARCHカーネルパッケージ名
--cloud-kernel標準クラウド最適化カーネルを使用
--bpo-kernelstablebackportsから新しいカーネルを使用
--firmware自動検出ハードウェア用のnon-freeファームウェアを含める

詳細オプション

オプションデフォルト値説明
--ssh-port 222222カスタムSSHポート
--bbr無効TCP BBR輻輳制御アルゴリズムを有効化
--architecture amd64自動検出対象アーキテクチャ: amd64, arm64, i386 など
--force-lowmem 1auto低メモリモードを強制: 0, 1, 2 (512MB未満のRAM用)
--no-force-efi-extra-removable有効EFIの追加リムーバブルメディアパスを無効化
--grub-timeout 55GRUBメニューのタイムアウト秒数

Debianインストーラーオプション

オプションデフォルト値説明
--release-d-iautoリリース版のdebian-installerを使用
--daily-d-iautoデイリービルド版のdebian-installerを使用

Cloud-Init連携

オプションデフォルト値説明
--cidata /path/to/dirなしカスタムcloud-initデータディレクトリ

Cloud-Initの使い方:

# cloud-init設定を作成 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 # インストール時に使用 sudo ./debi.sh --cidata my-cloud-config

開発とテスト

オプションデフォルト値説明
--dry-run実行インストールは行わず、設定ファイルのみ生成
--hold再起動インストール後に再起動しない
--power-off再起動再起動の代わりに電源をオフにする

使用例

Oracle Cloud (Ubuntu → Debian)

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

Google Cloud Platform

# GCPでは手動でのネットワーク設定が必要(お使いのVPC設定に置き換えてください) 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'

ネットワークコンソールでのインストール

# インストール中にリモートアクセスを有効化(ネットワーク接続はSSHキー、VNC/sudoはパスワードが引き続き必要) sudo ./debi.sh --network-console --authorized-keys-url [https://github.com/yourusername.keys](https://github.com/yourusername.keys) # 再起動後、SSH接続: ssh installer@YOUR_IP

静的IPとCloud-Initを使用

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'

トラブルシューティング

全ての変更を元に戻す

# 全ての変更を削除し、元のGRUB設定を復元 sudo rm -rf /etc/default/grub.d/zz-debi.cfg /boot/debian-* sudo update-grub || sudo grub2-mkconfig -o /boot/grub2/grub.cfg

よくある問題

複数のディスクが検出された場合:

# 利用可能なディスクをリスト表示 lsblk # 対象ディスクを指定 sudo ./debi.sh --disk /dev/sda

低メモリのVPS (<512MB) の場合:

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

ネットワーク設定に失敗する場合:

# 現在のネットワーク設定を使用 sudo ./debi.sh --static-ipv4 # または手動で設定 sudo ./debi.sh --ip YOUR_IP/CIDR --gateway YOUR_GATEWAY

ネットワークカードにファームウェアが必要な場合:

sudo ./debi.sh --firmware

インストールのデバッグ:

# preseedファイルのみを生成 sudo ./debi.sh --dry-run # リモートアクセス用にネットワークコンソールを有効化(リモートはSSHキー、VNC/sudoはパスワードが必要) sudo ./debi.sh --network-console --authorized-keys-url YOUR_KEYS_URL

動作の仕組み

  1. Debianインストーラーをダウンロードし、/boot/debian-$VERSION/に配置します
  2. 指定された設定でpreseedファイルを生成します
  3. GRUBの設定を変更し、インストーラーのメニューエントリを追加します
  4. インストーラーのinitramfsに設定を注入します
  5. GRUBを更新し、新しいブートオプションを反映させます

システムに加えられる変更:

  • /boot/debian-*/ にファイルが追加されます
  • /etc/default/grub.d/zz-debi.cfg にGRUB設定が追加されます
  • GRUBメニューが更新されます

これらの変更は安全であり、再起動前であれば上記の「元に戻す」コマンドで取り消すことが可能です。


Created by @bohanyangIssuesGitHub