crontab 9시간 차이 방치하면 예약이 엉뚱한 때 나갑니다

크론탭 9시간 시차 개념 대표 이미지

작성자

카테고리:

크론 예약이 9시간 늦게 나갈 때 먼저 확인할 것

crontab에 아침 9시로 걸어 둔 작업이 자정 무렵에 나갔다. 예약 발행이든 정기 정산이든, 무인으로 돌리는 작업이 시간대 때문에 엉뚱하게 실행되면 그날 하루가 꼬인다. crontab 시간 9시간 차이를 검색하는 사람은 대부분 이 상황에 있을 것이다.

나도 처음 서버를 띄웠을 때 같은 실수를 했다. 한국 시간 기준으로 적은 줄이 기대한 시각에 돌지 않았고, 한참 로그를 뒤지고 나서야 서버 시계가 UTC라는 걸 알았다.

계산은 간단하다. 한국 표준시(KST)는 UTC보다 9시간 빠르다. 그래서 09:00 KST는 00:00 UTC다. 서버가 UTC인데 crontab에 0 9를 적으면, 그 9시는 UTC 9시, 즉 한국 시간 저녁 6시가 된다. 방향을 거꾸로 계산해서 0시를 적으면 이번엔 아침 9시에 돈다.

이 글에서는 세 가지를 확인한다. 서버가 지금 어느 시간대인지, 시간대를 바꾸면 무엇이 같이 바뀌는지, 크론만 KST로 돌리는 방법이 실제로 먹히는지다.

근본 원인: cron은 서버의 지역 시간을 기준으로 돈다

cron은 crontab 줄에 적힌 숫자를 서버 시스템 시계의 지역 시간으로 해석한다. 줄에 “한국 시간”이라고 써 있어도 cron은 그걸 모른다. 숫자는 그냥 서버가 믿는 시각과 비교될 뿐이다.

클라우드 서버를 기본값 그대로 띄우면 시간대가 UTC인 경우가 많다. 운영 서버에 지금 크론이 70개 돌고 있는데, 그중 몇 개는 서버 기본값이 UTC일 때 맞춰 둔 것이다. 시간대를 확인하지 않고 한국 시간으로 적었던 줄은 나중에 다시 손봐야 했다.

문제는 서버가 UTC라는 사실 자체보다, 적는 사람과 서버가 같은 시간을 생각하지 않는다는 데 있다. 그래서 가장 먼저 할 일은 서버가 지금 무슨 시간을 믿고 있는지 보는 것이다.

현재 서버 시간대를 확인하는 명령어

확인은 두 명령이면 된다. date는 현재 시각과 시간대 약어를 보여 주고, timedatectl은 시스템 설정 전체를 보여 준다.

$ date
Mon Nov  9 00:12:31 UTC 2026

$ timedatectl
               Local time: Mon 2026-11-09 00:12:31 UTC
           Universal time: Mon 2026-11-09 00:12:31 UTC
                 RTC time: Mon 2026-11-09 00:12:31
                Time zone: Etc/UTC (UTC, +0000)

출력에서 Time zone 줄을 보면 된다. Asia/Seoul (KST, +0900)이면 서버 시계는 한국 시간이고, 한국 시각으로 적은 crontab이 그대로 맞다. Etc/UTC나 UTC가 나오면 crontab의 숫자를 UTC로 계산해서 적어야 한다.

Debian 계열이라면 cat /etc/timezone으로도 확인된다. /etc/localtime이 어느 zone 파일을 가리키는지는 ls -l /etc/localtime으로 본다.

Docker 컨테이너 안에서는 함정이 있다. 호스트가 KST여도 컨테이너 이미지 안의 /etc/localtime은 UTC일 수 있다. 호스트에서 date를 치고 컨테이너 안에서 다시 쳐 보기 전까지는 두 결과가 같다고 믿으면 안 된다. 나도 이 차이를 모르고 한동안 헷갈렸다. 컨테이너 안에는 timedatectl이 아예 없는 경우도 많아서 date로만 확인하는 편이 낫다.

서버 시간대 먼저 확인하는 장면

시간대 변경: 시스템을 바꾸는 방법과 크론도 따로 바꿔야 하는지

서버 시간대를 KST로 바꾸는 명령은 이렇다.

sudo timedatectl set-timezone Asia/Seoul
timedatectl
sudo systemctl restart cron   # 배포판에 따라 서비스 이름이 crond일 수 있다

시스템 시간대를 바꾸면 크론도 같이 바뀐다. 따로 크론만 손보는 게 아니라는 뜻이다. 재시작이 꼭 필요한지는 배포판과 cron 구현체마다 달라서, 나는 바꾼 뒤 재시작하고 테스트 잡으로 확인하는 쪽을 택했다.

여기서부터가 문제다. 시스템 시간대는 크론만의 설정이 아니다. 이번에 시간대를 바꿨을 때 로그 타임스탬프가 같이 바뀌었다. 예전 로그와 새 로그를 대조할 때 시각이 9시간 어긋나 보여서 한동안 헷갈렸다. 날짜를 기준으로 조회하던 일부 작업도 결과가 달라졌다.

DB도 확인 대상이다. 타임스탬프를 시간대 없이 저장하고 앱이 서버 시간대를 따라가면, 시스템을 바꾸는 순간 저장된 값을 읽는 쪽의 해석이 달라질 수 있다. 세션 만료, 백업 파일명, 인증서 갱신 같은 것도 시각에 기대고 있으니 같이 점검해야 한다. 아직 우리 DB 전체를 다 훑어보지는 못했다.

되돌리는 방법은 단순하다.

sudo timedatectl set-timezone UTC

되돌리면 크론과 로그가 원래대로 돌아온다. 다만 바꾼 동안 쌓인 로그와 DB 기록의 시각 해석은 되돌려지지 않으니, 시간대를 바꾸기 전에 어떤 앱이 시각에 의존하는지 목록부터 만들어 두는 게 안전하다.

크론만 시간대 따로 지정하는 방법

TZ와 CRON_TZ로 크론만 KST 기준으로 돌리는 방법

시스템을 건드리기 싫다면 crontab 안에서만 시간대를 정할 수 있다. 맨 위에 CRON_TZ를 적는다.

CRON_TZ=Asia/Seoul
0 9 * * * /home/ubuntu/bin/publish.sh
30 18 * * * /home/ubuntu/bin/daily_report.sh

cronie 계열은 CRON_TZ를 읽어서 그 아래 줄의 스케줄을 해당 시간대로 해석한다. 여기서 헷갈리는 게 TZ=다. TZ=Asia/Seoul만 넣어 두면 실행 시각은 그대로인 경우가 있었다. 내가 확인한 범위에서는 TZ가 명령이 실행되는 환경변수에는 들어가도 스케줄 해석은 바꾸지 못했다. 그래서 날짜를 찍는 스크립트 안에서만 한국 시간이 보이고, 실행 시각은 여전히 UTC 기준이었다.

배포판이나 cron 구현체에 따라 지원 여부가 다르다. Debian 계열 기본 cron은 CRON_TZ를 지원하지 않는 것으로 알려져 있는데, 우리 서버 버전에서 직접 확인하지는 못했다. 그래서 적용 전에 아래 명령으로 매뉴얼에 해당 항목이 있는지 본다.

man 5 crontab | grep -i cron_tz

매뉴얼에 없으면 지원하지 않을 가능성이 높다. 그 경우에는 crontab을 믿지 말고 스크립트 쪽에서 시간을 판단하게 하거나 시스템 시간대를 바꾸는 쪽으로 가야 한다. 어느 쪽이 맞을지는 서버 하나씩 테스트로 정해야 한다.

크론 설정 3단계 검증 과정 일러스트

설정이 맞게 실행되는지 검증하는 3단계

설정을 바꾸고 다음 날 아침까지 기다렸다가 확인하면 늦다. 나는 변경 직후에 1분 간격 테스트 잡을 걸고, 실행 시각이 맞는지 확인한 뒤 실제 작업을 다시 본다.

  1. 1분 테스트 잡으로 즉시 확인
    crontab 맨 아래에 테스트 줄을 추가한다. 로그 파일에 현재 시각이 쌓이는지 본다.
    * * * * * date >> /tmp/cron_test.log 2>&1

    tail -f /tmp/cron_test.log로 두 줄이 1분 간격으로 찍히면 크론은 살아 있다.

  2. 로그에서 실행 시각 대조
    시스템 로그에서 크론이 실행한 기록을 찾는다. systemd 기반이면 journalctl -u cron --since "10 min ago"을 쓰고, 서비스 이름이 다르면 crond로 바꾼다. syslog를 쓰는 서버라면 /var/log/syslog에서 CRON 항목을 grep한다.
  3. 다음 날 실제 예약까지 확인
    테스트 줄은 지운다. 그리고 실제 작업 시각을 표로 적어 대조한다.
작업 기대 시각(KST) 로그상 실제 시각 차이
테스트 잡 매분 로그 확인값 기입 맞으면 0
발행 스크립트 09:00 로그 확인값 기입 맞으면 0
일일 보고 18:30 로그 확인값 기입 맞으면 0

테스트 잡을 지우는 걸 빼먹으면 로그 파일이 계속 자란다. 체크리스트 마지막 줄에 테스트 줄 삭제를 넣어 둔 이유다.

이 방법이 맞지 않는 경우와 마무리 행동 목록

서버를 나 혼자 쓰면 시스템 시간대를 바꾸는 게 제일 간단하다. 하지만 팀원이 같이 쓰는 서버라면 사정이 다르다. 다른 팀원 서버는 시간대 정책이 달라서 내가 바꾸지 못했다. 그때는 crontab 줄마다 주석으로 UTC 기준 시각과 KST 시각을 같이 적어 두고, 스크립트 안에서 실행 전에 현재 KST 시각을 확인하는 가드를 넣었다. 깔끔한 방법은 아니었다.

Docker 컨테이너라면 호스트 설정보다 컨테이너 환경변수를 먼저 본다. 실행할 때 시간대를 넘겨 주는 식이다.

docker run -e TZ=Asia/Seoul -v /etc/localtime:/etc/localtime:ro your-image

컨테이너 안에 cron이 있는지도 먼저 봐야 한다. 컨테이너에는 보통 크론 데몬이 없어서, 호스트 crontab에서 docker exec로 부르는 구조인지, 컨테이너 안에서 도는 구조인지 확인하고 시간대는 각각 맞춘다.

아직 못 푼 것도 있다. Debian 계열 서버에서 CRON_TZ 동작을 우리 버전으로 확인하지 못했고, 시스템 시간대를 바꾼 뒤 DB 쪽 영향은 전체를 다 보지 못했다.

오늘 바로 할 수 있는 순서는 이렇다.

  1. date와 timedatectl로 서버 시간대를 확인한다. Etc/UTC라면 crontab 숫자를 UTC로 계산한다.
  2. man 5 crontab | grep -i cron_tz로 CRON_TZ 지원 여부를 본다. 지원하면 crontab 맨 위에 적는다.
  3. 1분 테스트 잡을 걸어 로그에서 실행 시각을 대조한 뒤, 테스트 줄을 지운다.
  4. 다음 날 실제 작업 시각을 표에 적어 기대값과 비교한다.

글쓴이 정보

혼자 자동화로 서비스를 굴리는 아일리고입니다. 숏폼 영상은 제가 만든 ClipSquare 로 뽑습니다.

자주 나오는 질문

crontab 시간이 9시간 차이 나는 이유가 뭔가요?

cron은 crontab에 적은 숫자를 서버 시스템 시계의 시간대 기준으로 해석한다. 서버가 UTC로 설정돼 있으면 한국 시간 09:00을 적어도 UTC 09:00, 즉 한국 시간 18:00에 돈다. 줄에 ‘한국 시간’이라고 써 있어도 cron은 그걸 읽지 않는다.

서버 시간대가 UTC인지 어떻게 확인하나요?

date를 치면 뒤에 UTC나 KST 같은 약어가 붙어 나온다. 더 자세히 보려면 timedatectl을 치고 Time zone 줄을 보면 된다. Asia/Seoul이면 한국 시간이고, Etc/UTC나 UTC면 crontab 숫자를 UTC 기준으로 계산해서 적어야 한다.

서버 시간대를 KST로 바꾸면 크론 말고 뭐가 바뀌나요?

시스템 시간대를 바꾸면 크론뿐 아니라 로그 타임스탬프와 날짜 기준으로 돌던 작업도 같이 바뀐다. 나도 시간대를 바꾸고 나서 예전 로그와 새 로그가 9시간 어긋나 보여서 한동안 헷갈렸다. 바꾸기 전에 시각에 기대는 앱과 DB 목록부터 만들어 두는 게 안전하다.

시스템은 건드리지 않고 crontab에서만 KST 기준으로 돌릴 수 있나요?

crontab 맨 위에 TZ나 CRON_TZ를 적으면 그 파일 안에서만 시간대를 정할 수 있다. 다만 지원 여부는 cron 구현체와 배포판마다 달라서, 먼저 1분 뒤에 도는 테스트 잡으로 실제 실행 시각을 확인해야 한다. 지원이 안 되면 시스템 설정을 바꾸거나 UTC 값으로 환산해서 적는 쪽이 낫다.

Docker 컨테이너 안에서 crontab 시간이 호스트와 다르게 나오면 어떻게 하나요?

호스트가 KST여도 컨테이너 이미지 안의 /etc/localtime은 UTC인 경우가 많다. 호스트와 컨테이너에서 각각 date를 쳐서 결과를 비교하는 것부터 시작하면 된다. 컨테이너에는 timedatectl이 없는 경우가 많아서 date로 확인하는 편이 현실적이다.