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 tee | root しか書けないファイルに書き込む定番の形。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シェルスクリプト入門も参考にしてください。