debian-ubuntu について
Debian、Ubuntu とその派生ディストリビューションのシステム管理スキルです。パッケージ、起動、デスクトップ、ハードウェア、セキュリティの作業を対象とし、環境を特定してから変更と検証を進めます。
主な機能
- 01apt、dpkg、PPA の管理
- 02systemd、起動、カーネルのトラブル対応
- 03デスクトップ、音声、グラフィックス、ハードウェアの対応
- 04リリース更新とセキュリティ更新の管理
- 05ディストリビューションごとの前提確認
活用シーン
- 01Debian システムのパッケージやサービス障害を調査
- 02Ubuntu のアップグレード、カーネル、ドライバーを保守
- 03Mint、Pop!_OS など派生環境の違いに対処
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ iuliandita/ skills --skill debian-ubuntuインストール後、Claude Code で/debian-ubuntuを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/agent-hygiene.mdbase-linux-and-cli.mdboot-kernel-and-recovery.mdcapture-and-sharing.mdderivatives-and-hwe.mddesktop-audio-and-bluetooth.mdgotchas-and-special-situations.mdgraphics-and-gaming.mdoutput-contract.mdpackages-and-repos.mdremote-gaming-input-and-tooling.mdsecurity-and-updates.mdsession-display-and-mobile.mdstorage-and-rollback.mdsystemd-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 stable | 13(trixie) | 現在の stable の基準およびリポジトリの動作 |
| Ubuntu LTS | 26.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 & UpdatesGUI がデフォルトで存在すると決めつけないでください。 - 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 Mint | Ubuntu LTS の派生版 | Cinnamon/XFCE を重視しています。Mint 固有のリポジトリとアップデートマネージャーがあります。Ubuntu の PPA は多くの場合動作します。 |
| Pop!_OS | 追加機能を備えた Ubuntu 派生版 | System76 のファームウェア、COSMIC デスクトップ、Pop のリポジトリ、system76-power を備えています。NVIDIA 用 ISO も利用できます。 |
| Devuan | サービスモデルが大きく異なる Debian 派生版 | systemd、systemctl、Ubuntu 形式のデスクトップ/セッション管理機構があると想定しないでください。まず init とサービス管理ツールを確認してください。 |
| Kali | Debian 派生のセキュリティディストリビューション | 基本的な 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、PipeWire | references/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 つのレイヤーを変更し、その都度再テストします。
- 調整を積み重ねるより、正常動作が確認済みのベースラインを優先します。
基本的なログの確認:
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 & UpdatesGUI は新規インストール時にデフォルトではインストールされなくなりました。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-purgereferences/systemd-and-journal.md- systemd サービスのデバッグ、ユニットのオーバーライド、ユーザーユニット、journal のトリアージreferences/boot-kernel-and-recovery.md- GRUB、カーネルメタパッケージ、initramfs、EFI、リカバリー、ライブ ISO での chrootreferences/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、Bluetoothreferences/session-display-and-mobile.md- ディスプレイマネージャー、セッション起動、サスペンド/レジューム、電源に関する最初のチェック項目references/graphics-and-gaming.md- NVIDIA、AMD、Intel、Vulkan、Steam、Proton、Gamescope、MangoHudreferences/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 - 運用上の新たな注意点が生じる大規模なシステム管理変更の後に使用
ルール
- 影響の大きい変更を実行する前に確認してください。 コマンドと実行計画を正確に提示し、明示的な承認を待ってから実行し、その後に検証してください。無人実行では、計画の提示までで停止します。
- インストール済みの Ubuntu カーネル系列を特定してください。 HWE はデスクトップのデフォルトとしてインストールされる場合と、明示的に選択される場合があります。リリースに対応したメタパッケージを確認し、系列を変更する前にドライバーの互換性を検証してください。
- リリースを飛ばしてはいけません。 Debian と Ubuntu のアップグレードは、サポートされる手順を一段階ずつ進めてください(Ubuntu の LTS から LTS へのアップグレードは、サポートされる一段階です)。まず現在のリリースで
full-upgradeを完了してください。