apt・dpkgのパッケージ管理 — installの失敗は3種類しかない

apt・dpkgのパッケージ管理。組み合わさるパッケージの箱と歯車、チェックリスト。

※本記事はアフィリエイト広告(PR)を含みます。

本線を書き終えたあと、しばらくは apt install が失敗するたびに、エラー文をそのまま検索していました。出てきた記事のコマンドをコピーして、直ったり直らなかったりする。 直ったときも、なぜ直ったのか分かっていませんでした。

前回: ディスクとファイルシステム fstab・LVM — 消しても空き容量が戻らない

これは深掘りです。本線の順路ではありません。 本線のパッケージ管理の回で apt update と apt upgrade が別物だと分かった人が、「エラーが出た瞬間に、どこを見ればいいのか分からない」ところで手が止まったときに読む記事です。飛ばしても本線は進みます。

この記事のコマンドは、すべて Ubuntu Server の中で打ちます。 Windows の PowerShell ではありません。 プロンプトが ユーザー名@ホスト名:~$ になっていれば、Linux の中にいます。 VM のスナップショットを取ってから始めてください。 この記事はわざと壊す手順を含みます。

apt の中身を追いかけて分かったのは、失敗する場所は3つしかないということです。

どこで失敗しているか症状の例見るもの
① リポジトリ(どこから取るか)Unable to locate package / 404 Not Foundapt-cache policy / sources.list
② 署名鍵(本物かどうか)NO_PUBKEY / not signed / GPG error/usr/share/keyrings / signed-by=
③ 依存(何が足りないか)dependency problems / unmet dependenciesapt -f install / dpkg -l

この3つのどれなのかを最初に決める、というだけで、調べる時間が桁で変わりました。この記事は、その3つをわざと1回ずつ起こして、順に潰します。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • dpkg は1つのファイルを入れるだけで、依存を解決しないこと。apt はその上に乗った「取ってくる係・順番を決める係」であること
  • リポジトリは「サーバー上のファイル置き場」ではなく、apt update が取ってくる索引ファイルのことであり、apt update が実際に何をダウンロードしているか
  • apt-key は非推奨で、いま検索して出てくる curl | sudo apt-key add - は使ってはいけないこと。鍵は /usr/share/keyrings に置いて signed-by= でそのリポジトリにだけ効かせること
  • dpkg -L と dpkg -S は逆向きの道具で、「このパッケージの中身は?」と「このファイルは誰の?」を往復できること
  • remove した後も設定ファイルは残り、dpkg -l では rc という見慣れない状態で残り続けること
  • /var/lib/dpkg/lock を手で消してはいけない理由が、慎重さの問題ではないこと

この記事でやること

  1. .deb を1つ手に入れて dpkg -i でわざと依存エラーを出し、apt -f install で直す
  2. sources.list と .sources の中身を読み、apt update の出力の1行1行が何を取っているかを照らし合わせる
  3. 署名鍵を /usr/share/keyrings に置き、signed-by= を書いたリポジトリを1つ足して消す
  4. apt-cache policy でバージョンを選び、apt-mark hold で固定して解除する
  5. dpkg -L / dpkg -S / apt-file で、「このコマンドはどのパッケージか」を両方向から解く
  6. 壊れた状態からの戻し方を確認し、作ったものを全部消す

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
dpkgDebian PacKaGe。.deb ファイル1個を展開して置くだけの低レイヤーのコマンド。ネットワークも依存解決もしない
aptdpkg の上に乗って、どこから取るか・どの順で入れるかを決める道具
索引(インデックス)リポジトリに「どのパッケージの何版があるか」を書いたファイル。apt update はこれだけを取ってくる
InRelease索引の目次にあたるファイル。署名が中に埋め込まれているので、これで改ざんを検出する
signed-by=そのリポジトリを、指定した1つの鍵でだけ検証するという書き方
.sources(deb822形式)1行に詰め込む旧来の書き方をやめ、項目ごとに行を分けた新しいリポジトリ設定の書式
apt-cache policyいま入っている版と、取れる候補の版が、どのリポジトリから来るかを並べて見せるコマンド
ピン(pin)どのリポジトリ・どの版を優先するかに点数を付けるしくみ
rc 状態remove 済みだが設定ファイルだけ残っているパッケージの状態
snapUbuntu が推す別のパッケージ形式。apt とは完全に別系統で、更新も置き場所も別

apt・apt-get・dpkg の関係

本線で「apt は人間向け、apt-get はスクリプト向け」と書きました。 それは正しいのですが、dpkg を入れて3つで並べないと、失敗の切り分けができません。

できることできないこと
dpkg手元にある .deb を1個、展開して置く。入っているものの一覧・中身の一覧ネットに取りに行かない。依存を解決しない。 足りなければ「足りない」と言って止まるだけ
apt-getリポジトリから取ってくる。依存を計算して、必要なものを全部集めて dpkg に渡す出力が素っ気ない(だからスクリプト向き)
aptapt-get と同じことを、進捗バーと色付きでやる。search や list も1つにまとまっている出力の形が版によって変わる。スクリプトに書くと将来壊れる

関係を1行で言うとこうです。

実際にファイルを置いているのは、いつも dpkg です。 apt は「どの .deb を、どの順番で dpkg に渡すか」を決めているだけです。

この構造が分かると、エラーの読み方が変わります。

  • E: で始まるメッセージは apt が言っている → リポジトリか鍵か、依存の計算で詰まった
  • dpkg: で始まるメッセージは dpkg が言っている → もう .deb を置く段階まで来ていて、そこで転んだ

まず、いまの版を見ておきます。

bash
$ apt --version
$ dpkg --version

確認: どちらもバージョンが返れば、3つとも最初から入っています。dpkg を入れる必要はありません。

① dpkg -i で、わざと依存エラーを出す

ここがこの記事の最初の山場です。 本線で「ネットで拾った .deb を入れてはいけない」と書きました。なぜいけないのかを、実際に転んで体で分かるようにします。

練習場を作る

bash
$ mkdir -p ~/lab-apt
$ cd ~/lab-apt
$ pwd

確認: pwd が /home/ユーザー名/lab-apt になっていれば準備完了です。

拾ってくるのではなく、正規の場所から1個だけ取る

検索して見つけた .deb をダウンロードするのは、この記事でもやりません。 練習には apt download を使います。これは「リポジトリから .deb ファイルだけを取ってきて、インストールはしない」コマンドです。

bash
$ sudo apt update
$ apt download nmap
$ ls -lh
nmap_7.94+git20230807.3be01efb1+dfsg-3build2_amd64.deb

sudo が要りません。 システムに何も入れていないからです。ファイルが1個、手元に落ちてきただけです。

nmap を選んだのは、依存パッケージが複数あって、素の Ubuntu Server にはそれが入っていないからです。 ネットワークを調べる道具ですが、この記事では入れて動かすことが目的ではありません。 ファイル名の数字は環境によって違います。以降は nmap_*.deb と書きます。

dpkg -i で入れてみる

bash
$ sudo dpkg -i nmap_*.deb
Selecting previously unselected package nmap.
(Reading database ... 74123 files and directories currently installed.)
Preparing to unpack nmap_7.94+git20230807.3be01efb1+dfsg-3build2_amd64.deb ...
Unpacking nmap (7.94+git20230807.3be01efb1+dfsg-3build2) ...
dpkg: dependency problems prevent configuration of nmap:
 nmap depends on nmap-common (>= 7.94+git20230807.3be01efb1+dfsg-3build2); however:
  Package nmap-common is not installed.
 nmap depends on liblua5.4-0 ...; however:
  Package liblua5.4-0 is not installed.

dpkg: error processing package nmap (--install):
 dependency problems - leaving unconfigured
Errors were encountered while processing:
 nmap

失敗しました。狙いどおりです。

この出力の読み方が本題です。

行意味
Unpacking nmap ...ファイルはもう置かれた(展開は終わっている)
dependency problems prevent configuration置いたが、設定(configure)まで進めなかった
Package ... is not installed足りないものの名前が、そのまま並んでいる
leaving unconfigured中途半端な状態のまま残した

dpkg は「足りない」と言うだけで、取りに行きません。 これが dpkg と apt の一番大きな違いです。 本線で「無限ループに入る」と書いたのは、この状態から足りないものを1個ずつ手で apt download して dpkg -i するという作業のことです。実際にやると、その依存にもまた依存があります。

中途半端な状態を見る

この時点で nmap は「入っている」のか「入っていない」のか。 どちらでもありません。

bash
$ dpkg -l nmap
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
||/ Name           Version         Architecture Description
+++-==============-===============-============-==========================
iU  nmap           7.94+...        amd64        the Network Mapper

先頭の2文字がすべてです。 ここを読めるようになると、パッケージ周りの調査が一気に楽になります。

文字位置意味
1文字目望まれている状態i = install したい / r = remove したい / h = hold(固定)
2文字目実際の状態i = 正常に入っている / U = 展開だけ済み(未設定) / c = 設定だけ残っている / n = 入っていない
3文字目エラー空なら問題なし

iU は「入れたいのに、展開までしか進んでいない」という意味です。この状態のパッケージがあると、以降のあらゆる apt 操作が同じエラーを出し続けます。

実際に確かめます。

bash
$ sudo apt install tree
You might want to run 'apt --fix-broken install' to correct these.
The following packages have unmet dependencies:
 nmap : Depends: nmap-common ... but it is not installed
E: Unmet dependencies. Try 'apt --fix-broken install' with no packages (or specify a solution).

関係ない tree を入れようとしただけで止まりました。 apt はシステム全体が矛盾していない状態でしか動きません。 「今日は急に apt が全部エラーになる」という症状は、たいてい過去に dpkg -i した何かが iU で残っているのが原因です。

[スクリーンショット: 01_dpkg依存エラー.png] sudo dpkg -i nmap_*.deb が dependency problems で失敗している画面と、その直後の dpkg -l nmap が iU を返している画面を撮ってください。この記事で一番重要な状態です。

apt -f install で直す

-f は --fix-broken の短い形です。

bash
$ sudo apt -f install
Correcting dependencies... Done
The following additional packages will be installed:
  liblinear4 liblua5.4-0 nmap-common
...
Setting up nmap (7.94+...) ...

「壊れている状態を検出して、足りないものを取ってきて、設定まで完了させる」という動きです。引数にパッケージ名を書かないのがポイントで、「何を直すか」は apt が自分で見つけます。

確認します。

bash
$ dpkg -l nmap | tail -n 1
ii  nmap  7.94+...  amd64  the Network Mapper

iU が ii になりました。 これで正常な状態です。

bash
$ sudo apt install tree

さっき止まった tree も通るようになります。

ここで理解したこと。 dpkg -i は「失敗するかもしれない操作」ではなく、「失敗したら、システム全体を巻き込んで止める操作」でした。 .deb を手で入れる正しいやり方は、dpkg -i ではなく apt install ./ファイル名.deb です。

試します。いったん消して、apt から入れ直します。

bash
$ sudo apt purge nmap nmap-common
$ sudo apt install ./nmap_*.deb

./ を付けるのが必須です。 これが無いと apt は「nmap_...deb という名前のパッケージ」をリポジトリに探しに行き、Unable to locate package と言います。

apt install ./ファイル なら、依存を先に集めてから入れます。 途中で止まりません。手元の .deb を入れるときは、必ずこの形を使ってください。

② リポジトリの正体 — apt update は何を取ってきているのか

本線で「apt update はカタログを取り寄せるだけ」と書きました。 そのカタログの実体を見ます。

どこを見に行くかが書いてある場所

2箇所あります。

bash
$ ls -l /etc/apt/sources.list /etc/apt/sources.list.d/
場所役割
/etc/apt/sources.list昔からある1枚のファイル。 Ubuntu 24.04 では中身が空(コメントだけ)になった
/etc/apt/sources.list.d/1リポジトリ=1ファイルで置くディレクトリ。追加はここに置く

ソフトを1つ入れるたびに sources.list の末尾に追記していくと、消すときに「どの行だったか」が分からなくなります。 ディレクトリに分けてあるのは、足すのも消すのもファイル単位でできるようにするためです。systemd のユニットを .d ディレクトリで足した回と同じ考え方です。

新しい形式(deb822 / .sources)

Ubuntu 24.04 では、標準のリポジトリ設定がこちらに移りました。

bash
$ cat /etc/apt/sources.list.d/ubuntu.sources
Types: deb
URIs: http://jp.archive.ubuntu.com/ubuntu/
Suites: noble noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

古い書き方だと、これが1行に詰め込まれていました。

deb [signed-by=/usr/share/keyrings/ubuntu-archive-keyring.gpg] http://jp.archive.ubuntu.com/ubuntu/ noble main restricted universe multiverse

同じ内容です。 項目ごとに行が分かれただけで、意味は1対1で対応しています。

項目1行形式での位置意味
Types:先頭の debdeb はバイナリ、deb-src はソース
URIs:URLどのサーバーから取るか
Suites:nobleUbuntu の版のコードネーム。 -updates は更新、-security はセキュリティ修正
Components:main restricted ...区画。 main は公式サポート、universe はコミュニティ管理
Signed-By:[signed-by=...]このリポジトリを検証する鍵ファイル

Suites: に noble と書いてあるのが、Ubuntu を「バージョンアップ」できない理由です。 ここの文字列を書き換えないと、次の版のパッケージは見えません。書き換えるコマンドが do-release-upgrade です。 手で書き換えないでください。 途中で失敗すると、iU どころではない状態になります。

apt update の出力を1行ずつ読む

apt-get update のほうが出力が素直なので、こちらで読みます。

bash
$ sudo apt-get update
Hit:1 http://jp.archive.ubuntu.com/ubuntu noble InRelease
Get:2 http://jp.archive.ubuntu.com/ubuntu noble-updates InRelease [126 kB]
Get:3 http://security.ubuntu.com/ubuntu noble-security InRelease [126 kB]
Get:4 http://jp.archive.ubuntu.com/ubuntu noble-updates/main amd64 Packages [512 kB]
Fetched 1,024 kB in 2s (512 kB/s)
Reading package lists... Done

先頭の単語が3種類しかありません。

先頭意味
Hit:前回から変わっていないので、取らずに済ませた
Get:変わっていたので、ダウンロードした
Ign:無視した(そのファイルが無い、など。必ずしもエラーではない)

InRelease と Packages の2種類が出ているのが分かります。

  • InRelease … 目次。 「このリポジトリには、どんな索引ファイルが、どのハッシュ値で存在するか」が書いてあり、署名がこのファイルの中に入っています
  • Packages … 本体の索引。 パッケージ名・版・依存関係・ダウンロード先が全部並んでいます

apt update の順番はこうです。

1. InRelease を取って、署名を検証する(ここで失敗すると ② 鍵の問題) 2. InRelease に書かれたハッシュ値と照らして、Packages を取る 3. 手元に保存する(/var/lib/apt/lists/)

apt install はネットに聞きに行きません。 ③ の保存済みファイルだけを見ます。だから「カタログが古い」と Unable to locate package になります。

保存先も見ておきます。

bash
$ ls /var/lib/apt/lists/ | head
$ du -sh /var/lib/apt/lists/

数十MBあります。 本線で「ディスクが減らない」ときの掃除先として autoremove を挙げましたが、sudo apt clean(ダウンロードした .deb の削除)も同じ用途です。索引のほうは消さないでください。 消しても apt update で戻りますが、その間 apt install が動かなくなります。

[スクリーンショット: 02_apt_update出力.png] sudo apt-get update の出力全体を撮ってください。Hit: と Get: が混ざっていて、InRelease と Packages の2種類が見えるのが読みどころです。

「① リポジトリ」の失敗はこう出る

Unable to locate package が出たときに見るのは、ここです。

bash
$ apt-cache policy nmap
nmap:
  Installed: 7.94+...
  Candidate: 7.94+...
  Version table:
 *** 7.94+... 500
        500 http://jp.archive.ubuntu.com/ubuntu noble/universe amd64 Packages

Candidate: が (none) になっていたら、そのパッケージはどのリポジトリにも見えていません。 Version table: が空なら、必要な Components:(universe など)が有効になっていないか、リポジトリを足していないということです。

③ 署名鍵 — apt-key を使ってはいけない

リポジトリを足すときの手順は、いまも昔もこの2つです。

  1. 鍵を置く(このリポジトリは本物だと検証するため)
  2. リポジトリの場所を書く

問題は、1のやり方が変わったのに、古いやり方を書いた記事がいまも大量に残っていることです。

使ってはいけない形

検索するとこれが山ほど出ます。

curl -fsSL https://例.example/gpg | sudo apt-key add -

この形は使わないでください。 apt-key は Ubuntu 22.04 で非推奨になり、現在の Ubuntu では動作しないか、警告を出します。

理由は「古いから」ではありません。

apt-key add で入れた鍵は、システム上の全リポジトリに対して有効になります。

つまり、あるソフトを入れるために足した鍵で、Ubuntu 公式リポジトリの署名まで検証が通ってしまいます。 その鍵の持ち主が悪意を持ったり、鍵が盗まれたりすると、「Ubuntu 公式の更新のふりをして、任意のパッケージを送り込む」ことが成立します。

打った本人は、そのソフト1つを足したつもりでいます。 実際にはシステム全体の信頼の輪に、1人追加していたわけです。

いまの正しい形

鍵を1ファイルとして置き、Signed-By: で「このリポジトリだけ、この鍵で検証する」と紐づけます。

練習として、Docker の公式リポジトリを1つ足して、消します。 Docker を入れた回で使ったものと同じ配布元です。この記事では Docker 本体は入れません。

まず、鍵を置くディレクトリを用意します。

bash
$ sudo install -m 0755 -d /usr/share/keyrings
場所用途
/usr/share/keyrings/配布物として置かれる鍵。 ディストリビューションやパッケージが置く
/etc/apt/keyrings/管理者が手で足した鍵。 新しい手順書はこちらを使うことが多い

どちらでも動きます。 /etc/ は「このマシンの設定」、/usr/share/ は「配られてきたもの」という置き場所の考え方の違いです。この記事では、本線のディレクトリの回に合わせて /usr/share/keyrings を使います。

鍵を取ってきます。

bash
$ sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /usr/share/keyrings/lab-docker.asc
$ sudo chmod a+r /usr/share/keyrings/lab-docker.asc
$ ls -l /usr/share/keyrings/lab-docker.asc
オプション意味
-fHTTP エラーのときに中身を保存しない(エラーページを鍵として保存しないため)
-s進捗を出さない
-S-s を付けていても、エラーだけは出す
-Lリダイレクトを追う
-o ファイルパイプで渡さず、ファイルに保存する

curl | sudo コマンド という形そのものを避けてください。 落としたものを見ないまま実行する形になっているからです。 -o でファイルに落とし、中身を見てから使う。 これだけで危険度が変わります。

中身を確認します。

bash
$ head -n 2 /usr/share/keyrings/lab-docker.asc
$ gpg --show-keys /usr/share/keyrings/lab-docker.asc
-----BEGIN PGP PUBLIC KEY BLOCK-----

pub   rsa4096 2017-02-22 [SCEA]
      9DC858229FC7DD38854AE2D88D81803C0EBFCD88
uid   Docker Release (CE deb) <docker@docker.com>

gpg --show-keys は、鍵の持ち主と指紋(長い16進数)を表示するだけで、何もシステムに登録しません。 配布元のサイトに載っている指紋と見比べる、というのが本来の手順です。

ここでエラーが出たら、鍵ではなくエラーページを保存しています。 head の1行目が -----BEGIN PGP PUBLIC KEY BLOCK----- でなければ、その時点で止めてください。

リポジトリを足す

新しい .sources 形式で書きます。

bash
$ sudo tee /etc/apt/sources.list.d/lab-docker.sources > /dev/null <<'EOF'
  Types: deb
  URIs: https://download.docker.com/linux/ubuntu
  Suites: noble
  Components: stable
  Architectures: amd64
  Signed-By: /usr/share/keyrings/lab-docker.asc
  EOF
$ cat /etc/apt/sources.list.d/lab-docker.sources

Suites: noble は、自分の Ubuntu のコードネームです。 別の版なら書き換えてください。確認はこれです。

bash
$ . /etc/os-release; echo "$VERSION_CODENAME"

反映します。

bash
$ sudo apt update
Get:5 https://download.docker.com/linux/ubuntu noble InRelease [48.8 kB]
Get:6 https://download.docker.com/linux/ubuntu noble/stable amd64 Packages [40.1 kB]

追加したリポジトリの行が増えていれば成功です。 見えるようになったかを確認します。

bash
$ apt-cache policy docker-ce
docker-ce:
  Installed: (none)
  Candidate: 5:27...~ubuntu.24.04~noble
  Version table:
     5:27...~ubuntu.24.04~noble 500
        500 https://download.docker.com/linux/ubuntu noble/stable amd64 Packages

Installed: (none) のまま、Candidate: に版が出ました。 「リポジトリが見えている」と「入れた」は別、というのがはっきり分かります。この記事では入れません。

鍵が合っていないとどうなるか

②の失敗を、わざと1回だけ起こします。 Signed-By: の行を、Ubuntu 公式の鍵に差し替えます。

bash
$ sudo sed -i 's|^Signed-By:.*|Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg|' /etc/apt/sources.list.d/lab-docker.sources
$ sudo apt update
Err:5 https://download.docker.com/linux/ubuntu noble InRelease
  The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 8D81803C0EBFCD88
E: The repository 'https://download.docker.com/linux/ubuntu noble InRelease' is not signed.
N: Updating from such a repository can't be done securely, and is therefore disabled by default.

本線で見た NO_PUBKEY です。 意味がはっきりしました。

NO_PUBKEY は「鍵が壊れている」ではなく、「そのリポジトリを検証できる鍵を、こちらが持っていない」という意味です。 出てくる16進数は必要な鍵のIDです。リポジトリを足した手順書の、鍵の部分をやり直せば直ります。

is not signed と言われた後、apt はそのリポジトリを丸ごと無視します。 「足したのに Unable to locate package と言われる」という症状は、その少し上に赤い Err: が出ていることが多いです。apt update の出力を最後の1行だけ見て流さないでください。

戻します。

bash
$ sudo sed -i 's|^Signed-By:.*|Signed-By: /usr/share/keyrings/lab-docker.asc|' /etc/apt/sources.list.d/lab-docker.sources
$ sudo apt update

確認: Err: が消えていれば戻っています。

[スクリーンショット: 03_NO_PUBKEY.png] Signed-By: を差し替えた状態の sudo apt update で、NO_PUBKEY と is not signed が出ている画面を撮ってください。

④ バージョンを選ぶ

apt install は、いつも「候補(Candidate)」を入れます。 その候補が誰なのかを決めているのが apt-cache policy の中身です。

いま何が見えているか

bash
$ apt-cache policy tree
tree:
  Installed: 2.1.1-2ubuntu3
  Candidate: 2.1.1-2ubuntu3
  Version table:
 *** 2.1.1-2ubuntu3 500
        500 http://jp.archive.ubuntu.com/ubuntu noble/universe amd64 Packages
        100 /var/lib/dpkg/status
行読み方
Installed:いま入っている版。入っていなければ (none)
Candidate:apt install したら入る版
***いま入っている版に付く印
左の数字(500)優先度(ピン)。大きいほうが勝つ
100 /var/lib/dpkg/status「すでに入っているもの」自体の優先度。だから既存のものは勝手に下げられない

版を指定して入れる

bash
$ apt-cache policy nmap
$ sudo apt install nmap=7.94+git20230807.3be01efb1+dfsg-3build2

= の右側は、Version table: に出ている文字列をそのまま貼ります。 一文字でも違うと Version ... not found になります。

古い版に戻すのを「ダウングレード」と言いますが、apt はこれを歓迎しません。 依存している他のパッケージが新しい版を要求していると、まとめて巻き戻すことになり、大量の変更一覧が出ます。 一覧を読まずに Y を押さないでください。

固定する(hold)

「このパッケージだけは apt upgrade で勝手に上げてほしくない」というときに使います。

bash
$ sudo apt-mark hold nmap
$ apt-mark showhold
nmap

固定されているかを見ます。

bash
$ dpkg -l nmap | tail -n 1
hi  nmap  7.94+...  amd64  the Network Mapper

1文字目が i から h に変わりました。 さきほどの表の「望まれている状態」が hold になった、ということです。

解除します。

bash
$ sudo apt-mark unhold nmap
$ apt-mark showhold

確認: apt-mark showhold が何も返さなければ解除されています。

hold は忘れます。 半年後に「このサーバーだけセキュリティ更新が当たっていない」という形で出てきます。 hold したら、その理由をどこかに書いてください。 サーバーを引き継ぐときは、apt-mark showhold を必ず打つ、と決めておくと事故が減ります。

優先度(pin)を1段落で

複数のリポジトリに同じパッケージがあるとき、どちらを使うかを点数で決めるのがピンです。 設定は /etc/apt/preferences.d/ に1ファイルとして置き、Package:(対象)・Pin:(どのリポジトリか)・Pin-Priority:(点数)の3行を書きます。既定は 500 で、1000 を超えるとダウングレードもしてよい、100 未満(0 より大きい)は「まだ入っていないときだけ入れてよい」、0 未満は「その版を入れない」という意味になります。外部リポジトリを足したときに、そこから全部が入ってきてしまうのを防ぐのが主な用途です。ただしピンは、症状が「なぜかこの版が入らない」という形でしか出ないため、非常に追いにくい設定です。まずピンを書かずに済ませられないかを考えてください。 この記事では作りません。

⑤ 何が入っているのか調べる — dpkg -L と dpkg -S

ここが2つ目の山場です。 実務で一番使うのに、本線では触れませんでした。

知りたいことは、いつもこの2つのどちらかです。

知りたいこと道具向き
このパッケージは、どこに何を置いたのかdpkg -Lパッケージ → ファイル
このファイルは、どのパッケージが置いたのかdpkg -Sファイル → パッケージ
まだ入れていないが、このコマンドはどのパッケージに入っているのかapt-file searchファイル → パッケージ(未インストール可)

パッケージ → ファイル

bash
$ dpkg -L tree
/usr
/usr/bin
/usr/bin/tree
/usr/share/doc/tree
/usr/share/man/man1/tree.1.gz

「入れたのに、設定ファイルがどこにあるか分からない」ときは、これで一発です。

設定ファイルだけ見たいときは絞ります。

bash
$ dpkg -L nmap | grep -v '^/usr/share/\(man\|doc\)'

conffiles(そのパッケージが「設定ファイル」として登録したもの)だけを見ることもできます。

bash
$ dpkg-query --show --showformat='${Conffiles}\n' nmap

ここに載っているファイルが、remove しても残るものです。 ⑥ でもう一度出てきます。

ファイル → パッケージ

「このコマンドは、どのパッケージから来たのか」を解く型です。

bash
$ which tree
$ dpkg -S /usr/bin/tree
tree: /usr/bin/tree

2行を1行にできます。

bash
$ dpkg -S $(which tree)

素の Ubuntu にあるコマンドでも試してください。

bash
$ dpkg -S $(which ss)
$ dpkg -S $(which ip)
iproute2: /usr/bin/ss
iproute2: /usr/sbin/ip

ss と ip が同じ iproute2 から来ていると分かります。 本線のネットワークの回で両方を使いましたが、あれは1パッケージだったわけです。

dpkg -S は「入っているファイル」しか答えられません。 入っていないコマンドを渡すと no path found matching pattern と返ります。 設定ファイルを直すときの型はこれです。

dpkg -S $(which 対象のコマンド)     # どのパッケージか
dpkg -L 出てきたパッケージ名          # 何を置いたか

2行で、公式にどこへ何が置かれるかが確定します。 検索して出てきたブログのパスを信じるより速くて確実です。

入っていないコマンドを逆引きする(apt-file)

command not found と言われたとき、Ubuntu は親切に候補を出してくれることがあります。

bash
$ htop
Command 'htop' not found, but can be installed with:
sudo apt install htop

これが出ないこともあります。 出ないとき、あるいはコマンドではなくライブラリやヘッダファイルを探しているときに使うのが apt-file です。

bash
$ sudo apt install apt-file
$ sudo apt-file update

apt-file update は、apt update とは別の索引を取ります。 「どのパッケージが、どのファイルを含むか」という、中身のファイル一覧です。数十MBあるので少し時間がかかります。

bash
$ apt-file search bin/htop
htop: /usr/bin/htop

まだ入れていないのに、htop は htop パッケージに入っていると分かりました。

本当に効くのは、ビルドで詰まったときです。

bash
$ apt-file search /usr/include/zlib.h
zlib1g-dev: /usr/include/zlib.h

fatal error: なんとか.h: No such file or directory は、初学者が最も多く踏むビルドエラーです。 apt-file search そのファイル名 を打てば、入れるべきパッケージ名が出ます。 末尾が -dev のパッケージは「開発用の材料(ヘッダやリンク用ファイル)」で、動かすだけなら要らないが、コンパイルするときだけ要るものです。

[スクリーンショット: 04_dpkg逆引き.png] dpkg -S $(which ss) が iproute2 を返している画面と、apt-file search /usr/include/zlib.h が zlib1g-dev を返している画面を撮ってください。

⑥ 消し方の違い — remove した後に残るもの

本線で「remove は設定を残す、purge は消す」と書きました。 深掘りとして、残ったものがどう見えるかを確かめます。

bash
$ sudo apt remove nmap
$ dpkg -l nmap | tail -n 1
rc  nmap  7.94+...  amd64  the Network Mapper

rc です。 表に戻ると、r = remove したい、c = 設定ファイルだけ残っている、という意味でした。

「消したはずなのに一覧に出てくる」のは、これです。 実際に残っているファイルも見られます。

bash
$ dpkg-query --show --showformat='${Conffiles}\n' nmap

システム全体で rc のものを数えます。

bash
$ dpkg -l | grep '^rc'

長く使ったサーバーだと、驚くほど並びます。 「昔入れて消したもの」の設定が、全部残り続けています。

まとめて消せます。

bash
$ dpkg -l | grep '^rc' | awk '{print $2}'

まず一覧を見てから、消します。

bash
$ dpkg -l | grep '^rc' | awk '{print $2}' | xargs -r sudo apt purge -y

本線の深掘りで書いた「rm の前に echo を挟む」と同じ型です。 xargs に渡す前の行を1回そのまま実行して、何が渡るのかを目で見てからパイプを繋げます。

3つの違いを、最終形で整理します。

コマンドプログラム本体設定ファイル一緒に入った依存dpkg -l での状態
apt remove消す残す残すrc
apt purge消す消す残す何も出ない
apt autoremove——「誰にも必要とされていないもの」を消す—

purge でも依存は残ります。 両方やるならこうです。

bash
$ sudo apt purge nmap
$ sudo apt autoremove --purge

--purge を付けると、autoremove が消すものも設定ごと消します。

注意が1つあります。 purge はそのパッケージが conffiles として登録したファイルだけを消します。自分で後から作ったファイルや、プログラムが動きながら作ったデータ(データベースの中身など)は残ります。 「purge したのに古いデータが出てくる」ときは、/var/lib/パッケージ名/ を見てください。そこは purge の対象外です。

⑦ snap との違い

Ubuntu には apt とは別に、snap というパッケージのしくみが最初から入っています。 本線で入れたものが、実は snap だったかもしれません。確認します。

bash
$ snap list
Name    Version   Rev    Tracking       Publisher   Notes
core22  20240823  1663   latest/stable  canonical✓  base
lxd     5.21.2    31333  5.21/stable    canonical✓  -
snapd   2.63      21759  latest/stable  canonical✓  snapd

Ubuntu Server の初期状態でも、いくつか入っています。 apt の一覧(apt list --installed)には出てきません。完全に別系統です。

apt(deb)snap
依存共有する。 ライブラリは1つを皆で使う中に全部同梱する。 だからサイズが大きい
置き場所/usr/bin など、通常の場所/snap/ の下(which で見ると /snap/bin/...)
更新apt upgrade を打ったときだけ勝手に自動更新される
版の固定apt-mark holdsnap refresh --hold
消すapt purgesnap remove

一番の落とし穴は「Desktop 版で apt install firefox を打つと、実際には snap が入る」ことです。 deb パッケージが「snap を入れるための中継ぎ」に置き換わっているためです。Server 版ではこれは起きません。

which コマンド名 の結果が /snap/bin/ から始まっていたら、それは snap です。 dpkg -S を打っても no path found と返ります。dpkg -S が見つけられないコマンドがあったら、まず snap list を疑ってください。 どちらが良いという話ではありません。 ただ、更新のされ方が違うものが同じサーバーに混ざっていることは知っておく必要があります。

⑧ 壊れたときの直し方

症状ごとに、打つものは決まっています。 覚えるのは3つです。

依存が欠けている

bash
$ sudo apt --fix-broken install

apt -f install と同じです。 ①でやったものです。足りないものを取ってきて、設定まで完了させます。

展開は済んだが設定できていない(iU が残る)

bash
$ sudo dpkg --configure -a

-a は「未設定のもの全部」です。 ネットには取りに行かず、手元にあるものの設定処理だけをやり直します。

「更新の途中で電源が落ちた」「Ctrl + C で止めた」あとに出るのがこの状態です。本線で「Ctrl + C を押さないでください」と書いたのは、この後始末が要るからです。

順番はこうです。

1. sudo dpkg --configure -a(手元の後始末) 2. sudo apt --fix-broken install(足りないものを取ってくる) 3. sudo apt update && sudo apt upgrade

1と2は逆にしないでください。 未設定のものが残っていると、2が同じところで止まります。

ロックが取れない

Could not get lock /var/lib/dpkg/lock-frontend

本線で「ロックファイルを手で消すと壊れる」と書きました。理由を書きます。

ロックファイルは、ファイルがあることで排他しているのではありません。 fcntl のレコードロック(F_SETLK)というしくみで、「そのファイルを開いているプロセスが生きている間だけ」ロックが成立します。

つまり、

ロックが取れないということは、いま dpkg か apt を動かしているプロセスが本当に生きている、ということです。

ファイルを消しても、動いているプロセスは止まりません。 消した結果、2つの dpkg が同時に同じデータベースを書き換えます。 そうなると、dpkg --configure -a でも直りません。

正しい順番はこれです。

bash
$ ps aux | grep -E 'apt|dpkg' | grep -v grep

まず、誰が握っているかを見ます。

見えたもの対応
unattended-upgradeUbuntu の自動セキュリティ更新。 数分待てば終わる
apt-get update(apt-daily)定期実行。 待つ
何も出ないプロセスが死んで、ロックだけ残った可能性

何も出ないときだけ、次に進みます。

bash
$ sudo fuser -v /var/lib/dpkg/lock-frontend

これも何も返さなければ、ロックを握っているプロセスはいません。ここでようやく、

bash
$ sudo rm /var/lib/dpkg/lock-frontend /var/lib/dpkg/lock
$ sudo dpkg --configure -a

「待つ」→「ps で見る」→「fuser で確かめる」→ それでも駄目なら消す。 この順番を飛ばして最初から rm を打つのが、壊し方です。

本当に消していい場面は、実際にはほとんどありません。 自分がこれまで遭遇したロックは、全部 unattended-upgrade で、2〜3分待てば消えました。

[スクリーンショット: 05_ロック確認.png] ps aux | grep -E 'apt|dpkg' | grep -v grep の出力を撮ってください。何も動いていない状態でも構いません。 「まず見る」という手順そのものが要点です。

最後の手段

それでも直らないときは、状態を出力して読みます。

bash
$ sudo apt-get check

依存関係の整合性だけを検査します。 何も出なければ健全です。

apt のデータベース自体は /var/lib/dpkg/ にあり、直前の状態が /var/lib/dpkg/status-old に残っています。 ただしここを手で書き換えるのは、修復ではなく破壊です。 VM ならスナップショットに戻すほうが、はるかに速くて確実です。

つまずいたところ

dpkg -i で入れて失敗したあと、その日はずっと apt が動きませんでした。 apt install を打つたびに、まったく関係ないパッケージの名前でエラーが出る。「apt が壊れた」と思って、リポジトリの設定を疑って何時間か使いました。

実際には、dpkg -l の先頭2文字を読めていなかっただけでした。iU が1つ残っている、というだけの話です。エラー文の最後の行に apt --fix-broken install と書いてあったのに、その1行を読んでいませんでした。エラーは下から読む、という本線のエラーの読み方の回を、自分でやっていなかったということです。

署名鍵は、もっと長く間違えていました。 別のソフトを入れるときに、検索して出てきた curl ... | sudo apt-key add - をそのまま打っていました。警告が出ていたのですが、「動いたからいい」で流していました。 危険なのは「古い書き方だから」ではなく、足した鍵が全リポジトリに効くからだと知ったのは、この記事を書くために調べたときです。動いていたので、間違いに気付く機会がありませんでした。

dpkg -S は、知ってから世界が変わりました。 それまでは「この設定ファイルはどこ?」を検索していました。バージョンやディストリビューションが違う記事のパスを試して、無くて、また検索する、という時間を延々と使っていました。手元のマシンに答えが入っていたわけです。

snap にも一度はまりました。 あるコマンドについて dpkg -S を打ったら no path found と返り、「入っていないはずがない」と混乱しました。which を打ったら /snap/bin/ から始まっていて、そもそも apt の管理下に無かったと分かりました。apt list --installed に出ないものが動いている、という状況を想像できていませんでした。

ロックは、1度だけ rm しました。 幸い何も壊れませんでしたが、あとで fcntl によるロックのしくみを知って運が良かっただけだと分かりました。いまは ps aux を打って unattended-upgrade の文字を見つけ、待つようにしています。

後片づけ

足したリポジトリ・鍵・パッケージを、逆順に全部消します。 リポジトリと鍵を残しておくと、忘れた頃に apt update が謎のエラーを出す原因になります。

まず、何を作ったかを目で見ます。

bash
$ ls /etc/apt/sources.list.d/
$ ls /usr/share/keyrings/
$ apt-mark showhold
$ ls ~/lab-apt

リポジトリと鍵を消す

bash
$ sudo rm /etc/apt/sources.list.d/lab-docker.sources
$ sudo rm /usr/share/keyrings/lab-docker.asc
$ sudo apt update

確認: apt update の出力に download.docker.com の行が出なくなり、Err: も出ていなければ成功です。

入れたパッケージを消す

bash
$ sudo apt purge nmap nmap-common apt-file
$ sudo apt autoremove --purge

apt-file を消すと、apt-file update で取った索引も一緒に消えます。 残しておいても害はありません。 使う予定があるなら、apt-file だけ外して構いません。

tree はこの記事でも使ったので、本線と同じく残して構いません。

固定と残骸を確認する

bash
$ apt-mark showhold
$ dpkg -l | grep '^rc'
$ dpkg -l nmap

確認: apt-mark showhold が何も返さず、dpkg -l nmap が no packages found matching nmap と返れば、跡形もありません。

練習場と、ダウンロードした .deb を消す

bash
$ ls ~/lab-apt
$ rm -rf ~/lab-apt
$ sudo apt clean

apt clean は、/var/cache/apt/archives/ に溜まったダウンロード済みの .deb を消します。 索引(/var/lib/apt/lists/)は消しません。ディスクが減ったときに最初に打つコマンドです。 減り具合はディスクの深掘り回の du で確かめられます。

最後に、健全な状態に戻ったことを確認します。

bash
$ sudo apt-get check
$ sudo apt update

両方ともエラーを出さなければ、片づけ完了です。

まとめ

  • apt install が失敗する場所は3つしかない。 ① リポジトリ(どこから取るか)・② 署名鍵(本物か)・③ 依存(何が足りないか)。まずどれかを決める
  • 実際にファイルを置いているのは、いつも dpkg。 apt は「どの .deb を、どの順で dpkg に渡すか」を決めているだけ
  • E: は apt の言葉、dpkg: は dpkg の言葉。 後者が出ていれば、もう .deb を置く段階まで来ている
  • dpkg -i は失敗すると iU(展開だけ済み)で止まり、以降のあらゆる apt 操作を巻き込んで止める
  • dpkg -l の先頭2文字を読む。 ii = 正常、iU = 展開だけ、rc = 設定だけ残っている、hi = 固定中
  • 直すのは sudo apt -f install(= --fix-broken)。 引数は要らない。壊れている場所は apt が自分で見つける
  • 手元の .deb を入れるなら dpkg -i ではなく apt install ./ファイル名.deb。 ./ が必須
  • apt update が取ってくるのは索引だけ。 InRelease(署名入りの目次)→ Packages(索引本体)の順で、/var/lib/apt/lists/ に保存する
  • apt install はネットに聞かない。 保存済みの索引だけを見る。だから古いと Unable to locate package
  • Hit: は変わっていない、Get: は取った、Ign: は無視した。 Err: を見逃さない
  • リポジトリの追加は sources.list.d/ に1ファイル。 新しい .sources 形式は、1行形式と項目が1対1で対応している
  • curl | sudo apt-key add - は使わない。 理由は古いからではなく、その鍵が全リポジトリに効いてしまうから
  • 鍵は -o でファイルに落とし、中身を見てから Signed-By: で1つのリポジトリに紐づける
  • NO_PUBKEY は「鍵が無い」。 その後 apt はそのリポジトリを丸ごと無視するので、足したのに見つからないという症状になる
  • apt-cache policy で Installed / Candidate / どのリポジトリ由来かが読める。 Candidate: (none) なら ① の問題
  • apt-mark hold は忘れる。 引き継ぎのときは apt-mark showhold を必ず打つ
  • dpkg -L(パッケージ→ファイル)と dpkg -S(ファイル→パッケージ)は逆向きの道具。 dpkg -S $(which コマンド) → dpkg -L 出てきた名前 の2行で、公式の置き場所が確定する
  • 入れていないものは apt-file search。 No such file or directory のヘッダ名をそのまま渡すと、入れるべき -dev パッケージが出る
  • remove の残骸は dpkg -l | grep '^rc' で全部見える。 purge でも /var/lib/パッケージ名/ のデータは残る
  • snap は完全に別系統。 which が /snap/bin/ から始まるなら dpkg -S では見つからない。更新のされ方も違う
  • 壊れたら dpkg --configure -a → apt --fix-broken install の順。 逆にすると止まる
  • /var/lib/dpkg/lock を消さない。 ロックは fcntl のロックで成立していて、取れない=本当に誰かが動いている。「待つ」→「ps aux」→「fuser」の順で確かめる

リポジトリや署名鍵を足して消す練習は、本線で使っている VM とは別の、壊してよいサーバーに分けておくと後片づけが楽です。クラウド VPS byGMOのように初期費用 0 円の定額制 VPS を短期間だけ借りて、この記事の①〜③を一通り試す方法があります。2026-11 時点で、初めての申し込みなら 1GB/2GB/4GB プランに 15 日間の無料お試しがありますが、最終日の 2 営業日前までに解約しないと自動で本契約になり、表示月額とは別にサーチャージ費もかかります。

参考リンク


次に読む

この記事は 【深掘り】Linux の 10 / 18 本目です。

記事
← 前の記事RAIDと世代バックアップの違い — 冗長化では守れないもの
→ 次の記事IPアドレスとサブネット・経路 — /24が読めないと直せない

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›Linux — Package Management
  • apt / apt-get / dpkg の関係と依存解決
  • リポジトリ・署名鍵・バージョン固定

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次