Repolode
fccview

fccview/cronmaster

사람이 읽기 쉬운 일정, 실시간 로그, 작업별 실행 기록을 제공하는 cron 작업 관리 웹 UI

스타
1,393
포크
38
열린 이슈
8
마지막 커밋
15일 전

어떤 프로젝트인가요?

CronMaster는 호스트 머신의 cron 작업을 조회하고 생성하거나 삭제할 수 있는 웹 인터페이스입니다. 빠른 사전 설정으로 일정을 지정할 수 있고, 작업에 주석을 달아 용도를 명확히 할 수 있습니다. cron 작업에서 사용할 스크립트는 브라우저에서 생성하고 편집할 수 있으며, 바로 시작할 수 있도록 기본 제공 스니펫도 포함되어 있습니다.

로깅을 사용하도록 설정한 작업은 stdout, stderr, 종료 코드, 타임스탬프를 기록하고 오래된 항목을 자동으로 정리합니다. 또한 SSE를 통해 실행 시간이 긴 작업의 출력을 실시간으로 스트리밍합니다. 로깅을 사용하지 않는 작업은 5분 제한 시간으로 동기 실행됩니다. 대시보드에는 가동 시간, 메모리, CPU, 네트워크, GPU 등의 시스템 정보가 표시됩니다.

이 프로젝트는 비밀번호 로그인과 OIDC 싱글 사인온, 선택적으로 API 키 인증을 사용할 수 있는 REST API, Docker 이미지를 제공합니다. Docker에서 실행하려면 root 권한이 필요하며 Docker 소켓과 데이터 볼륨을 마운트해야 합니다. 앱은 crontab 파일을 직접 작성하므로 변경 사항이 호스트에 반영됩니다.

핵심 기능

  • 01주석과 빠른 일정 사전 설정을 사용해 cron 작업을 생성, 조회, 삭제할 수 있습니다.
  • 02로깅을 사용하도록 설정한 작업의 stdout, stderr, 종료 코드, 타임스탬프를 기록합니다.
  • 03SSE를 통해 실행 시간이 긴 작업의 출력과 상태 업데이트를 실시간으로 스트리밍합니다.
  • 04cron 작업에서 사용할 bash 스크립트를 브라우저에서 생성하고 편집할 수 있습니다.
  • 05비밀번호 및 OIDC 싱글 사인온 인증을 지원합니다.
  • 06선택적으로 API 키 인증을 사용할 수 있는 REST API를 제공합니다.

활용 사례

  • 웹 UI를 통해 홈 서버나 NAS에서 예약된 유지보수 스크립트를 관리합니다.
  • 실패를 디버깅할 때 이전 cron 작업 실행 기록과 출력을 확인합니다.
  • REST API를 통해 다른 시스템에 cron 작업 제어 기능을 제공합니다.
  • Keycloak이나 Authentik 같은 SSO 제공자 뒤에서 여러 사용자가 함께 쓰는 cron 대시보드를 운영합니다.

빠른 시작

  1. 1

    README의 최소 구성으로 docker-compose.yml 파일을 만듭니다

  2. 2

    Docker Compose로 빌드하고 실행합니다

    docker compose up --build
  3. 3

    브라우저에서 http://localhost:40123을 엽니다

사용 전 알아둘 점

  • Docker 설정에서는 컨테이너를 root로, privileged 모드에서 실행하고 Docker socket을 마운트해야 합니다.
  • cron 작업에는 root 사용자가 필요하므로, 로컬에서 실행하지 않는 root 권한이 아닌 환경에는 적합하지 않습니다.
  • AGPL-3.0 라이선스가 적용됩니다. 네트워크를 통해 제공할 경우 수정된 소스 코드를 공유해야 하는 카피레프트 라이선스입니다.

토픽

자주 묻는 질문

cronmaster은(는) 무엇인가요?
사람이 읽기 쉬운 일정, 실시간 로그, 작업별 실행 기록을 제공하는 cron 작업 관리 웹 UI CronMaster는 호스트 머신의 cron 작업을 조회하고 생성하거나 삭제할 수 있는 웹 인터페이스입니다. 빠른 사전 설정으로 일정을 지정할 수 있고, 작업에 주석을 달아 용도를 명확히 할 수 있습니다. cron 작업에서 사용할 스크립트는 브라우저에서 생성하고 편집할 수 있으며, 바로 시작할 수 있도록 기본 제공 스니펫도 포함되어 있습니다.
cronmaster은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
cronmaster은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
cronmaster은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. cronmaster의 마지막 커밋은 2026년 10월 4일입니다.
cronmaster은(는) 어디에 사용할 수 있나요?
웹 UI를 통해 홈 서버나 NAS에서 예약된 유지보수 스크립트를 관리합니다. 실패를 디버깅할 때 이전 cron 작업 실행 기록과 출력을 확인합니다. REST API를 통해 다른 시스템에 cron 작업 제어 기능을 제공합니다. Keycloak이나 Authentik 같은 SSO 제공자 뒤에서 여러 사용자가 함께 쓰는 cron 대시보드를 운영합니다.
cronmaster는 어떻게 설치하나요?
README의 최소 구성으로 docker-compose.yml 파일을 만듭니다 Docker Compose로 빌드하고 실행합니다: docker compose up --build 브라우저에서 http://localhost:40123을 엽니다
cronmaster은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/fccview/cronmaster

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트