3.

cron / crontab の書き方完全ガイド(書式・@reboot・環境変数・systemd timer 比較)

編集
この記事の要点
  • crontab -e で編集、crontab -l で確認、crontab -r で削除
  • 書式は 5 フィールド: 分 時 日 月 曜日 コマンド(曜日は 0=日〜6=土、または 7=日)
  • @reboot / @daily / @hourly / @weekly / @monthly の特殊指定が使える
  • cron は最小限の環境変数で動く → PATHSHELL を crontab 内で明示が必要
  • ログ出力は必ず >> /var/log/myapp.log 2>&1 でリダイレクト(無いと失敗を見逃す)

cron / crontab とは

Linux でコマンドやスクリプトを定期的に自動実行する仕組みです。バックアップ、ログローテーション、バッチ処理、メール送信、ヘルスチェック等に広く使われます。

  • cron: バックグラウンドで動く常駐サービス(デーモン)
  • crontab: cron に登録するジョブ定義テーブル

基本コマンド

# 自分の crontab を編集
crontab -e

# 自分の crontab を確認
crontab -l

# 自分の crontab を削除(確認なし!)
crontab -r

# 別ユーザの crontab を編集(要 root)
sudo crontab -e -u www-data

# システム共通の crontab(root 権限ジョブ)
sudo vi /etc/crontab

# /etc/cron.d/ にファイル単位で追加(推奨)
sudo vi /etc/cron.d/myapp

書式: 5 フィールド + コマンド

* * * * * コマンド
| | | | |
| | | | +-- 曜日 (0=日, 1=月, ... 6=土, 7=日 でも可)
| | | +---- 月 (1-12 または jan-dec)
| | +------ 日 (1-31)
| +-------- 時 (0-23)
+---------- 分 (0-59)

各フィールドで使える記法:

記法意味
*任意の値毎分 / 毎時
5具体的な値5 分
1,3,5列挙1,3,5 時
9-17範囲9 時から 17 時
*/1515 ずつ0,15,30,45 分
0-30/50-30 を 5 刻み0,5,10,15,20,25,30 分

よくある記述例

# 毎分実行
* * * * * /usr/local/bin/healthcheck.sh

# 毎時 0 分に実行(毎時 1 回)
0 * * * * /usr/bin/php /var/www/myapp/artisan queue:work --stop-when-empty

# 毎日 3:30 に実行
30 3 * * * /usr/local/bin/backup.sh

# 平日(月〜金)の朝 9 時
0 9 * * 1-5 /usr/local/bin/morning-report.sh

# 5 分おき
*/5 * * * * /usr/local/bin/heartbeat.sh

# 15 分おき、9-17 時の間だけ
*/15 9-17 * * * /usr/local/bin/poll.sh

# 毎月 1 日の 4:00 に
0 4 1 * * /usr/local/bin/monthly-cleanup.sh

# 毎週日曜の 2:00
0 2 * * 0 /usr/local/bin/weekly-report.sh

# 1, 15 日の 12:30
30 12 1,15 * * /usr/local/bin/biweekly.sh

特殊指定(@reboot / @daily 等)

# 再起動時に 1 回実行
@reboot /usr/local/bin/startup.sh

# 毎日 0:00 に(= 0 0 * * *)
@daily /usr/local/bin/daily.sh

# 毎時 0 分に(= 0 * * * *)
@hourly /usr/local/bin/hourly.sh

# 毎週日曜 0:00 に(= 0 0 * * 0)
@weekly /usr/local/bin/weekly.sh

# 毎月 1 日 0:00 に(= 0 0 1 * *)
@monthly /usr/local/bin/monthly.sh

# 毎年 1/1 0:00 に
@yearly /usr/local/bin/yearly.sh

環境変数の罠(最頻トラブル)

cron はログインシェルとは違う最小環境で動きます。PATH/usr/bin:/bin しかなかったり、HOME が想定と違ったり。これが「ターミナルでは動くのに cron だと動かない」の主原因です:

# crontab の先頭で環境変数を明示
SHELL=/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOME=/home/myuser
MAILTO=admin@example.com           # 出力があればメール送信

# ジョブ
0 3 * * * /usr/local/bin/backup.sh

またはコマンド側で絶対パスを使う:

# ❌ NG(PATH に /usr/local/bin が無いと失敗)
0 3 * * * mycommand

# ✅ OK
0 3 * * * /usr/local/bin/mycommand

# Laravel Schedule の標準形
* * * * * cd /var/www/myapp && /usr/bin/php artisan schedule:run >> /dev/null 2>&1

ログ出力(必須)

cron の標準出力 / エラーはそのままだとメールで送られる(MAILTO 未設定なら捨てられる)ため、ログファイルに出すのが定番です:

# 標準出力をログに(標準エラーは捨て)
0 3 * * * /usr/local/bin/backup.sh >> /var/log/backup.log

# 標準出力もエラーもログに(推奨)
0 3 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1

# 出力を全部捨てる(メールも来なくする)
0 3 * * * /usr/local/bin/backup.sh > /dev/null 2>&1

# Laravel scheduler 標準形
* * * * * cd /var/www/myapp && php artisan schedule:run >> /var/log/laravel-schedule.log 2>&1

動作確認方法

# cron デーモンが動いているか
sudo systemctl status cron        # Debian/Ubuntu
sudo systemctl status crond       # CentOS/RHEL

# 実行ログ確認
sudo grep CRON /var/log/syslog | tail -20            # Ubuntu
sudo tail -f /var/log/cron                           # CentOS

# 一時的に毎分実行に変えてテスト
* * * * * /usr/local/bin/myjob.sh >> /tmp/test.log 2>&1

# 手動で同じ環境で実行してデバッグ
env -i HOME=$HOME PATH=/usr/bin:/bin SHELL=/bin/bash /usr/local/bin/myjob.sh

/etc/cron.d/ で管理(推奨パターン)

個人 crontab だと書いた人にしか分からないため、本番では /etc/cron.d/ にアプリ別ファイルで置くのが運用上推奨されます:

# /etc/cron.d/myapp
SHELL=/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

# 6 フィールド: 分 時 日 月 曜日 ユーザ コマンド
* * * * * www-data cd /var/www/myapp && php artisan schedule:run >> /var/log/myapp.log 2>&1
0 3 * * * www-data /usr/local/bin/backup-myapp.sh

個人 crontab と違いユーザ名フィールドが必須です(5 番目と 6 番目の間)。

systemd timer(cron の代替)

近年は systemd timer が増えています。利点: 詳細なログ、依存関係、リトライ等:

# /etc/systemd/system/backup.service
[Unit]
Description=Daily backup

[Service]
Type=oneshot
User=root
ExecStart=/usr/local/bin/backup.sh

# /etc/systemd/system/backup.timer
[Unit]
Description=Run backup.service daily at 03:30

[Timer]
OnCalendar=*-*-* 03:30:00
Persistent=true       # 起動時に未実行分を実行

[Install]
WantedBy=timers.target
# 有効化
sudo systemctl daemon-reload
sudo systemctl enable --now backup.timer

# タイマー一覧
systemctl list-timers
systemctl list-timers --all

# 個別の実行履歴
journalctl -u backup.service

cron vs systemd timer

項目cronsystemd timer
導入の手軽さ△(2 ファイル必要)
ログsyslog のみjournald で詳細
失敗時のリトライ無しRestart=on-failure
依存関係無しAfter= / Requires=
稼働中マシンの寝起き対応無しPersistent=true で未実行分を即実行
記述量1 行2 ファイル

よくあるトラブル

症状原因対処
登録したが動かないcron デーモン未起動sudo systemctl start cron
ターミナルでは動くが cron だと動かないPATH が違う絶対パス or PATH 指定
「コマンド not found」同上同上
出力が見えないリダイレクト無し>> log 2>&1
パーセント記号で切れるcron で % は改行扱い\% でエスケープ
日と曜日両方指定 → OR「日 OR 曜日」が成立意図と違うと壊れる

FAQ

Q: 13 * * * 1 は「毎時 13 分、月曜だけ」?
A: 違います。「毎時 13 分」または「月曜 0 分」のいずれかで実行されます(日と曜日は OR 関係)。意図的に「月曜の 13 分」にしたいなら 13 * * * 1 + シェルスクリプト内で曜日チェックが安全。

Q: 秒単位の実行はできる?
A: 標準 cron は最小 1 分。秒単位は while true; do ...; sleep 10; done をデーモンで動かすか、systemd の OnUnitActiveSec=10s を使います。

Q: 古い crontab を上書きしてしまった
A: バックアップ習慣をつけてください。crontab -l > ~/crontab.bak.$(date +%F)@daily で自動取得しておくのが定石です。

Q: Docker コンテナ内で cron を動かしたい
A: 公式イメージは cron が入っていないので apt install cron + フォアグラウンドで cron -f 起動。ただし Docker では「1 コンテナ 1 プロセス」原則に従い、ホスト側 crondocker exec ベースが推奨です。

編集
Post Share
子ページ

子ページはありません

同階層のページ
  1. ls ファイル/ディレクトリ一覧表示
  2. sudo ユーザー指定
  3. cron/crontab ジョブの自動実行と登録方法
  4. wget http通信によるファイルダウンロード
  5. rm ファイル/ディレクトリ削除
  6. pwd カレントディレクトリの表示
  7. cd ディレクトリの移動
  8. ./configure
  9. make
  10. make install
  11. unzip ファイルの解凍
  12. mv ファイル/ディレクトリの移動および名称変更
  13. mkdir ディレクトリの作成
  14. touch 空ファイルの新規作成
  15. vi テキストディタの使用
  16. find ファイル/ディレクトリ検索
  17. grep 文字列の検索
  18. tail ファイルの末尾表示
  19. curl HTTP通信によるリクエスト
  20. nslookup ドメインのIP解決
  21. apt update パッケージリストの情報を更新
  22. apt upgrade パッケージの更新
  23. ln リンク/ショートカットの作成と削除
  24. rsync ファイル/ディレクトリの同期
  25. ssh リモートとの暗号化通信
  26. scp sshを利用したファイルのコピー
  27. unzip zip ファイルを解凍する
  28. cp ファイル/ディレクトリのコピー
  29. diffファイルの差分抽出
  30. fdisk ハードディスクに対する操作
  31. lsblk デバイスをツリー状で表示する
  32. kill プロセスを終了させる
  33. zip ファイルやディレクトリをzip形式に圧縮する
  34. hostコマンド
  35. chmod 権限の変更
  36. ip IPアドレスの確認
  37. chown コマンド(所有者の変更)
  38. chgrp ファイル/ディレクトリのグループ情報の変更
  39. nohupと'&' プログラムのバックグラウンド実行(ssh接続時)
  40. lsof 開いているポート番号の確認
  41. tar ファイルの圧縮と解凍
  42. file ファイルの種類を表示
  43. cat ファイルの中身を表示
  44. head ファイルの先頭部分を表示
  45. wc 行数/単語数/文字数を確認
  46. shutdown システムのシャットダウンと再起動
  47. ps プロセスの確認
  48. which コマンドの絶対パスを調べる
  49. yum RedHat系ディストリビューションの管理
  50. mount ファイルシステムのマウント
  51. 特定フォルダ以下の特定拡張子のファイルを再帰的に削除する方法
  52. 特定のフォルダとそのサブフォルダ内にある特定のファイル名のファイルを再帰的に削除
  53. sed テキスト処理用ストリームエディタ
  54. awk フィールド単位の柔軟なテキスト処理
  55. sort 行の並び替え
  56. uniq 重複行の除去・カウント
  57. cut 行から特定列を切り出し
  58. tr 文字の置換・削除
  59. less ページャでファイルを読む
  60. more 古典ページャ
  61. xargs 標準入力をコマンド引数に変換
  62. paste 複数ファイルを列方向に結合
  63. top プロセスの動的監視
  64. htop 強化版インタラクティブプロセス監視
  65. nice プロセスの優先度を指定して起動
  66. renice 実行中プロセスの優先度を変更
  67. jobs シェル管理下のジョブ一覧
  68. bg ジョブをバックグラウンドで実行
  69. fg バックグラウンドジョブをフォアグラウンドに
  70. killall プロセス名でまとめて終了
  71. pgrep プロセス名から PID を検索
  72. pkill プロセス名でシグナルを送信
  73. uname システム情報の表示
  74. uptime システム稼働時間とロードアベレージ
  75. free メモリ使用状況の表示
  76. df ディスク使用量 (ファイルシステム単位)
  77. du ディレクトリ・ファイル単位の使用量
  78. lscpu CPU 情報の表示
  79. lsmod 読み込み済みカーネルモジュール一覧
  80. lspci PCI デバイス一覧
  81. dmesg カーネルリングバッファの表示
  82. w ログイン中ユーザーと負荷の表示
  83. ping ホストへの到達性とラウンドトリップ確認
  84. traceroute ホストまでの経路を表示
  85. netstat ネットワーク接続・ルーティング表示 (旧式)
  86. ss netstat 後継、ソケット統計
  87. ifconfig ネットワークインターフェース表示・設定 (旧式)
  88. dig DNS リゾルバ問い合わせの定番
  89. route ルーティングテーブル表示 (旧式)
  90. iptables Linux パケットフィルタリング
  91. telnet TCP 接続診断・古典的リモートログイン
  92. arp ARP テーブルの表示・編集 (旧式)
  93. useradd ユーザーアカウントの作成
  94. usermod 既存ユーザーアカウントの変更
  95. userdel ユーザーアカウントの削除
  96. passwd パスワードの変更・管理
  97. groupadd グループの追加
  98. id ユーザーとグループの ID・所属を表示
  99. whoami 現在のユーザー名を表示
  100. su 別ユーザーに切り替え
  101. dnf Red Hat 系の次世代パッケージマネージャ (yum 後継)
  102. pacman Arch Linux のパッケージマネージャ
  103. echo 文字列・変数の出力
  104. export 環境変数の設定と継承
  105. alias コマンドの別名定義
  106. source / . スクリプトをカレントシェルで実行
  107. history コマンド履歴の表示・操作
  108. type コマンドの種別 (組み込み/関数/エイリアス/外部) を表示
  109. env 環境変数表示と一時設定でコマンド実行
  110. set シェルオプションと位置パラメータの操作
  111. unset 変数・関数の削除
  112. printf C 風書式付き出力
  113. systemctl systemd ユニットの管理
  114. service init.d 互換のサービス管理
  115. journalctl systemd ジャーナルログの参照
  116. crontab 定期実行ジョブの登録・編集
  117. at 指定時刻に 1 回だけコマンド実行
  118. umount ファイルシステムのアンマウント
  119. reboot システムを再起動
  120. halt システムを停止
  121. date 日付・時刻の表示と設定
  122. hostname ホスト名の表示・設定
  123. gzip ファイルを Deflate で圧縮
  124. gunzip gzip 圧縮ファイルの展開
  125. bzip2 高圧縮率の圧縮コマンド
  126. xz LZMA2 ベースの高圧縮コマンド
  127. zstd Facebook 製の高速圧縮コマンド
  128. dpkg Debian パッケージの低レベル操作
  129. rpm Red Hat パッケージの低レベル操作
  130. snap Canonical の sandbox パッケージマネージャ
  131. apt Debian/Ubuntu の高レベルパッケージマネージャ
  132. 7z 7-Zip コマンドラインツール

最近更新/作成されたページ