mcpField
D
debian-ubuntu

debian-ubuntu

github.com/iulianditaクラウド・DevOps10153 回インストール1 日前に更新
リポジトリ

debian-ubuntu について

Debian、Ubuntu とその派生ディストリビューションのシステム管理スキルです。パッケージ、起動、デスクトップ、ハードウェア、セキュリティの作業を対象とし、環境を特定してから変更と検証を進めます。

主な機能

  1. 01apt、dpkg、PPA の管理
  2. 02systemd、起動、カーネルのトラブル対応
  3. 03デスクトップ、音声、グラフィックス、ハードウェアの対応
  4. 04リリース更新とセキュリティ更新の管理
  5. 05ディストリビューションごとの前提確認

活用シーン

  1. 01Debian システムのパッケージやサービス障害を調査
  2. 02Ubuntu のアップグレード、カーネル、ドライバーを保守
  3. 03Mint、Pop!_OS など派生環境の違いに対処

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/iuliandita/skills --skill debian-ubuntu

インストール後、Claude Code で/debian-ubuntuを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
agent-hygiene.md
base-linux-and-cli.md
boot-kernel-and-recovery.md
capture-and-sharing.md
derivatives-and-hwe.md
desktop-audio-and-bluetooth.md
gotchas-and-special-situations.md
graphics-and-gaming.md
output-contract.md
packages-and-repos.md
remote-gaming-input-and-tooling.md
security-and-updates.md
session-display-and-mobile.md
storage-and-rollback.md
systemd-and-journal.md

詳細

Debian-Ubuntu:Debian および Debian ベースのディストリビューションの管理

Debian、Ubuntu、Linux Mint、Pop!_OS、Devuan などの Debian 派生システムを管理します。 Kali については、質問がセキュリティディストリビューション固有のワークフローではなく、 基本 OS の管理に関する場合に限り、部分的に対応します。

まず Debian stable と Ubuntu LTS に重点を置き、その後、派生ディストリビューション固有の動作、PPA ワークフロー、snap の隔離、Ubuntu HWE を加え、init、パッケージの既定値、または想定用途が 異なる派生ディストリビューションについては、明示的に確認します。

バージョンの固定を検討すべき項目(2026 年 10 月に確認済み):

互換性やトラブルシューティングの進め方に大きく影響する場合に限り、ここでバージョンを固定してください。 一般的な Debian と Ubuntu のパッケージ作業では、古いパッケージバージョン表ではなく、 最新のディストリビューション系列とパッケージポリシーを優先してください。

コンポーネントバージョン重要な理由
Debian stable13(trixie)現在の stable の基準およびリポジトリの動作
Ubuntu LTS26.04(Resolute Raccoon)Ubuntu の大半のガイダンスにおける現在の LTS の基準
Ubuntu interim 系列最新情報を確認(26.10「Stonking Stingray」は 2026-10-15 にリリース、サポート終了は 2027 年 7 月。25.10 のサポート終了は 2026 年 7 月)interim リリースは変化が速いため、短期間しか使われないコードネームを覚えるのではなく、現在有効なアップグレードパスを確認してください
Ubuntu HWE 系列最新情報を確認特定のカーネル番号より、カーネルメタパッケージとハードウェア有効化の動作が重要です
NVIDIA ドライバーブランチ最新情報を確認プロプライエタリブランチの選択は、Wayland、ゲーム、DKMS の動作に影響します
Mesa スタック最新情報を確認AMD および Intel のグラフィックスの動作は、提供されている Mesa 系列に左右されます
カーネルセキュリティUSN トラッカーで最新情報を確認深刻度の高い権限昇格 CVE には速やかにパッチを適用してください。2026 年半ばの例として修正状況を確認すべきもの:Copy Fail CVE-2026-31431(CISA KEV、悪用済み)、Dirty Frag CVE-2026-43284/43500、Fragnesia CVE-2026-46300(ESP-in-TCP、公開 PoC あり、CISA KEV には未掲載)、ptrace CVE-2026-46333

セキュリティ再確認(2026-09-10):CVE-2026-53362 は、Canonical が CISA KEV に掲載している優先度の高い Linux IPv6 の脆弱性です。Ubuntu 26.04 の linux パッケージは 7.0.0-31.31 で修正済みです。Ubuntu 24.04 の linux-hwe-7.0 は 7.0.0-31.31~24.04.1 で修正済みです。この記録では、24.04 の linux 系列には引き続き脆弱性があるとされています。 正確なリリースとカーネルパッケージを確認してください。これらは、すべてに適用できるカーネルバージョンの下限ではありません。

セキュリティ再確認(2026-10-02):CVE-2026-53266 (netfilter ebtables SNAT、深刻度高、CISA KEV 2026-09-18)も、同じバージョンで修正されています。26.04 では linux 7.0.0-31.31、24.04 では linux-hwe-7.0 7.0.0-31.31~24.04.1 です。一方、24.04 の linux 系列は引き続き脆弱性があると記載されています。

使用する場面

  • apt、apt-get、dpkg、apt-cache を使ったパッケージ管理、優先度設定、または保留
  • Ubuntu、Mint、または Pop!_OS での PPA 管理(add-apt-repository、鍵の取り扱い)
  • snap と Flatpak のワークフロー、隔離に関する問題、代替手段
  • Debian 系システムでの systemd サービス、タイマー、起動、ジャーナルのトラブルシューティング
  • Debian または Ubuntu での GRUB、initramfs、EFI、カーネル、復旧作業
  • リリースの保守:dist-upgrade、HWE の移行、リリースアップグレード(do-release-upgrade)
  • デスクトップスタック:Wayland と X11 の比較、GNOME、KDE、Cinnamon、COSMIC、ポータル、PipeWire、Bluetooth
  • セッション起動とノート PC の作業:GDM、SDDM、LightDM、サスペンド/レジューム、電源プロファイル、ハイブリッドグラフィックス
  • GPU とゲーム:NVIDIA プロプライエタリドライバーと nouveau の比較、AMD Mesa、Intel、Vulkan、Steam、Proton、Gamescope
  • キャプチャとコミュニケーション:OBS、WebRTC 画面共有、Discord/Teams、ポータル、仮想カメラ
  • ストレージ:ext4、Btrfs、LUKS、LVM、TRIM、休止状態
  • ファームウェアとハードウェア有効化:fwupd、ubuntu-drivers、HWE スタック、バックポート
  • セキュリティ:AppArmor プロファイル、unattended-upgrades、needrestart、debian-security の更新
  • リモートゲームと入力:Moonlight、Sunshine、Steam Remote Play、コントローラー
  • Debian 系システムでの基本的な Linux 運用:journalctl、dmesg、lsblk、update-alternatives

使用しないケース

  • シェルの構文、引用符の使い方、スクリプトの移植性については、shell-scriptingを使用してください
  • ネットワークアーキテクチャ、DNS、VPN、リバースプロキシ、ファイアウォールの設計については、networkingを使用してください
  • Docker、Podman、イメージのビルド、コンテナランタイムについては、dockerを使用してください
  • Kubernetes クラスターやマニフェストの作業については、kubernetesを使用してください
  • プレイブックによる Linux のフリート全体の構成管理については、ansibleを使用してください
  • セキュリティレビュー、脆弱性のトリアージ、攻撃的なテストについては、security-auditまたはprivilege-escalationを使用してください
  • RPM 系ディストリビューションとそのツールについては、rhel-fedoraを使用してください。これには RHEL、Fedora、Rocky、AlmaLinux、Oracle Linux、Amazon Linux が含まれます。
  • Ubuntu Core と snap のみを使うトランザクション型ワークフローは、このスキルの対象外です。通常の apt 管理対象の Ubuntu ホストと同様に扱わないでください
  • NixOS や宣言型のシステム管理については、nixosを使用してください
  • Kali の攻撃用ツール、ペネトレーションテストのワークフロー、トレーニング用イメージ固有の内容については、kali-linuxを使用してください
  • OPNsense または pfSense アプライアンスの作業については、opnsense-pfsenseを使用してください

AI セルフチェック

Debian または Ubuntu のコマンドを返す前に、次の項目を確認してください。

  • ディストリビューションとリリースを特定:Debian stable/testing/unstable、Ubuntu LTS/中間リリース、Mint、Pop!_OS、Devuan、Kali、その他の派生ディストリビューションのいずれかを特定し、現在のサポート期間と有効なリポジトリを確認します。状況はすぐに変わります。
  • init システムを特定:Devuan やその他の Debian 派生ディストリビューションで systemd を前提にせず、まず PID 1、サービスマネージャー、ブートツールを確認します。
  • リリースモデルを尊重:パッケージの移行に apt full-upgrade または apt dist-upgrade が必要な場合、apt upgrade を提案しないでください。Ubuntu では、状況を説明せずに apt dist-upgrade を安易に提案しないでください。
  • Ubuntu 24.04 から 26.04 への変更点を考慮:Ubuntu 24.04 LTS からアップグレードする場合、24.10、25.04、25.10、26.04 の変更点も適用されます。26.04 を 24.04 の小規模なポイントリフレッシュとして扱わないでください。
  • リポジトリの状態が正常:apt のリストに破損がなく、GPG キーが不足しておらず、pinning なしで複数のリリースが混在していないことを確認します。
  • ブートスタックを特定:ブートファイルを変更する前に、GRUB などのブートローダー、EFI または BIOS、initramfs ジェネレーター、カーネルメタパッケージを確認します。
  • フォールバック手段を確保:正常動作が確認済みの唯一のカーネルを削除したり、唯一のブートエントリーを壊したりしないでください。特に、リモートシステムや暗号化されたシステムでは注意してください。
  • サードパーティーリポジトリの信頼境界を尊重:PPA を追加する前に、ソース、キー、保守状況を確認します。snap、ベンダーリポジトリ、pin 優先度について明示します。
  • systemd の対象範囲が適切:システムユニットとユーザーユニットを区別し、適切な場合にのみ systemctl --user を使用します。
  • Wayland スタックに一貫性がある:コンポジター、ポータルバックエンド、Xwayland との互換性、ユーザーセッションサービスの組み合わせを確認します。
  • セッション起動経路を特定:環境変数の引き継ぎをデバッグする前に、ディスプレイマネージャー、グリーター、TTY の起動経路を確認します。
  • オーディオスタックに一貫性がある:PipeWire、pipewire-pulse、WirePlumber が、残存する PulseAudio の設定と競合していないことを確認します。
  • Bluetooth の経路が完全:オーディオルーティング、信頼設定、ペアリング、プロファイル選択に問題がある場合、bluetooth.service だけでは不十分です。
  • GPU スタックがハードウェアに適合:独自 NVIDIA ドライバー、nouveau、Mesa のいずれを使うか確認します。グラフィックスの問題をデバッグする前に、実際に使用中のドライバーを確認します。
  • 必要に応じてゲーム用スタックに 32 ビットユーザー空間を含める:Steam や Proton の問題は、i386 グラフィックスライブラリの不足が原因であることがよくあります。
  • キャプチャースタックに一貫性がある:ポータルバックエンド、PipeWire、WebRTC または Electron クライアントの経路、仮想カメラモジュールの選択に矛盾がないことを確認します。
  • サスペンドと休止状態に関する説明が実態に即している:休止状態の案内を、実際のスワップ構成、initramfs の resume フック、Secure Boot の状態に合わせます。
  • AppArmor の状態を考慮:Ubuntu では、AppArmor による拒否がサービス、snap、カスタムバイナリの動作を気付かれないまま妨げることがあります。
  • Snap のサンドボックス制限を無視しない:snap の動作に問題がある場合、再インストールする前にインターフェースと制限レベルを確認します。
  • Ubuntu デスクトップセッションに関する前提が最新:Ubuntu 26.04 Desktop では、標準の Xorg セッションや従来の Software & Updates GUI がデフォルトで存在すると決めつけないでください。
  • HWE カーネルの経路を把握:Ubuntu HWE スタックではカーネルメタパッケージが移行します。システムが generic と hwe のどちらを追跡するか確認します。
  • 診断エラーを抑制しない:エラーの理由が重要なコマンドで、2>/dev/null を使って失敗を隠さないでください。処理を中断させずにエラーを表示するには、2>&1 || true を使用します。
  • ファームウェアの更新とパッケージの更新を混同しない:fwupd やベンダー製ツール(例:system76-firmware)は、apt upgrade とは別です。
  • Debian の alternatives を確認:コマンドの動作がおかしい場合、そのバイナリに対する update-alternatives の設定を確認します。
  • エージェント全般の衛生管理を適用してください。詳しくは references/agent-hygiene.md を参照してください。

ワークフロー

手順は順番どおりです。このチェックリストをコピーして、進捗を記録してください。

  • 手順 1:ディストリビューションの系統を特定する
  • 手順 2:現在の状態を収集する
  • 手順 3:該当するリファレンスを読み込む
  • 手順 4:1 つのレイヤーを変更する。影響の大きい変更は事前に確認する
  • 手順 5:検証する(失敗した場合は修正し、手順 4 に戻る)
手順 1:まずディストリビューションの系統を特定する
ディストリビューションデフォルトの方針変更内容
Debian stable慎重に進め、バージョンを固定するtesting/unstable が明示的に指定されていない限り、stable リポジトリのみを使用します。一部のパッケージにはバックポートを使用します。
Debian testingローリングに近いが、フリーズ期間ありUbuntu に近いものの、Ubuntu 固有のツールはありません。
Debian unstable (sid)真のローリングリリースリリースはなく、sid のみです。破損のリスクが高くなります。
Ubuntu LTSデフォルトのベースラインリリース間のアップグレードには do-release-upgrade を使用します。Ubuntu 26.04 を現在のベースラインとして扱いますが、24.04 LTS からアップグレードする場合は、24.10、25.04、25.10 の変更も引き継ぐことに注意してください。HWE カーネルは任意です。Snap が存在します。
Ubuntu interim短期間のサポート現行 LTS への移行時によく使われる中継地点です。EOL がすぐに訪れます。
Linux MintUbuntu LTS の派生版Cinnamon/XFCE を重視しています。Mint 固有のリポジトリとアップデートマネージャーがあります。Ubuntu の PPA は多くの場合動作します。
Pop!_OS追加機能を備えた Ubuntu 派生版System76 のファームウェア、COSMIC デスクトップ、Pop のリポジトリ、system76-power を備えています。NVIDIA 用 ISO も利用できます。
Devuanサービスモデルが大きく異なる Debian 派生版systemd、systemctl、Ubuntu 形式のデスクトップ/セッション管理機構があると想定しないでください。まず init とサービス管理ツールを確認してください。
KaliDebian 派生のセキュリティディストリビューション基本的な apt、カーネル、ブート、サービス管理には適していますが、Kali 固有の分岐、イメージ、メタパッケージ、トレーニング用イメージのワークフロー、攻撃用ディストリビューションに関する内容には kali-linux を使用してください。
その他の Debian 系リポジトリモデルを確認する標準の Debian や Ubuntu と同じ動作をすると想定しないでください。
手順 2:現在のシステム状態を収集する
cat /etc/os-release
uname -r
ps -p 1 -o comm=
dpkg-query -W -f='${Package}\t${Version}\n' 'linux-image*' systemd grub-common grub-efi-amd64 2>&1 || true
dpkg -l | grep -E "^ii.*(systemd|grub|pipewire|nvidia|mesa)" | head -15
apt-cache policy
command -v systemctl >/dev/null 2>&1 && systemctl --failed
journalctl -b -p warning..alert 2>&1 || true
findmnt /boot
findmnt /boot/efi
command -v grub-install >/dev/null 2>&1 && grub-install --version
lsblk -f
echo "Session=$XDG_SESSION_TYPE Desktop=$XDG_CURRENT_DESKTOP"
loginctl list-sessions 2>&1 || true
command -v systemctl >/dev/null 2>&1 && systemctl status display-manager 2>&1 || true
command -v systemctl >/dev/null 2>&1 && systemctl --user --failed 2>&1 || true
command -v systemctl >/dev/null 2>&1 && systemctl --user status pipewire pipewire-pulse wireplumber 2>&1 || true
command -v systemctl >/dev/null 2>&1 && systemctl --user status xdg-desktop-portal 2>&1 || true
command -v systemctl >/dev/null 2>&1 && systemctl status apparmor 2>&1 || true
command -v aa-status >/dev/null 2>&1 && aa-status 2>&1 || true
command -v wpctl >/dev/null 2>&1 && wpctl status
command -v bluetoothctl >/dev/null 2>&1 && bluetoothctl show
command -v snap >/dev/null 2>&1 && snap list | head -10
command -v flatpak >/dev/null 2>&1 && flatpak list | head -10
lspci -k | grep -Ei 'vga|3d|display'
journalctl -b | grep -Ei 'nvrm|nvidia|amdgpu|i915|xe|drm' 2>&1 || true
journalctl --user -b | grep -Ei 'portal|pipewire|webrtc|obs' 2>&1 || true
lsmod | grep '^v4l2loopback'
command -v dkms >/dev/null 2>&1 && dkms status
findmnt -t btrfs
command -v systemctl >/dev/null 2>&1 && systemctl status fstrim.timer 2>&1 || true
apt list --upgradable 2>&1 | tail -n +2
手順 3:関連するリファレンスのみを読み込む

ホストが Ubuntu 24.04 LTS の場合、またはユーザーが 24.04 から 26.04 への移行を計画している場合は、早い段階で references/derivatives-and-hwe.md を読み込んでください。このリファレンスには、中間リリースに伴う変更、デスクトップセッションの変更、 アプリの入れ替え、GUI ツールの変更がまとめられています。26.04 を通常の ポイントリリースアップグレードのように扱うと、これらは見落とされます。

タスクの種類リファレンス
apt、dpkg、PPA、.deb の処理references/packages-and-repos.md
systemd ユニット、タイマー、ジャーナル、オーバーライドreferences/systemd-and-journal.md
GRUB、カーネル、initramfs、EFI、リカバリーreferences/boot-kernel-and-recovery.md
Ubuntu HWE、リリースアップグレード、Debian の系統、Mint/Pop/Devuan/Kali 固有の内容references/derivatives-and-hwe.md
Wayland、X11、GNOME、KDE、Cinnamon、COSMIC、PipeWirereferences/desktop-audio-and-bluetooth.md
ディスプレイマネージャー、セッション起動、サスペンド/復帰、電源、ハイブリッドグラフィックスreferences/session-display-and-mobile.md
GPU ドライバー、Vulkan、Steam、Proton、ゲームreferences/graphics-and-gaming.md
OBS、WebRTC、画面共有、仮想カメラreferences/capture-and-sharing.md
ext4、Btrfs、LUKS、LVM、TRIM、休止状態references/storage-and-rollback.md
AppArmor の拒否、unattended-upgrades の状態references/security-and-updates.md
リモートゲーム、コントローラー、入力references/remote-gaming-input-and-tooling.md
Linux の基本的な運用コマンドと Debian ツールreferences/base-linux-and-cli.md
Debian/Ubuntu で繰り返し発生する障害パターンreferences/gotchas-and-special-situations.md

デフォルトでは、すべてのリファレンスを読み込まないでください。障害の種類に合ったものを選び、最初のレイヤーに問題がない場合に限って範囲を広げてください。

ステップ 4:一度に 1 つのレイヤーを変更する
  • 古いライブラリの影響でサービスが壊れている可能性がある場合、サービスのデバッグを行う前に、パッケージの状態を修正します。
  • systemd が壊れていると判断する前に、サービスの設定を修正します。
  • initramfs を再構築する前に、マウントポイントとローダーの状態を修正します。
  • Ubuntu では、「標準の Debian の動作」と「Ubuntu の snap/HWE/PPA による動作」を切り分けます。
  • Pop!_OS では、「Ubuntu の動作」と「System76 のファームウェアおよび電源関連の動作」を切り分けます。
  • パッケージの保留、バックアップ用カーネル、apt-mark、設定の保存など、元に戻せる手順を優先します。
  • リリースアップグレード、カーネル変更、ファイルシステム操作、ブートローダーの修復の前に、スナップショットを作成するか、バックアップを取ります。

重大な変更(リリースアップグレード、削除を伴う full-upgrade、カーネルの削除、GRUB の再インストール、PPA の削除、LUKS または LVM の変更)を行う場合は、実行するコマンドとその内容(apt-get -s によるトランザクションのシミュレーション、削除リスト、または対象デバイス)を正確に示し、明示的な確認を得てから実行し、ステップ 5 に進みます。無人実行の場合は、計画の提示までで停止します。正確なコマンドは、references/derivatives-and-hwe.md(リリースアップグレード)、references/boot-kernel-and-recovery.md(カーネル、GRUB、ライブメディアからの chroot)、references/storage-and-rollback.md(LUKS、LVM)に記載されています。

ステップ 5:終了前に検証する
apt-cache policy package_name
systemctl status unit_name
journalctl -u unit_name -b
ls -l /boot/vmlinuz-* /boot/initrd.img-*

カーネルまたはブートファイルを変更した場合、まず各カーネルに initrd があることを確認し、不足しているものには sudo update-initramfs -u -k <version> を実行します。次に、GRUB が使用中のローダーであることを確認できた場合にのみ(command -v update-grub)、sudo update-grub を実行し、grep -E "menuentry|initrd" /boot/grub/grub.cfg でエントリーを確認します。チェックに失敗した場合は、問題が示すレイヤーを修正してステップ 4 に戻ります。ブート経路を把握し、少なくとも 1 つの正常動作が確認済みのエントリーが残っている場合にのみ、再起動します。


トラブルシューティングの手順

レイヤーをまたいで、落ち着いてトリアージを進めます。

  1. 使用中のディストリビューション、リリース、セッションの種類、カーネル、パッケージの系列を確認します。
  2. 問題のレイヤーを特定します:パッケージの状態、システムサービス、ユーザーサービス、ブート経路、デスクトップセッション、グラフィックス、またはアプリです。
  3. 設定を変更する前にログを取得します。
  4. 一度に 1 つのレイヤーを変更し、その都度再テストします。
  5. 調整を積み重ねるより、正常動作が確認済みのベースラインを優先します。

基本的なログの確認:

journalctl -b -p warning..alert
journalctl --user -b
dmesg --level=err,warn
journalctl -u unit_name -b
journalctl --user -u pipewire -u wireplumber -u xdg-desktop-portal -b

相関関係を調べる必要がある場合に使用する、広範なパターン検索です。最初の確認での精度を重視する場合は使用しません。

journalctl -b | grep -Ei 'nvrm|nvidia|amdgpu|i915|xe|drm' 2>&1 || true
journalctl --user -b | grep -Ei 'portal|pipewire|webrtc|obs' 2>&1 || true

デスクトップ固有の問題に見える場合は、クリーンなベースラインを 1 つ比較します。

  • GNOME と KDE、Cinnamon、COSMIC
  • ブラウザーの WebRTC と、パッケージ版クライアント
  • ゲームの通常起動と、Gamescope または MangoHud を使用した起動
  • 標準カーネルと HWE カーネル

デフォルトの判断基準

  • Debian stable は保守的な更新を意味します。 リポジトリを混在させる場合は、バージョンを固定してください。バックポートは選択的に使用してください。移行計画なしに、stable で testing や sid のパッケージを使用するのは避けてください。
  • Ubuntu LTS は予測可能な更新サイクルを意味します。 Ubuntu 26.04 が現在の基準ですが、24.04 から 26.04 へのアップグレードには、3 回の中間リリースと最後の LTS との差分が含まれます。バージョンの変更だけから想像する以上に、デスクトップ、アプリ、ワークフローに大きな変更があると考えてください。
  • Ubuntu Desktop の前提は 26.04 で変わりました。 標準の Ubuntu Desktop は Wayland のみで動作し、従来の Software & Updates GUI は新規インストール時にデフォルトではインストールされなくなりました。24.04 時代のブログ記事にある GUI を最初に使うトラブルシューティングのアドバイスは、新規の 26.04 システムでは当てはまらない場合があります。
  • まず systemd ネイティブのツールを使ってください。 ディストリビューション独自のラッパーより先に、systemctl、journalctl、timedatectl、localectl を使用してください。
  • PPA はデフォルトではなく例外として扱ってください。 PPA を追加する前に、メンテナー、署名鍵、更新状況、パッケージの提供元を確認してください。使われなくなった PPA は速やかに削除してください。
  • サードパーティのリポジトリより、まずディストリビューションのパッケージを優先してください。 まず Debian backports、Ubuntu 公式リポジトリ、またはベンダーのパッケージを使用し、ディストリビューション側の選択肢では本当に不十分な場合にのみ PPA を検討してください。ベンダーのリポジトリは、そのベンダーが提供するパッケージに限定してください。
  • 対象を絞ってから、範囲を広げてください。 大規模な再インストールを試す前に、apt-cache policy、apt list --upgradable、対象を絞ったインストールを使ってください。アップグレードが遅い場合は、依存関係解決の選択を強制する前に、保留中のパッケージと段階的な更新を確認してください。パッケージインデックスの更新対象は絞ってください。スクリプト内で apt update を繰り返すと、時間と負荷が無駄になります。
  • snap はまずサンドボックス化されているものとして扱ってください。 snap の失敗は、パッケージのバグよりもインターフェースや制限設定の問題であることのほうが多いです。
  • GRUB と initramfs は一つのサブシステムです。 カーネルメタパッケージ、update-initramfs、update-grub、EFI のフォールバックは、すべて整合している必要があります。
  • デスクトップの障害は、セッションの障害であることがよくあります。 Wayland では、ユーザー単位のユニット、ポータル、セッション環境変数もパッケージ一覧と同じくらい重要です。
  • ゲームの障害は、スタックの不整合であることがよくあります。 ドライバーブランチの誤り、i386 ユーザー空間の不足、ファームウェアの欠如、Proton のパスの破損は、「Linux でのゲームはよくない」という問題よりも一般的です。
  • キャプチャの障害は、ポータルや PipeWire の障害です。 OBS、ブラウザーの WebRTC、Discord、Teams では、スクリーンキャストの経路で失敗することがよくあります。
  • AppArmor は、問題になるまで見えない存在です。 Ubuntu では、サービスやバイナリが不可解な形で失敗する場合、aa-status とジャーナルの拒否ログを確認してください。
  • ファームウェアはパッケージとは別です。 fwupd とベンダーのツールはハードウェアのファームウェアを更新します。apt upgrade で BIOS や SSD のファームウェアが修正されるとは考えないでください。

迅速なトリアージチェックリスト

症状最初に確認する項目
インストール後にパッケージの状態がおかしいまず apt update を実行します。依存関係が壊れていますか? apt -f install を実行します。保留中のパッケージがありますか? apt-mark showhold を実行します。リリースが混在していますか? apt-cache policy を実行します。
更新後にサービスが失敗する設定のマージが必要ですか? ucf または dpkg --configure -a を実行します。ユニットのオーバーライドと journalctl -b を確認します。
カーネル作業後に起動しないGRUB メニュー、フォールバックカーネル、initramfs を確認します。ライブメディアから、ルートと ESP をマウントしてから、chroot の前に /dev、/proc、/sys、/run をバインドマウントします。1 行の chroot レシピではなく、ブートリカバリーのリファレンスを使用します。
PPA がシステムを壊した利用可能であれば ppa-purge を使用します。または、apt-cache policy でパッケージの配布元を確認してから、手動でダウングレードして削除します。
Snap アプリの動作がおかしいsnap connections、snap info、コンファインメントレベル、インターフェースを確認します。
更新後にデスクトップの状態がおかしいXDG_SESSION_TYPE、ポータル、Xwayland、ユーザーサービスを確認します。Ubuntu 26.04 では、従来の Ubuntu Xorg セッションがデフォルトで存在するとユーザーが期待していないか確認します。
Bluetooth オーディオの問題BlueZ のペアリング、PipeWire のノード、カードプロファイルを確認します。
ゲームの画面が真っ暗になる/クラッシュするGPU ドライバー(プロプライエタリか Mesa か)、Vulkan、Steam の i386 ライブラリ、Gamescope/MangoHud を確認します。
画面共有が機能しないWayland か X11 か、ポータルのバックエンド、PipeWire のユーザーユニットを確認します。
サスペンド/レジュームでデスクトップに問題が起きるスリープ状態、GPU のログ、ロック画面、ディスプレイマネージャーを確認します。
カーネル変更後に NVIDIA/モジュールが消えたDKMS の不整合を確認します。dkms status を実行し、モジュールが uname -r 用にビルドされていることを確認して、HWE の移行状況を確認します。
何もかも理解できない落とし穴のリファレンスを確認します。リポジトリの混在、古い PPA、DKMS の不整合、AppArmor による拒否、HWE メタパッケージの不一致などがあります。

リファレンスファイル

  • references/packages-and-repos.md - apt と dpkg の簡易チェック、壊れた依存関係や中断されたインストールの復旧、PPA の安全性と ppa-purge
  • references/systemd-and-journal.md - systemd サービスのデバッグ、ユニットのオーバーライド、ユーザーユニット、journal のトリアージ
  • references/boot-kernel-and-recovery.md - GRUB、カーネルメタパッケージ、initramfs、EFI、リカバリー、ライブ ISO での chroot
  • references/derivatives-and-hwe.md - Ubuntu HWE、リリースアップグレード、Debian の系統による違い、Mint、Pop!_OS、Devuan、Kali の対象範囲に関する注意事項
  • references/desktop-audio-and-bluetooth.md - X11 と Wayland の違い、GNOME、KDE、Cinnamon、COSMIC、ポータル、PipeWire、Bluetooth
  • references/session-display-and-mobile.md - ディスプレイマネージャー、セッション起動、サスペンド/レジューム、電源に関する最初のチェック項目
  • references/graphics-and-gaming.md - NVIDIA、AMD、Intel、Vulkan、Steam、Proton、Gamescope、MangoHud
  • references/capture-and-sharing.md - OBS、WebRTC の画面共有、Discord/Teams、ハードウェアエンコーディング、仮想カメラ
  • references/storage-and-rollback.md - ext4、Btrfs、LUKS、LVM、TRIM、ハイバネーション、レジューム
  • references/security-and-updates.md - AppArmor、自動アップグレード、needrestart の最初のチェック項目
  • references/remote-gaming-input-and-tooling.md - リモートストリーミングとコントローラー入力の最初のチェック項目
  • references/base-linux-and-cli.md - Linux の基本的な調査用コマンドと、update-alternatives などの Debian ツール
  • references/gotchas-and-special-situations.md - Debian/Ubuntu で繰り返し発生する障害パターンの簡易チェックリスト

出力要件

完全な要件については references/output-contract.md を参照してください。

  • スキル名: DEBIAN-UBUNTU
  • 成果物の分類: audits
  • モード: 条件付き。既存のリポジトリコンテンツの分析、レビュー、監査、改善を依頼された場合は、references/output-contract.md のレポートの分量と根拠に関するルールを適用し、成果物を docs/local/audits/debian-ubuntu/<YYYY-MM-DD>-<slug>.md に書き込みます。質問への回答、概念の説明、新しい成果物の作成、コンテンツの生成を依頼された場合は、要件に従わず自由に回答します。
  • 重大度の尺度: P0 | P1 | P2 | P3 | info(共通の要件を参照。監査/レビューのモードでのみ使用)。

関連スキル

  • shell-scripting - シェル構文、zsh または bash の動作、スクリプトの移植性
  • networking - ネットワークサービス、DNS、VPN、ファイアウォール設計
  • docker - ホストディストリビューションの管理ではなく、コンテナーランタイムとイメージに関する内容
  • kubernetes - ホスト OS の管理より上位に位置するクラスターとマニフェストの作業
  • ansible - 多数のマシンにわたる Linux の変更のコード化
  • security-audit - 通常のパッケージ/サービス管理ではなく、セキュリティ強化とセキュリティレビュー
  • rhel-fedora - Debian 系の動作ではなく、RPM 系ディストリビューションの管理
  • nixos - apt ベースの管理ではなく、NixOS と宣言型 Nix システムの管理
  • kali-linux - Kali 固有のブランチ、イメージ、攻撃ワークフローに関する内容
  • opnsense-pfsense - Linux ホストの管理ではなく、OPNsense と pfSense アプライアンスの作業
  • arch-linux - Arch Linux と CachyOS の管理(このスキルの上流にあたる着想元)
  • update-docs - 運用上の新たな注意点が生じる大規模なシステム管理変更の後に使用

ルール

  1. 影響の大きい変更を実行する前に確認してください。 コマンドと実行計画を正確に提示し、明示的な承認を待ってから実行し、その後に検証してください。無人実行では、計画の提示までで停止します。
  2. インストール済みの Ubuntu カーネル系列を特定してください。 HWE はデスクトップのデフォルトとしてインストールされる場合と、明示的に選択される場合があります。リリースに対応したメタパッケージを確認し、系列を変更する前にドライバーの互換性を検証してください。
  3. リリースを飛ばしてはいけません。 Debian と Ubuntu のアップグレードは、サポートされる手順を一段階ずつ進めてください(Ubuntu の LTS から LTS へのアップグレードは、サポートされる一段階です)。まず現在のリリースで full-upgrade を完了してください。

コメント