はじめに
Linuxでコマンドを実行すると、結果はターミナルの画面(標準出力)に表示されるだけで、ウィンドウを閉じれば消えてしまいます。作業ログや調査結果を記録として残したい場合、>でファイルへリダイレクトすれば保存はできますが、今度は画面に何も表示されなくなります。
teeコマンドの基本から、複数ファイルへの同時出力、標準エラー出力の記録、sudoと組み合わせて設定ファイルへ書き込む方法まで、実務でそのまま使える形で解説します。teeコマンドとは
teeコマンドは、標準入力から受け取った内容を、標準出力とファイルの両方へ同時に書き出すコマンドです。名前は、水道管などをT字に分岐させる継手(tee)に由来しており、1本のパイプで流れてきたデータを、画面とファイルという2つの出口へ分配するイメージで理解すると覚えやすくなります。
標準入力・標準出力・標準エラー出力の基本的な関係は標準入力・標準出力・標準エラー出力の解説、パイプの仕組みはLinuxのパイプの解説で詳しく扱っています。teeはパイプでつないだコマンドの途中に挟んで使う点が、>や>>による単純なリダイレクトと異なります。
基本的な使い方
基本形は次のとおりです。
コマンド | tee ファイル名
たとえばディスク使用量を確認しながら記録する場合は、次のように実行します。
df -h | tee disk-usage.txt
df -hの実行結果はターミナルに表示されると同時に、disk-usage.txtへも保存されます。指定したファイルがなければ新規作成され、既にある場合は内容が上書きされます。
teeはファイル名を複数指定すると、同じ内容を一度にまとめて保存できます。
df -h | tee disk-usage.txt backup/disk-usage.txt
この例では、カレントディレクトリとbackupディレクトリの両方へ、同じ内容のファイルが作成されます。作業記録を別の場所へも同時に複製しておきたい場合に便利です。
上書きと追記を使い分ける
teeは何も指定しないと、実行するたびに指定したファイルを上書きします。日時ごとの実行結果を1つのファイルへ積み重ねたい場合は、-a(--append)を付けます。
date | tee -a work.log
| 書き方 | 保存方法 | 向いている場面 |
|---|---|---|
tee file.txt |
上書き | 最新の結果だけを残したい |
tee -a file.txt |
追記 | 実行履歴やログを積み重ねたい |
-aを付け忘れると、既存ファイルの内容はすべて上書きされて消えます。ログや作業記録として使う前に、上書きか追記かを必ず確認してください。標準エラー出力も一緒に保存する
コマンド | tee file.txtで保存されるのは、通常は標準出力だけです。エラーメッセージも記録へ残したい場合は、パイプへ渡す前に標準エラー出力を標準出力へまとめます。
コマンド 2>&1 | tee command.log
たとえば、存在しないパスを含めて確認した結果を保存する場合は次のとおりです。
ls /etc /path/that-does-not-exist 2>&1 | tee ls-result.log
2>&1は「標準エラー出力(2)を標準出力(1)と同じ送り先へ出す」という指定です。これにより、成功した結果とエラーメッセージの両方が画面とファイルへ出力されます。
sudo teeが必要になる場面
管理者権限が必要なファイルへ書き込もうとして、次のように実行するとエラーになることがあります。
echo "example=value" > /etc/sample.conf
>によるリダイレクトは、echoではなく今のシェル自身が行います。sudoをechoの前に付けてもリダイレクトを行うシェルの権限は変わらないため、Permission deniedになります。
この場合は、実際に書き込みを行うteeの方へsudoを付けます。
echo "example=value" | sudo tee /etc/sample.conf > /dev/null
tee自体が管理者権限で実行されるため、権限のあるファイルにも書き込めます。末尾の> /dev/nullは、teeが画面へもコピーする出力を捨てて、ターミナルを不要な表示で汚さないための指定です。
既存の設定へ1行だけ追加したい場合は、-aを付けます。
echo "example=value" | sudo tee -a /etc/sample.conf > /dev/null
注意点・よくあるエラー
>で保存すると画面には何も表示されません。画面でも確認したい場合は必ずteeを使いますteeは追記ではなく上書きが既定の動作です。ログを蓄積したいときは-aを忘れないでください- 書き込み先がパイプで、途中のコマンドが先に終了するなどの書き込みエラーが起きた場合、GNU coreutils版の
teeは既定でパイプへの書き込みエラー発生時に終了し、パイプ以外への書き込みエラーは警告を表示して処理を続けます。この挙動を変えたい場合は--output-error=warnなどのオプションを指定します tail -f access.log | tee -a copied.logのように終了しない監視コマンドと組み合わせる場合、停止するにはCtrl+Cを使います
よくある使い分け
| やりたいこと | コマンド例 |
|---|---|
| 画面に出さず保存する | df -h > disk-usage.txt |
| 画面にも表示して保存する | df -h | tee disk-usage.txt |
| 複数ファイルへ同時に保存する | df -h | tee disk-usage.txt backup/disk-usage.txt |
| 既存のログへ追加する | date | tee -a work.log |
| エラーも含めて保存する | コマンド 2>&1 | tee command.log |
| 管理者権限で設定を書き込む | echo '値' | sudo tee /etc/file > /dev/null |
まとめ
teeコマンドを使うと、コマンドの実行結果を画面で確認しながら、同時にファイルへ保存できます。
tee file.txtは上書き保存、tee -a file.txtは追記保存- ファイル名を複数指定すると、同じ内容を一度に複数箇所へ保存できる
2>&1 | tee file.txtでエラーメッセージも一緒に記録できる- 管理者権限が必要な書き込みには、
echoではなくteeの方へsudoを付ける
サーバー調査やトラブル対応の手順を、画面で確認しながらそのまま記録に残せるため、作業ログとして再現性を高めたい場面でぜひ活用してください。


コメント