teeコマンドの使い方:標準入力を画面表示しつつファイルにも保存する

teeは、受け取った内容を画面に表示しながら、同時にファイルにも保存するコマンドです。コマンドの実行結果を、確認しつつ記録に残したい場面や、管理者権限が必要なファイルへ書き込む場面で使います。

teeの仕組みと基本の考え方

コマンドの出力は、通常、画面に表示されるか、リダイレクトでファイルに保存されるかの、どちらか一方です。teeは、標準入力から受け取った内容を、標準出力(画面や、次のコマンド)と、指定したファイルの両方に、同じ内容で書き出します。

パイプの途中に置けることも、teeの特徴です。コマンドA | tee 途中経過.txt | コマンドBのように書くと、加工の途中の状態をファイルに残しつつ、処理を続けられます。複雑なパイプラインの、どの段階で想定と違う結果になっているかを調べるときに役立ちます。

sudoと組み合わせる使い方が多いのは、シェルの仕組みによるものです。sudo コマンド > ファイルと書いても、>でファイルを開くのは、sudoではなく元のシェルです。teeというコマンド自体をsudoで実行すれば、ファイルを開く処理も、管理者権限で行われます。

teeのよく使う形

実務や学習で登場しやすい使い方を、そのまま入力できる形でまとめました。

コマンド例内容
ls -l | tee list.txt結果を画面に表示しつつ、ファイルにも保存する
ls -l | tee -a list.txtファイルの末尾に追記する
echo text | sudo tee /etc/file.conf管理者権限が必要なファイルに書き込む
echo text | sudo tee -a /etc/hosts管理者権限が必要なファイルに追記する
command 2>&1 | tee log.txtエラー出力も含めて、表示と保存を行う
command | tee a.txt b.txt複数のファイルに、同時に保存する

teeの主なオプション

オプション意味
-a追記モード(既定は上書き)

teeの実行例と結果の読み方

echo 'nameserver 1.1.1.1' | sudo tee -a /tmp/resolv.test、cat /tmp/resolv.test を順に実行した結果です。表示の意味は、画面の下の「出力の読み方」で項目ごとに説明しています。

$ echo 'nameserver 1.1.1.1' | sudo tee -a /tmp/resolv.test
nameserver 1.1.1.1
$ cat /tmp/resolv.test
nameserver 1.1.1.1

出力の読み方

表示・項目意味
nameserver 1.1.1.1(1行目)tee は、受け取った内容を画面にも表示する
-a上書きせずに、ファイルの末尾に追記する
sudo teeroot しか書けないファイルに書き込む定番の形。sudo echo … > ファイル では書き込めない

練習用ターミナルでは、teeをブラウザ上で安全に試せます。

teeの実務での使いどころ

作業の内容を、証跡として残しながら実行する

sudo apt update 2>&1 | tee ~/work_$(date +%Y%m%d).log

実行結果を、画面で確認しながら、日付付きのログにも保存します。あとから作業の内容を見返したり、報告に使ったりできます。

管理者権限が必要な設定ファイルに、1行追記する

echo '192.0.2.10 web01' | sudo tee -a /etc/hosts

/etc/hostsのような、rootが所有するファイルへの追記の定番です。-aを付け忘れると、ファイルの内容が置き換わってしまうため、注意が必要です。

teeを組み合わせて使う実践例

パイプラインの途中経過を、保存する

grep ERROR app.log | tee errors.txt | wc -l

エラーの行をファイルに保存しつつ、件数も数えます。保存と集計を、1回の処理で済ませられます。

複数行の設定を、管理者権限で書き込む

sudo tee /etc/sysctl.d/99-custom.conf > /dev/null <<'EOF'
net.ipv4.ip_forward = 1
vm.swappiness = 10
EOF

ヒアドキュメントと組み合わせると、複数行の設定ファイルを、管理者権限で作成できます。構築用の手順書やスクリプトで、よく使われる書き方です。

似たコマンドとの違い・使い分け

>と>>は、保存だけを行うリダイレクトです。teeとtee -aが、それぞれに対応します。作業の全体を記録したい場合は、端末の入出力をまとめて保存するscriptコマンドも使えます。

実際の出力を並べると、違いがつかみやすくなります。

・echo

文字列や変数の値を出力する。

$ echo test > /tmp/redirect.txt && cat /tmp/redirect.txt
test

teeを使うときの注意点

teeは、既定ではファイルを上書きします。既存の内容を残して追記したい場合は、-aを付けます。設定ファイルに1行足すつもりで-aを忘れると、元の内容がすべて消えてしまいます。

パイプで渡されるのは、標準出力だけです。エラーメッセージも保存したい場合は、2>&1を付けて、標準エラー出力も一緒に渡します。

teeでよくある失敗と対処

-aを付け忘れて、設定ファイルを上書きした

teeは、既定で上書きします。追記には、必ず-aを付けます。重要なファイルは、事前にバックアップを取っておきましょう。

エラーメッセージが、ファイルに保存されていなかった

パイプに流れるのは、標準出力だけです。2>&1を、|の前に付けます。

teeで困ったときの症状別チェック

実際の現場で出会いやすい症状を、原因の見当と確認方法とあわせて、逆引きできる形にまとめました。

症状考えられる原因確認・対処
Permission deniedと表示される書き込み先のファイルに、権限がないsudo teeの形にします。
ファイルの内容が、消えてしまった-aを付けずに、実行したバックアップから復元します。追記には、-aを付けます。
エラーメッセージが、保存されない標準エラー出力が、パイプに渡されていない2>&1 |の形にします。
表示が、少し遅れて出てくる前のコマンドが、出力をまとめて書き出している(バッファリング)stdbuf -oL コマンド | tee ファイルのように、行ごとに出力させます。

teeを手を動かして試す

表示と保存が同時に行われること、-aで追記されること、-aなしでは上書きされることを確認します。最後に、エラーメッセージを保存する書き方も試します。

echo hello | tee t.txt
cat t.txt
echo world | tee -a t.txt
cat t.txt
echo again | tee t.txt
cat t.txt
ls /nonexistent 2>&1 | tee err.txt
cat err.txt

安全に練習したいときは、練習用ターミナルでも同じ操作を試せます。

teeに関するよくある質問

リダイレクト(>)との違いは?

>は、結果をファイルに保存するだけで、画面には表示されません。teeは、画面への表示と、ファイルへの保存を同時に行います。

sudo echo ... > ファイルが失敗するのに、teeだと成功するのはなぜですか?

リダイレクトは、sudoではなく、元のシェルが一般ユーザーの権限で行うためです。sudo teeなら、ファイルへの書き込みそのものを、管理者権限で行えます。

画面への表示を消して、保存だけ行うには?

| sudo tee ファイル > /dev/nullのように、teeの出力を捨てます。sudoで書き込みたいが、画面には出したくない、という場合に使います。

エラーメッセージも、一緒に保存するには?

コマンド 2>&1 | tee ファイルとします。2>&1で、標準エラー出力を、標準出力にまとめています。

名前の由来は?

配管の分岐に使う、T字型の継手(ティー)です。流れてきたデータを、画面とファイルの2方向に分ける動作を表しています。

teeのまとめ

teeは、表示と保存を同時に行います。追記は-a、管理者権限での書き込みはsudo teeです。

関連ページ

あわせて覚えたいコマンド:echo・cat・sudo・grep

「シェル操作の基礎」のコマンド解説:echo・xargs・which・alias・export

teeが登場する章:中級 第8章

コマンドをまとめて自動化したいときは、Linuxシェルスクリプト入門も参考にしてください。

← Linuxコマンド一覧へ戻る