
tar コマンドの使い方 - tar.gz の作成・展開・一覧から除外、ssh 転送、GNU tar と macOS の bsdtar の違いまで
当サイトは Amazon.co.jp を宣伝しリンクすることで紹介料を得る手段を提供する、Amazonアソシエイト・プログラムの参加者です。価格・在庫はリンク先の最新情報をご確認ください。
「tar.gz を作るのは-czfだったか-zcvfだったか」「展開したらカレントディレクトリにファイルが散らばった」「macOSで固めたら Linux 側に._で始まるファイルが大量にできた」。tarは毎日のように使うわりに、オプションを毎回調べ直している人が多いコマンドです。
tarの基本は「cで作る・xで展開する・tで中身を見る」と「-fのあとにアーカイブのファイル名」の2つだけです。ここを押さえると、圧縮形式の指定や展開先の指定は組み合わせで覚えられます。一方で、-fの位置を間違えると意図しない名前のファイルができる、--excludeを書く位置で効かなくなる、macOS標準のtarはLinuxのtarと別の実装、といった知らないとはまる違いもあります。
この記事では、早見表から始めて、tarとgzipの役割の違い、オプションの書き方、作成・一覧・展開、圧縮形式、除外、所有者とパーミッション、追加と差分、sshでの転送、GNU tarとbsdtarの違い、zipとの違い、セキュリティ上の注意、よくあるエラーまでを、実際の実行結果を見ながら順に説明します。
先に結論: よく使う書き方の早見表
| やりたいこと | 書き方 |
|---|---|
| ディレクトリを tar.gz にまとめる | tar -czf archive.tar.gz dir |
| tar.gz を展開する | tar -xzf archive.tar.gz |
| 展開先を指定する | tar -xzf archive.tar.gz -C /path/to/dest |
| 中身を一覧する | tar -tzf archive.tar.gz |
| 中身を詳しく一覧する(権限・サイズ・日時) | tar -tvzf archive.tar.gz |
| 特定のファイルだけ展開する | tar -xzf archive.tar.gz dir/path/file |
| 1つのファイルを標準出力に出す | tar -xzf archive.tar.gz -O dir/path/file |
| 一番上のディレクトリを外して展開する | tar -xzf archive.tar.gz --strip-components=1 |
| 圧縮しない tar を作る | tar -cf archive.tar dir |
| bzip2 / xz / zstd で圧縮する | tar -cjf a.tar.bz2 dir / tar -cJf a.tar.xz dir / tar --zstd -cf a.tar.zst dir |
| 拡張子で圧縮形式を決める | tar -caf archive.tar.xz dir |
| 圧縮形式を指定せずに展開する | tar -xf archive.tar.gz |
| 特定のファイルを除外する | tar -czf a.tar.gz --exclude='*.log' --exclude=node_modules dir |
| .git などを除外する | tar -czf a.tar.gz --exclude-vcs dir |
| 別のディレクトリを基準にまとめる | tar -czf a.tar.gz -C /var/www site |
| macOS で ._ ファイルを入れない | COPYFILE_DISABLE=1 tar -czf a.tar.gz dir |
覚えておきたい習慣は次の4つです。
-fは必ずオプションのかたまりの最後に書き、直後にアーカイブのファイル名を置く(-czf a.tar.gz)- 他人からもらったアーカイブは、展開する前に
-tで中身を見る。展開は空のディレクトリに-Cで --excludeはまとめる対象(ディレクトリ名)より前に書く- macOSの
tarはbsdtar、多くのLinuxのtarはGNU tar。細かいオプションや出力は違う
実行結果を採取した環境
NOTE
2026年11月21日に、GNU tar 1.35のソースに同梱のマニュアル(doc/tar.texi)とNEWS、libarchive 3.8.11のtar/bsdtar.1、macOSのman tarで内容を確認しました。GNU tarの最新の安定版は、GNUのFTPサーバーの表示で1.35(2023年7月18日公開)です。alpha.gnu.orgにはテスト版の1.35.90(2025年10月19日)が置かれていますが、次の安定版はこの記事の時点では出ていません。libarchiveの最新版は、GitHubのリリースで3.8.11(2026年10月30日公開)です。
macOS標準の/usr/bin/tarは、libarchiveに含まれるbsdtarです。
$ sw_vers
ProductName: macOS
ProductVersion: 27.2
BuildVersion: 26B123
$ tar --version
bsdtar 3.5.3 - libarchive 3.7.4 zlib/1.2.12 liblzma/5.4.3 bz2lib/1.0.8GNU tarは、手元にあったDockerのイメージdebian:trixie-slim(Debian 13.7)で試しました。新たにパッケージはインストールしていません。
$ tar --version | head -1
tar (GNU tar) 1.35
$ gzip --version | head -1
gzip 1.13このイメージにはxz・bzip2・zstdのコマンドが入っていないため、GNU tarでの-J・-j・--zstdは失敗します(その結果も後で紹介します)。圧縮形式の比較はmacOS側で行いました。
以下、とくに断りがない実行結果はGNU tar 1.35(Debian 13、rootで実行)のもので、macOSのbsdtarの結果には「macOS」と書き添えます。macOSの出力に含まれるユーザー名は載せていません。
試したディレクトリは次のような構成です。
$ find myapp | sort
myapp
myapp/.git
myapp/.git/HEAD
myapp/.gitignore
myapp/README.md
myapp/logs
myapp/logs/app.log
myapp/node_modules
myapp/node_modules/lib
myapp/node_modules/lib/index.js
myapp/src
myapp/src/main.ctar と gzip の役割の違い
tar はファイルを1本にまとめる
tarは、複数のファイルやディレクトリを、パス・パーミッション・所有者・更新日時といった情報ごと1本のファイル(アーカイブ)にまとめるコマンドです。名前はtape archive(テープアーカイブ)に由来し、もともとは磁気テープへのバックアップに使われていました。
tar自体は圧縮をしません。tar -cfで作ったアーカイブは、中身のファイルの合計よりむしろ少し大きくなります(ファイルごとに512バイトのヘッダーが付き、全体も一定の大きさの区切りにそろえられるためです)。
.tar.gz は「tar の出力を gzip で圧縮したもの」
.tar.gz(.tgz)は、tarでまとめた1本のファイルを、gzipでまるごと圧縮したものです。役割を分けると次のようになります。
| 道具 | 役割 | 単体で扱えるもの |
|---|---|---|
| tar | 複数のファイルを1本にまとめる(アーカイブ) | ディレクトリ構造・権限・所有者・日時 |
| gzip / bzip2 / xz / zstd | 1本のデータを小さくする(圧縮) | 1つのファイル(またはデータの流れ) |
gzipコマンドだけでディレクトリを圧縮できないのはこのためです。tar -zは「tarの出力をそのままgzipに通す」指定で、次の2つは同じ結果になります。
$ tar -cf - myapp | gzip > myapp.tar.gz
$ tar -czf myapp.tar.gz myapp-f -は「アーカイブを標準出力に書く」という意味です。パイプの考え方はシェルのパイプとリダイレクトの記事で、gzipやZstandardの圧縮の仕組みはデータ圧縮の仕組み 入門で説明しています。
1本にまとめてから全体を圧縮するので、ファイル同士の似た部分もまとめて縮められます。その代わり、中の1ファイルを取り出すだけでも、先頭から伸長しながら読み進める必要があります。この性質は、後半の「zip との違い」で改めて触れます。
オプションの書き方
操作を表す c・x・t
tarのオプションは、「何をするか(操作)」1つと、それを補うオプションの組み合わせです。操作は次のいずれか1つを必ず指定します。
| 操作 | 長いオプション | 意味 |
|---|---|---|
-c | --create | アーカイブを作る |
-x | --extract | 展開する |
-t | --list | 中身を一覧する |
-r | --append | 末尾にファイルを追加する |
-u | --update | 新しいファイルだけ末尾に追加する |
よく組み合わせるのは次のオプションです。
| オプション | 長いオプション | 意味 |
|---|---|---|
-f ファイル | --file=ファイル | アーカイブのファイル名(-なら標準入出力) |
-v | --verbose | 処理したファイル名を表示する(-tと組み合わせると詳細表示) |
-z | --gzip | gzipで圧縮・伸長する |
-C ディレクトリ | --directory=ディレクトリ | 指定したディレクトリに移動してから処理する |
3つの書き方: ハイフンなし・短いオプション・長いオプション
tarには、ハイフンを付けない古い書き方が今も残っています。次の3つはどれも同じ意味です。
$ tar czf old.tar.gz myapp && echo ok
ok
$ tar -czf short.tar.gz myapp && echo ok
ok
$ tar --create --gzip --file=long.tar.gz myapp && echo ok
okGNU tarのマニュアルでは、それぞれold option style・short option style・long option styleと呼んでいます。シェルスクリプトに書くなら、読み手に意味が伝わりやすい長いオプションも選択肢です。
-f の直後はアーカイブのファイル名
短いオプションをまとめて書くとき、-fは「次に来る文字列をファイル名として受け取る」オプションです。-czfの順番ならfの次の引数myapp.tar.gzがファイル名になりますが、-cfzと書くと、-fのあとに残ったzがファイル名になってしまいます。
$ tar -cfz x.tar.gz myapp
tar: x.tar.gz: Cannot stat: No such file or directory
tar: Exiting with failure status due to previous errors
$ ls
myapp zzという名前の(圧縮されていない)アーカイブができ、x.tar.gzは「まとめる対象のファイル」として扱われて見つからない、というエラーです。macOSのbsdtarでも同じで、zというファイルができました。
-c・-z・-vの順番は自由で、-zcvfでも-cvzfでも動きます。fだけはかたまりの最後と覚えておけば十分です。
ちなみに、ハイフンなしの古い書き方では、引数を取る文字の値は後ろの引数から順に割り当てられます。そのためtar cfz x.tgz myappはfにx.tgzが渡り、正しく動きます(GNU tarとmacOSのbsdtarの両方で確認しました)。ハイフンを付けるかどうかで解釈が変わるので、混乱を避けるならハイフン付きでfを最後に置く書き方にそろえるのが無難です。
-f を省略した場合
-fを省略したときに読み書きする先は実装やビルドで変わります。Debian 13のGNU tarは標準入出力が既定で、端末に向けて書き出そうとすると止めてくれます。
$ tar -cz myapp
tar: Refusing to write archive contents to terminal (missing -f option?)
tar: Error is not recoverable: exiting nowbsdtarのmanページにも「既定はシステムによって違う」とあり、FreeBSDではテープ装置の/dev/sa0が既定です。省略に頼らず、毎回-fを書くのが確実です。
アーカイブを作る(-c)
基本と -v
$ tar -czf myapp.tar.gz myapp
$ ls myapp.tar.gz
myapp.tar.gz何も表示されなければ成功です。-vを付けると、まとめたファイルの名前が表示されます。指定したディレクトリの中は再帰的にすべて入ります。
-C で基準のディレクトリを変える
tarは、指定したパスをそのままアーカイブの中の名前にします。/var/www/siteのような深い場所をまとめると、中の名前もvar/www/site/...になります。中のパスを短くしたいときは、-Cで基準のディレクトリに移動してから相対パスで指定します。
$ tar -czf rel.tar.gz -C /work/myapp src
$ tar -tzf rel.tar.gz
src/
src/main.cディレクトリの中身だけをまとめたいときは.を指定します。中の名前は./から始まります。
$ tar -czf dot.tar.gz -C /work/myapp .
$ tar -tzf dot.tar.gz | head -4
./
./logs/
./logs/app.log
./.gitignore-Cは書いた位置から後ろの引数に効くので、-C /etc nginx -C /var/www siteのように、複数の場所をそれぞれの基準でまとめることもできます。
先頭の / は取り除かれる
絶対パスを指定してまとめると、メッセージが出て先頭の/が取り除かれます。
$ tar -czf abs.tar.gz /work/myapp/src
tar: Removing leading `/' from member names
$ tar -tzf abs.tar.gz
work/myapp/src/
work/myapp/src/main.cmacOSのbsdtarでもtar: Removing leading '/' from member namesと表示され、同じように取り除かれます。これはエラーではなく、安全のための既定の動作です。もし/が残ったままだと、展開したときに元の場所(たとえば/etc)へ上書きしてしまいます。/を外しておけば、展開先は-Cで自由に決められます。
GNU tarのマニュアルは、作成時と展開時の両方で先頭の/を取り除き、展開時は..を含む名前を拒否すると説明しています。この動作を止めるのが-P(--absolute-names、bsdtarでは--absolute-paths)ですが、マニュアルのセキュリティの節でも「意味を理解していない限り使わない」オプションに挙げられています。メッセージを消したいだけなら、-C /を使ってtar -czf abs.tar.gz -C / work/myapp/srcのように相対パスで書くのが素直です。
中身を見る(-t)
-tは展開せずに中身の一覧を出します。
$ tar -tzf myapp.tar.gz
myapp/
myapp/logs/
myapp/logs/app.log
myapp/.gitignore
myapp/src/
myapp/src/main.c
myapp/.git/
myapp/.git/HEAD
myapp/node_modules/
myapp/node_modules/lib/
myapp/node_modules/lib/index.js
myapp/README.md並び順はアルファベット順ではなく、まとめたときにディレクトリを読んだ順です。-vを付けるとls -lのような詳しい表示になります。
$ tar -tvzf myapp.tar.gz
drwxr-xr-x root/root 0 2026-11-20 10:00 myapp/
drwxr-xr-x root/root 0 2026-11-20 10:00 myapp/logs/
-rw-r--r-- root/root 8 2026-11-20 10:00 myapp/logs/app.log
-rw-r--r-- root/root 14 2026-11-20 10:00 myapp/.gitignore
drwxr-xr-x root/root 0 2026-11-20 10:00 myapp/src/
-rw-r--r-- root/root 29 2026-11-20 10:00 myapp/src/main.c
(以下略)左から、パーミッション、所有者/グループ、サイズ、更新日時、名前です。macOSのbsdtarでは、ls -lに近い書式(リンク数の欄があり、日付がNov 21 05:07の形)で表示されます。
-tは、展開する前に次のことを確かめるのに使います。
- 一番上に1つのディレクトリがあるか(無いと、展開した場所にファイルが散らばる)
- 絶対パスや
../で始まる名前が含まれていないか - 欲しいファイルのアーカイブ内でのパス(特定のファイルだけ展開するときに必要)
展開する(-x)
-C で展開先を指定する
-xはカレントディレクトリに展開します。別の場所に展開するには-Cを使います。展開先のディレクトリは先に作っておく必要があります。
$ mkdir out
$ tar -xzf myapp.tar.gz -C out
$ find out | sort
out
out/myapp
out/myapp/.git
out/myapp/.git/HEAD
out/myapp/.gitignore
out/myapp/README.md
out/myapp/logs
out/myapp/logs/app.log
out/myapp/node_modules
out/myapp/node_modules/lib
out/myapp/node_modules/lib/index.js
out/myapp/src
out/myapp/src/main.c特定のファイルだけ展開する
ファイル名を後ろに並べると、そのファイルだけを展開します。名前は-tで表示されたとおり(アーカイブ内のパス)に書きます。途中のディレクトリは自動で作られます。
$ tar -xzf myapp.tar.gz -C /tmp myapp/src/main.c
$ find /tmp/myapp
/tmp/myapp
/tmp/myapp/src
/tmp/myapp/src/main.cアーカイブに無い名前を指定すると、エラーになります。
$ tar -xzf myapp.tar.gz myapp/nothing.txt
tar: myapp/nothing.txt: Not found in archive
tar: Exiting with failure status due to previous errors*.cのようなワイルドカードで指定するときは、GNU tarとbsdtarで動きが違います。macOSのbsdtarはそのままパターンとして扱いますが、GNU tarは展開時に--wildcardsが必要です。
$ tar -xzf myapp.tar.gz '*.c'
tar: Pattern matching characters used in file names
tar: Use --wildcards to enable pattern matching, or --no-wildcards to suppress this warning
tar: *.c: Not found in archive
tar: Exiting with failure status due to previous errors
$ tar -xzf myapp.tar.gz --wildcards '*.c'
$ find myapp -type f
myapp/src/main.cパターンはシェルに展開されないよう、必ずクォートで囲みます。
-O でファイルの中身を標準出力に出す
設定ファイルを1つ確かめたいだけなら、-O(--to-stdout)でファイルに書き出さずに表示できます。GNU tarとbsdtarのどちらでも使えます。
$ tar -xzf myapp.tar.gz -O myapp/src/main.c
int main(void) { return 0; }| lessや| grepにつなげれば、展開せずに中身を検索できます。
既存のファイルは上書きされる
展開先に同じ名前のファイルがあると、既定では上書きされます。上書きしたくないときは-k(--keep-old-files)を付けます。GNU tarでは、既存のファイルがあるとエラーになります。
$ tar -xzf myapp.tar.gz -k myapp/src/main.c
tar: myapp/src/main.c: Cannot open: File exists
tar: Exiting with failure status due to previous errorsGNU tarには、既存のファイルを黙って飛ばす--skip-old-filesもあります。
--strip-components で先頭のディレクトリを外す
GitHubのリリースからダウンロードしたソースのtar.gzは、project-1.2.3/のようなディレクトリが一番上にあることがほとんどです。その中身を、決まった場所にそのまま置きたいときは--strip-componentsで先頭のパスの要素を取り除きます。
$ mkdir s1
$ tar -xzf myapp.tar.gz -C s1 --strip-components=1
$ ls -A s1
.git
.gitignore
README.md
logs
node_modules
srcmyapp/src/main.cはsrc/main.cとして展開されます。数値は取り除く階層の数で、要素の数がそれより少ない名前(この例ではmyapp/自体)は飛ばされます。
圧縮形式を選ぶ: -z・-j・-J・--zstd
圧縮形式のオプション
| オプション | 長いオプション | 形式 | よく使う拡張子 |
|---|---|---|---|
-z | --gzip | gzip | .tar.gz、.tgz |
-j | --bzip2 | bzip2 | .tar.bz2、.tbz2 |
-J | --xz | xz | .tar.xz、.txz |
| なし | --zstd | Zstandard | .tar.zst、.tzst |
| なし(指定しない) | なし | 無圧縮 | .tar |
GNU tarのNEWSによると、--zstdはGNU tar 1.31(2019年1月)で追加されました。bsdtarにも--zstdがあります。
展開時は圧縮形式を自動で判別する
GNU tarは1.15(2004年)から、読み込むときに圧縮形式を自動で判別します。bsdtarもgzip・bzip2・xz・zstdなどを自動で判別します。つまり展開と一覧では-zなどを省略できます。
$ tar -xf myapp.tar.gz -C /tmp && echo ok
ok拡張子ではなく、ファイルの中身で判別しています。早見表で-xzfと書いたのは昔からの書き方に合わせたもので、今は-xfで足ります。
-a(--auto-compress)で拡張子から決める
作るときは自動判別されないので、通常は圧縮形式を指定します。-a(--auto-compress)を付けると、アーカイブのファイル名の拡張子から圧縮形式を決めてくれます。GNU tarでは1.20(2008年)で追加されたオプションです。
$ tar -caf a.tar.xz myapp && tar -caf a.tar.bz2 myapp && tar -caf a.tar.zst myapp && file a.tar.*
a.tar.bz2: bzip2 compressed data, block size = 900k
a.tar.xz: XZ compressed data, checksum CRC64
a.tar.zst: Zstandard compressed data (v0.8+), Dictionary ID: NoneこれはmacOSのbsdtarの結果です。bsdtarは-aで.zipを指定するとzip形式でも作れます(GNU tarはzipを作れません)。
圧縮は外部コマンドで行われることがある
GNU tarは、圧縮と伸長を外部のgzip・xz・zstdなどのコマンドに任せます。xz・zstdのコマンドが入っていないDebian 13のイメージでは、次のように失敗しました。
$ tar -cJf x.tar.xz myapp
/bin/sh: 1: xz: not found
tar: Child returned status 127
tar: Error is not recoverable: exiting now
$ tar --zstd -cf x.tar.zst myapp
/bin/sh: 1: zstd: not found
tar: Child returned status 127
tar: Error is not recoverable: exiting nowapt install xz-utils zstdのように、対応するコマンドを入れれば使えるようになります。
bsdtarは、libarchiveにリンクされた圧縮ライブラリを使い、無いものは外部コマンドに任せます。手元のmacOSのtar --versionにはzlib・liblzma・bz2libが表示され、zstdがありません。Homebrewのzstdが無い状態(PATHを/usr/bin:/binに限定)で試すと、次のように外部コマンドを起動しようとして失敗しました。
$ env PATH=/usr/bin:/bin tar --zstd -cf z2.tar.zst myapp
tar: Can't launch external program: zstd --no-check -3圧縮率と速度の比較
どの形式を選ぶかの目安として、Webサーバーのアクセスログ風の合成テキスト(4ファイル、合計24MB、tarにすると25,305,600バイト)をmacOSのbsdtarで圧縮してみました。zstdはHomebrewのzstd 1.5.7(既定のレベル3)が使われています。時間は/usr/bin/time -pのrealで、1回だけ測ったものです。
| 形式 | 圧縮後のサイズ | 元の何% | 作成の時間 | 展開の時間 |
|---|---|---|---|---|
gzip(-z) | 4,051,697 バイト | 16.0% | 1.04 秒 | 0.06 秒 |
bzip2(-j) | 2,225,997 バイト | 8.8% | 4.72 秒 | 1.24 秒 |
xz(-J) | 2,768,128 バイト | 10.9% | 31.49 秒 | 0.43 秒 |
zstd(--zstd) | 4,139,233 バイト | 16.4% | 0.09 秒 | 0.06 秒 |
このデータでは、zstdがgzipとほぼ同じサイズで桁違いに速く、bzip2がもっとも小さくなりました。xzはbzip2より大きく、作成にかなり時間がかかっています。一般にはxzの方がbzip2より小さくなることが多いとされますが、結果はデータの性質と圧縮レベルで大きく変わります。乱数を多く含む合成データだったことも影響していると考えられます(推測)。実際に使うデータで一度測ってから決めるのが確実です。
迷ったときの目安は次のとおりです。
- 相手の環境を問わず開けてほしい: gzip(どこにでもある)
- 速さを優先する、大きなバックアップ: zstd(相手側にzstdが入っているか確認する)
- 配布物を少しでも小さくしたい: xzやbzip2を実データで比べる
除外する: --exclude と --exclude-vcs
--exclude でパターンを除外する
--excludeは、名前がパターンに合うファイルやディレクトリをまとめる対象から外します。ディレクトリに合えば、その中身ごと外れます。
$ tar -czf ex.tar.gz --exclude=node_modules --exclude='*.log' myapp
$ tar -tzf ex.tar.gz
myapp/
myapp/logs/
myapp/.gitignore
myapp/src/
myapp/src/main.c
myapp/.git/
myapp/.git/HEAD
myapp/README.mdnode_modulesディレクトリとapp.logが外れ、空になったlogs/ディレクトリだけが残りました。*.logはシェルに展開されないようにクォートで囲みます。
除外したいものが多いときは、1行に1パターンを書いたファイルを-X(--exclude-from)で読み込ませます。rsyncの除外と考え方は似ていますが、パターンの細かい規則は違います。rsyncの除外はrsync コマンドの使い方で紹介しています。
--exclude はまとめる対象より前に書く
GNU tarでは、--excludeを対象のディレクトリより後ろに書くと効きません。
$ tar -czf late.tar.gz myapp --exclude=node_modules
tar: The following options were used after non-option arguments. These options are positional and affect only arguments that follow them. Please, rearrange them properly.
tar: --exclude 'node_modules' has no effect
tar: Exiting with failure status due to previous errors
$ tar -tzf late.tar.gz | grep -c node_modules
3アーカイブは作られますがnode_modulesが入ったままで、終了ステータスも失敗(2)になります。GNU tarの--excludeは「位置で効く」オプションで、それより後ろに書いた対象にだけ適用されます。
macOSのbsdtarでは、最初の対象より後ろのものはすべてファイル名として扱われるため、別のエラーになります。
$ tar -czf late.tar.gz myapp --exclude=node_modules
tar: --exclude=node_modules: Cannot stat: No such file or directory
tar: Error exit delayed from previous errors.どちらの実装でも、オプションを先に、対象を最後に書けば同じように動きます。
--exclude-vcs で .git などをまとめて外す
--exclude-vcsは、バージョン管理システムが使うファイルとディレクトリをまとめて外します。GNU tarでは1.19(2007年)で追加され、マニュアルには.git/のほか.gitignore・.gitmodules・.gitattributes、Subversionの.svn/、CVS、Mercurialの.hgなどが対象として載っています。
$ tar -czf vcs.tar.gz --exclude-vcs myapp
$ tar -tzf vcs.tar.gz
myapp/
myapp/logs/
myapp/logs/app.log
myapp/src/
myapp/src/main.c
myapp/node_modules/
myapp/node_modules/lib/
myapp/node_modules/lib/index.js
myapp/README.md.git/と一緒に.gitignoreも外れている点に注意してください。macOSのbsdtarでも同じ結果でした。
.gitignoreに書いたファイルは外れません(上の例ではnode_modules/が残っています)。Gitで管理しているファイルだけをまとめたいなら、Git自身のgit archiveを使う方が確実です。
$ git archive --format=tar.gz --prefix=myapp/ -o myapp.tar.gz HEADGNU tarには.gitignoreなどを読んで除外する--exclude-vcs-ignoresもあります。ただしマニュアルの説明は「.gitignoreをシェル形式のグロブのパターンとして読む」というもので、Gitとまったく同じ規則で解釈するとは書かれていません。.gitignore自体の書き方は.gitignore が効かない原因と対処で説明しています。
所有者とパーミッション
tarは、ファイルの所有者(UID・GID)とパーミッションをアーカイブに記録します。展開したときにそれを復元するかどうかは、展開する人がrootかどうかで変わります。
GNU tarの--helpの記述は次のとおりです。
| オプション | 意味 | 既定になる人 |
|---|---|---|
--same-owner | アーカイブに記録された所有者で展開する | root |
--no-same-owner | 展開した人の所有にする | 一般ユーザー |
-p(--preserve-permissions) | 記録されたパーミッションをそのまま使う | root |
--no-same-permissions | umaskを適用する | 一般ユーザー |
bsdtarのmanページも、--same-ownerと-pはrootで実行したときの既定だと説明しています。
UID 1234が所有し、パーミッションが664のファイルを含むアーカイブで試しました。
$ tar -tvzf own.tar.gz
drwxr-xr-x 1234/1234 0 2026-11-20 20:08 own/
drwxrwxr-x 1234/1234 0 2026-11-20 20:08 own/data/
-rw-rw-r-- 1234/1234 3 2026-11-20 20:08 own/data/a.txtrootで展開すると、所有者もパーミッションもアーカイブのとおりになります。
# tar -xzf own.tar.gz -C r && ls -ln r/own/data
-rw-rw-r-- 1 1234 1234 3 Nov 20 20:08 a.txtUID 1000の一般ユーザー(umaskは022)で展開すると、所有者は自分になり、umaskでグループの書き込み権限が落ちます。-pを付けるとパーミッションはアーカイブのとおりになります。
$ umask 022; tar -xzf own.tar.gz -C u && ls -ln u/own/data
-rw-r--r-- 1 1000 1000 3 Nov 20 20:08 a.txt
$ umask 022; tar -xpzf own.tar.gz -C u2 && ls -ln u2/own/data
-rw-rw-r-- 1 1000 1000 3 Nov 20 20:08 a.txtrootで展開しつつ所有者は自分(root)にしたいときは--no-same-ownerを付けます。
# tar -xzf own.tar.gz -C r2 --no-same-owner && ls -ln r2/own/data
-rw-rw-r-- 1 0 0 3 Nov 20 20:08 a.txtここで注意したいのは、所有者は名前ではなく番号で効いてくることです。別のサーバーで作ったアーカイブをsudo tar -xで展開すると、手元に無いUIDや、たまたま別の人に割り当てられているUIDの所有になることがあります。他人からもらったアーカイブをrootで展開するときは--no-same-ownerを付けるか、一般ユーザーで展開するのが安全です。パーミッションとumaskの関係はLinux のファイルパーミッションの記事で詳しく説明しています。
なお、bsdtarの-pには--insecureという別名があります。パーミッションだけでなく、ファイルの属性や拡張属性、ACLまで復元するためです。
追加・更新(-r・-u)と差分のバックアップ
圧縮したアーカイブには追加できない
-r(--append)は既存のアーカイブの末尾にファイルを追加し、-u(--update)はアーカイブ内のものより新しいファイルだけを末尾に追加します。ただし、どちらも圧縮していない.tarにしか使えません。
$ tar -rf myapp.tar.gz README.md
tar: Cannot update compressed archives
tar: Error is not recoverable: exiting nowmacOSのbsdtarではtar: Cannot append to compressed archive.と表示されます。gzipなどで圧縮したデータは途中を書き換えられないので、追加したければ伸長してから追加し、圧縮し直すことになります。
無圧縮の.tarなら追加できますが、同じ名前があっても置き換えではなく末尾に「もう1つ」追加されます。
$ tar -rf app.tar myapp/README.md
$ tar -tvf app.tar | tail -2
-rw-r--r-- root/root 8 2026-11-20 10:00 myapp/README.md
-rw-r--r-- root/root 8 2026-11-20 10:00 myapp/README.md展開すると後ろのものが前のものを上書きするので、結果として新しい方が残ります。とはいえ、アーカイブはどんどん大きくなるので、実務では作り直すことの方が多いはずです。
新しいファイルだけをまとめる
ある日時より後に変更されたファイルだけをまとめるなら、--newer-mtimeが使えます(GNU tar・bsdtarの両方にあります)。
$ tar -czvf since.tar.gz --newer-mtime='2026-11-20 12:00' myapp
myapp/
myapp/logs/
myapp/src/
myapp/src/util.c
myapp/.git/
myapp/node_modules/
myapp/node_modules/lib/
myapp/README.md変更したutil.cとREADME.mdは入りましたが、この方法ではディレクトリはすべて入ります。変更されたファイルだけを入れたいなら、findで一覧を作り、-T -(--files-from=-)で標準入力から渡す方がわかりやすくなります。ファイル名に空白や改行が含まれても壊れないように、-print0と--nullを組み合わせます(--nullはGNU tarとbsdtarの両方にあります)。
$ find myapp -type f -newermt '2026-11-20 12:00' -print0 | tar -czvf changed.tar.gz --null -T -
myapp/src/util.c
myapp/README.mdfindの条件の書き方はfind と xargs の使い方を参考にしてください。
NOTE
上の--newer-mtimeの実行結果は、2>/dev/nullで警告を隠して一部を抜き出したものです。GNU tarは、対象外のファイルごとにfile is unchanged; not dumpedという行を標準エラー出力に出します。
GNU tar の -g(--listed-incremental)
GNU tarには、前回の状態をスナップショットファイルに記録して、次回はその差分だけをまとめる増分バックアップの機能があります。
$ tar -czf full.tar.gz -g snap.db myapp
$ echo "new" > myapp/src/util.c; echo more >> myapp/README.md
$ tar -czvf inc1.tar.gz -g snap.db myapp
myapp/
myapp/.git/
myapp/logs/
myapp/node_modules/
myapp/node_modules/lib/
myapp/src/
myapp/README.md
myapp/src/util.c1回目はすべて、2回目は新しく作ったutil.cと変更したREADME.mdだけが入りました(ディレクトリの情報は毎回記録されます)。復元するときは、フルバックアップから順に増分を展開します。この機能はbsdtarのmanページには見当たりません。ファイル単位の世代バックアップなら、rsyncの--link-destを使う方法もあります。
パイプと ssh で転送する
-f -で標準出力に書き、受け側で-f -で標準入力から読むと、一時ファイルを作らずにディレクトリをまるごと移せます。ローカルでの例です。
$ mkdir dst
$ tar -cf - myapp | (cd dst && tar -xf -)
$ ls dst/myapp
README.md
logs
node_modules
srcこれをsshと組み合わせると、リモートのサーバーへディレクトリを送れます。
# ローカルの myapp をリモートの /srv/app の下へ送る
tar -czf - myapp | ssh user@server 'tar -xzf - -C /srv/app'
# リモートの /var/www/site をローカルに tar.gz として保存する
ssh user@server 'tar -czf - -C /var/www site' > site-backup.tar.gz
# リモートの /var/www/site をローカルに直接展開する
ssh user@server 'tar -czf - -C /var/www site' | tar -xzf - -C ./restore上の3つはこの記事のために実行していない書式の例です。ローカルの代わりにDockerのコンテナへパイプで送る形で、同じ仕組みを試しました(macOSのbsdtarで作り、コンテナのGNU tarで展開しています)。
$ COPYFILE_DISABLE=1 tar -czf - myapp | docker run -i --rm debian:trixie-slim sh -c 'tar -xzf - -C /tmp; find /tmp/myapp -type f | sort'
/tmp/myapp/.git/HEAD
/tmp/myapp/.gitignore
/tmp/myapp/README.md
/tmp/myapp/logs/app.log
/tmp/myapp/node_modules/lib/index.js
/tmp/myapp/src/main.c(実際には、このほかにIgnoring unknown extended header keywordという警告がGNU tarから出ました。理由は後の「macOS で作ると ._ ファイルが入る」で説明します。)
rsyncと比べると、tarのパイプには次のような特徴があります。
- 受け側にrsyncが入っていなくても、tarとsshがあれば使える
- 小さなファイルが大量にあるとき、1本の流れで送るので速いことが多い
- 差分を見ないので、毎回すべてを送る。途中で切れたら最初からやり直し
2回目以降の同期や再開が必要なら、rsyncの方が向いています。sshの接続先を短い名前で書く方法はssh の config ファイルの書き方を参照してください。
GNU tar と bsdtar(macOS)の違い
Linuxのディストリビューションの多くはGNU tar、macOSとFreeBSDはlibarchiveのbsdtarをtarとして入れています。Alpine LinuxのイメージではBusyBoxのtarでした(alpine:3.24、BusyBox v1.37.0)。ここまでに確認した違いをまとめます。
| 項目 | GNU tar 1.35 | bsdtar(macOS、libarchive 3.7.4) |
|---|---|---|
| 展開時の圧縮形式の自動判別 | あり | あり |
| 圧縮と伸長 | 外部コマンド(gzip・xz・zstdなど) | リンクされたライブラリ。無いものは外部コマンド |
--excludeを対象の後ろに書く | 警告が出て効かない(失敗扱い) | ファイル名として扱われエラー |
| 展開時のワイルドカード | --wildcardsが必要 | そのまま使える |
| 作れる形式 | tar(gnu・ustar・pax など) | tar・pax・cpio・zip・7-zip など |
| 読める形式 | tar | tar・zip・7-zip・ISO 9660・cpio など |
増分バックアップ(-g) | あり | manページに記載なし |
| 既定のアーカイブ形式 | Debian 13では--format=gnu(tar --show-defaultsで確認) | restricted pax |
| 終了時のメッセージ | Exiting with failure status due to previous errors | Error exit delayed from previous errors. |
| 終了ステータス(今回の例) | 2 | 1 |
bsdtarのmanページによると、tarコマンドには現在のPOSIXの規格が無く、1996年版(POSIX.1-1996)には含まれていたものの2001年版で外されました。現在の規格でアーカイブを扱うのはpaxコマンドです。そのため、オプションの細部は実装ごとに違います。LinuxとmacOSの両方で動くスクリプトを書くなら、この記事で扱った基本的なオプション(-c・-x・-t・-f・-z・-C・--exclude・--strip-components)の範囲にとどめるのが無難です。
macOSでGNU tarを使いたい場合は、Homebrewのgnu-tarを入れるとgtarというコマンド名で使えます(手元の環境ではGNU tar 1.35でした)。
macOS で作ると ._ ファイルが入る
何が起きるか
macOSでまとめたアーカイブをLinuxで展開すると、._memo.txtのような、._で始まるファイルができることがあります。ファイルに拡張属性(xattr)やACLが付いていると、macOSのbsdtarがそれを「AppleDouble」という形式の._ファイルとしてアーカイブに入れるためです。bsdtarのmanページでは--mac-metadataがこの動作で、作成時の既定とされています。
拡張属性を1つ付けたファイルで試しました。
$ xattr -w com.example.note sample mac/docs/memo.txt
$ xattr -l mac/docs/memo.txt
com.apple.provenance:
com.example.note: samplecom.apple.provenanceは、手元のmacOSでは何もしなくても付いていた属性です。macOSのbsdtarで一覧すると._ファイルは見えません。
$ tar -czf mac1.tar.gz mac
$ tar -tzf mac1.tar.gz
mac/
mac/docs/
mac/docs/plain.txt
mac/docs/memo.txtところが、同じアーカイブをGNU tarで一覧すると、すべてのファイルとディレクトリに._の仲間が付いています。
$ tar -tzf mac1.tar.gz
._mac
mac/
mac/._docs
mac/docs/
mac/docs/._plain.txt
mac/docs/plain.txt
mac/docs/._memo.txt
mac/docs/memo.txt
tar: Ignoring unknown extended header keyword 'LIBARCHIVE.xattr.com.apple.provenance'
(同じ警告が計5行)macOSのbsdtarは._ファイルを読み込むと元のファイルの属性として戻すので、macOS同士では気づきにくい問題です。
入れないようにする方法
macOSでは、環境変数COPYFILE_DISABLE=1を付けるか、--no-mac-metadataオプションを付けると._ファイルが入りません。さらに--no-xattrsを付けると、拡張属性そのものも記録しなくなり、GNU tarの警告も出なくなります。
$ COPYFILE_DISABLE=1 tar -czf mac2.tar.gz mac
$ tar --no-mac-metadata -czf mac3.tar.gz mac
$ COPYFILE_DISABLE=1 tar --no-xattrs -czf mac4.tar.gz macGNU tarで一覧した結果です。
| 作り方 | ._ファイル | GNU tarのIgnoring unknown extended header keyword警告 |
|---|---|---|
| そのまま | 入る | 出る |
COPYFILE_DISABLE=1 | 入らない | 出る |
--no-mac-metadata | 入らない | 出る |
COPYFILE_DISABLE=1と--no-xattrs | 入らない | 出ない |
--no-mac-metadataと--no-xattrsはbsdtarのmanページに載っているオプションです。COPYFILE_DISABLEは、bsdtarのmanページにもmacOSのcopyfileのmanページにも記載が見当たらず、上の結果は手元のmacOS 27.2で試した結果です。いつも付けたいなら、~/.zshrcにexport COPYFILE_DISABLE=1と書いておく方法がよく使われています。
すでに._ファイルが入ったアーカイブを受け取った場合は、Linux側で展開したあとにfind . -name '._*' -deleteで消すか、GNU tarで展開するときに--exclude='._*'を付けます。
zip との違い
| 項目 | tar.gz | zip |
|---|---|---|
| まとめ方 | tarで1本にまとめてから全体を圧縮 | ファイルごとに圧縮して1本にまとめる |
| 1つのファイルだけ取り出す | 先頭から伸長しながら探す | 末尾の目次から位置を引いて直接取り出せる |
| 似たファイルが多いときの圧縮率 | 有利になりやすい(ファイルをまたいで圧縮できる) | ファイルごとなので不利になりやすい |
| Unixの権限・所有者・シンボリックリンク | 記録する | 実装や設定による |
| よく使われる場面 | Linuxのソース配布、サーバー間の移動、バックアップ | Windowsとのやり取り、メール添付 |
| 標準で扱えるところ | Linux・macOS | Windows・macOS(Linuxはunzipを入れることが多い) |
ファイル名の文字コードのように、相手の環境によって問題が出る点は両方にあります。サーバー間で権限やシンボリックリンクごと移したいならtar、Windowsの人に渡すならzip、と使い分けるのが基本です。macOSのbsdtarはzipの展開もできます(tar -xf a.zip)が、GNU tarはzipを読めずThis does not look like a tar archiveになります。
信用できないアーカイブを展開するとき
インターネットから入手したアーカイブには、展開先の外にファイルを書き込もうとする細工がされている可能性があります。bsdtarのmanページは、その手口として次の3つを挙げています。
- 絶対パス(
/etc/passwdのような名前) ..を含むパス(../../.bashrcのような名前)- シンボリックリンクを経由した書き込み
絶対パスと .. はどちらも既定で防がれる
-Pを付けて、../outside.txtと/tmp/abs.txtという名前で入れたアーカイブを作り、展開してみました。
$ tar -tvf evil.tar
tar: Removing leading `../' from member names
-rw-r--r-- root/root 6 2026-11-20 20:08 ../outside.txt
tar: Removing leading `/' from member names
-rw-r--r-- root/root 2 2026-11-20 20:08 /tmp/abs.txt
$ mkdir ext && cd ext && tar -xvf /work/evil.tar; ls -A
tar: Removing leading `../' from member names
tar: ../outside.txt: Member name contains '..'
tar: Removing leading `/' from member names
/tmp/abs.txt
tar: Exiting with failure status due to previous errors
tmpGNU tarは、..を含む名前を展開せず、絶対パスは/を外してext/tmp/abs.txtとして展開しました。macOSのbsdtarでも、..はPath contains '..'で拒否され、絶対パスは/を外して展開されました。-tの段階で../や/で始まる名前が見えたら、そのアーカイブは疑ってかかるべきです。
シンボリックリンクを使った書き込みに注意
1つ目のアーカイブでlink -> /tmp/targetというシンボリックリンクを作り、2つ目のアーカイブでlink/fを展開させる、という2段階の手口を試しました。
$ tar -xf sl1.tar
$ tar -xvf sl2.tar
link/f
$ ls -l
lrwxrwxrwx 1 root root 4 Nov 20 20:08 link -> /tmp
$ ls /tmp/f
/tmp/fGNU tarでは、2つ目のアーカイブのlink/fが既存のシンボリックリンクをたどって/tmp/fに書き込まれました。GNU tarのマニュアルのセキュリティの節も、この手口を説明したうえで、「信用できない複数のアーカイブは、それぞれ別の空のディレクトリに展開する」ことを勧めています。
macOSのbsdtarは、同じ操作を拒否しました。
$ tar -xf sl1.tar
$ tar -xvf sl2.tar
x link/f: Cannot extract through symlink link/f: Undefined error: 0
tar: Error exit delayed from previous errors.bsdtarのmanページには、展開するパスの途中にシンボリックリンクがあれば展開を拒否する(-Uや-Pを付けない限り)と書かれています。
安全に展開するための習慣
GNU tarのマニュアルの「Security Rules of Thumb」の要点と、ここまでの結果をまとめると次のとおりです。
- 展開する前に
tar -tvfで中身を見る。絶対パス、../、シンボリックリンク(行頭がl)、setuidのファイルに注意する - 信用できないアーカイブは、作ったばかりの空のディレクトリに
-Cで展開する。複数あるなら別々のディレクトリに - rootで展開しない。どうしても必要なら
--no-same-ownerを付ける -P、-h(--dereference)、--overwrite、--recursive-unlink、--remove-filesは、意味を理解していない限り使わない- tarのメッセージと終了ステータスを確認する
よくあるエラーと対処
Cannot open: No such file or directory
$ tar -xzf nosuch.tar.gz
tar (child): nosuch.tar.gz: Cannot open: No such file or directory
tar (child): Error is not recoverable: exiting now
tar: Child returned status 2
tar: Error is not recoverable: exiting now-fで指定したアーカイブが見つからないときのエラーです。ファイル名のつづり、カレントディレクトリ、-fの位置(-cfzのようになっていないか)を確認します。macOSのbsdtarではtar: nosuch.tar.gz: m: No such file or directoryという表示になりました(m:の部分の意味は確認できていません)。
作成時に対象のファイルが見つからないときはCannot statになります。
$ tar -czf bad.tar.gz myapp nosuchdir
tar: nosuchdir: Cannot stat: No such file or directory
tar: Exiting with failure status due to previous errorsRemoving leading / from member names
絶対パスを指定したときに出るメッセージで、エラーではありません(「先頭の / は取り除かれる」の節を参照)。-C /を使って相対パスで指定すると出なくなります。
gzip: stdin: not in gzip format
$ tar -xzf plain.tar
gzip: stdin: not in gzip format
tar: Child returned status 1
tar: Error is not recoverable: exiting now-zを付けたのに、ファイルがgzipで圧縮されていないときのエラーです。原因は主に2つあります。
- 圧縮していない
.tarや、xzなど別の形式に-zを付けている。-zを外してtar -xfにすれば自動で判別される - ダウンロードに失敗して、中身がHTMLのエラーページになっている
2つ目は、curlでリダイレクトを追わずに保存したときなどによく起きます。中身がHTMLのファイルをtar -xfで開くと、GNU tarでは次のようになります。
$ tar -xf dl.tar.gz
tar: This does not look like a tar archive
gzip: stdin: not in gzip format
tar: Child returned status 1
tar: Error is not recoverable: exiting nowmacOSのbsdtarではtar: Error opening archive: Unrecognized archive formatです。file dl.tar.gzで種類を確かめると、HTML documentやASCII textと表示されるはずです。curlでダウンロードし直すときは-Lでリダイレクトを追い、-fでHTTPのエラーを失敗として扱います。詳しくはcurl コマンドの使い方を参照してください。
Exiting with failure status due to previous errors
それより前に何かエラーがあったことを伝える、最後のまとめのメッセージです。このメッセージ自体に原因は書かれていないので、上にスクロールして直前のメッセージ(Cannot stat、Not found in archive、has no effectなど)を探します。処理は最後まで続いているため、アーカイブ自体は作られていることがあります。GNU tarでは終了ステータスが2になるので、スクリプトでは$?を確認します。
GNU tarのマニュアルによると、終了ステータスは0が成功、1が「一部のファイルが処理中に変更された」などの軽い問題、2が致命的なエラーです。バックアップのスクリプトで、書き込み中のログファイルをまとめてfile changed as we read itが出たときは1になります。
Cannot update compressed archives
圧縮したアーカイブに-rや-uを使ったときのエラーです(「圧縮したアーカイブには追加できない」の節を参照)。作り直してください。
まとめ
- tarは複数のファイルを1本にまとめる道具で、圧縮はgzipなどの役割。
-zはtarの出力をgzipに通す指定 - 操作は
-c(作る)・-x(展開)・-t(一覧)のどれか1つ。-fはかたまりの最後に書き、直後にアーカイブ名を置く - 展開と一覧では圧縮形式が自動で判別されるので
tar -xfで足りる。作るときは-z・-j・-J・--zstdか-aで指定する - 展開先は
-C、特定のファイルは名前を並べる、先頭のディレクトリを外すなら--strip-components - 先頭の
/は作成時も展開時も取り除かれる。メッセージを消すなら-C /で相対パスに - GNU tarの
--excludeは対象より前に書く。--exclude-vcsは.gitと一緒に.gitignoreも外す - rootで展開すると所有者とパーミッションがアーカイブのとおりに戻る。他人のアーカイブには
--no-same-owner -r・-uは圧縮したアーカイブには使えない。差分は--newer-mtime、findと-T -、GNU tarの-gでtar -czf - dir | ssh host 'tar -xzf - -C dest'で一時ファイルなしに転送できる- macOSの
tarはbsdtar。Linuxに渡すアーカイブはCOPYFILE_DISABLE=1か--no-mac-metadataで._ファイルを入れない - 信用できないアーカイブは、まず
-tで中身を見てから、空のディレクトリに一般ユーザーで展開する
ファイルを選んでからまとめるならfind と xargs の使い方、サーバー間で差分を同期するならrsync コマンドの使い方もあわせて参考にしてください。Dockerのイメージも中身はtarでまとめたレイヤーの集まりで、その仕組みはDocker イメージのレイヤーとビルドキャッシュで説明しています。
参考資料
- GNU tar(gnu.org)
- GNU tar のマニュアル(gnu.org)
- GNU tar マニュアル「Security」(gnu.org)
- GNU tar マニュアル「Absolute File Names」(gnu.org)
- GNU tar マニュアル「Creating and Reading Compressed Archives」(gnu.org)
- GNU tar のリリース一覧(ftp.gnu.org)
- GNU tar のテスト版(alpha.gnu.org)
- libarchive(GitHub)
- libarchive 3.8.11 のリリース(GitHub)
- bsdtar のmanページ(FreeBSD)
- apple-oss-distributions/libarchive(GitHub)
- pax - The Open Group Base Specifications Issue 8(POSIX.1-2024)
- GNU tar 1.35 のソースに同梱の
doc/tar.texiとNEWS - macOS の
tarのmanページ(man tar)


