systemd를 사용하여 Nextcloud cron 작업이 자동으로 실행되지 않는 문제를 해결하세요

systemd를 사용하여 Nextcloud 백그라운드 작업을 자동으로 실행하려면 웹 서버 사용자 권한으로 실행되는 일회성 서비스를 구성한 cron.php다음, 5분마다 해당 서비스를 시작하도록 타이머를 설정하세요. 주요 확인 사항은 다음과 같습니다. 타이머가 활성화되어 있고 다음 실행 시간이 설정되어 있는지, 서비스가 올바른 Nextcloud 및 PHP 경로를 가리키는지, 그리고 서비스 로그에 성공적으로 종료되었는지 여부입니다. 일회성 서비스는 실행 사이에 "비활성(실행 중지)" 상태로 표시될 수 있는데, 이는 서비스 완료 후 정상적인 현상입니다.

이 설정은 systemd를 사용하여 호스트에서 Nextcloud 파일을 사용할 수 있는 Ubuntu의 일반적인 Nextcloud 설치 환경을 위한 것입니다. Nextcloud가 Docker, Snap 또는 Nextcloud All-in-One과 같은 어플라이언스 내에서 실행되는 경우, 호스트 유닛을 컨테이너 전용 경로로 지정하는 대신 해당 배포판의 공식 스케줄러 방식을 사용하십시오. 아래 예제에서는 `<hostname>`과 `<hostname>`을 사용합니다 /var/www/nextcloud. www-data실제 설치 경로와 HTTP 사용자 이름으로 바꿔서 사용하십시오.

타이머가 달성해야 할 목표

Nextcloud는 cron.php유지 관리 및 앱 작업과 같은 백그라운드 작업을 대기열에 넣어 실행합니다. systemd 타이머는 타이머의 작동 시간을 알려주는 역할을 하며, 서비스는 타이머가 만료되면 실행되는 명령입니다. 이 둘 모두 필요합니다. 타이머를 활성화하지 않고 파일을 생성하면 예약된 작업이 비활성화되고, 잘못된 PHP 또는 Nextcloud 경로를 지정하는 타이머를 활성화하면 반복적인 실행 실패가 발생할 수 있습니다.

Nextcloud는 프로덕션 환경의 백그라운드 작업을 위해 시스템 cron 사용을 권장합니다. 최신 관리 매뉴얼에는 systemd 타이머를 대안으로 제시하고 있습니다. 예시 스케줄은 부팅 후 5분 뒤에 시작하여 각 서비스 활성화 후 5분 뒤에 다시 실행되도록 설정되어 있습니다. 이 방식은 사용자가 웹 인터페이스에 접속할 필요 없이 작업을 실행할 수 있습니다.

1. 설치 경로, 사용자 및 PHP CLI를 확인하십시오.

유닛을 편집하기 전에 Nextcloud 디렉토리를 찾고 웹 서버 설치에서 예상하는 PHP 명령어를 확인하십시오. 일반적인 Ubuntu 아카이브 설치에서 경로는 `/etc/Nextcloud /var/www/nextcloud/ www-datanext /usr/bin/php...

ls -l /var/www/nextcloud/cron.php
command -v php
php -v

Nextcloud 디렉터리가 다른 위치에 있는 경우 아래 두 개의 유닛 명령에서 해당 디렉터리를 사용하십시오. 웹 서버에서 별도의 PHP 버전을 사용하는 경우 해당 버전의 CLI 실행 파일을 사용하십시오 ExecStart. ExecConditionsystemd 서비스는 대화형 셸의 PATH 또는 환경 변수를 상속하지 않으므로 명시적인 경로를 사용하는 것이 더 안정적입니다.

systemd가 사용할 동일한 사용자 계정으로 상태 확인을 테스트하십시오.

sudo -u www-data /usr/bin/php -f /var/www/nextcloud/occ status -e

Nextcloud occ명령어는 파일 소유권 및 권한을 올바르게 유지하기 위해 HTTP 사용자 권한으로 실행되어야 합니다. 이 테스트에서 PHP 오류, 유지보수 모드 또는 파일 누락이 보고되면 먼저 해당 문제를 해결하십시오. 타이머는 Nextcloud 명령어 실행 실패를 보완할 수 없습니다.

2. 일회성 서비스를 생성합니다.

만들다 /etc/systemd/system/nextcloudcron.service:

sudo nano /etc/systemd/system/nextcloudcron.service

이 장치에 접속하려면 설치 환경이 다를 경우 경로와 사용자 이름을 조정하십시오.

[Unit]
Description=Nextcloud cron.php job

[Service]
User=www-data
ExecCondition=/usr/bin/php -f /var/www/nextcloud/occ status -e
ExecStart=/usr/bin/php -f /var/www/nextcloud/cron.php
KillMode=process

ExecCondition백그라운드 작업을 시작하기 전에 Nextcloud가 정상적으로 작동하는지 확인합니다. 조건이 충족되지 않으면 systemd는 실행을 건너뜁니다. 이유를 알아보려면 저널을 확인하세요. KillMode=process메인 cron 프로세스가 종료된 후에도 백그라운드 작업으로 시작된 외부 프로그램이 계속 실행될 수 있도록 합니다. 현재 Nextcloud 예제에서는 [Install]이 서비스 파일에 해당 섹션이 필요하지 않습니다.

`php-php` 명령어 를 사용할 /usr/bin/php때는 서버에서 실행되는 올바른 CLI 인터프리터가 무엇인지 확인해야 합니다. 예를 들어, 사용자 지정 PHP 저장소는 버전이 지정된 바이너리를 설치할 수 있습니다. Nextcloud에서 요구하는 PHP 버전 및 웹 서버 구성에서 사용하는 PHP 버전과 동일한 호환 버전을 사용하십시오.

3. 타이머를 생성합니다.

만들다 /etc/systemd/system/nextcloudcron.timer:

sudo nano /etc/systemd/system/nextcloudcron.timer

추가하다:

[Unit]
Description=Run Nextcloud cron.php every 5 minutes

[Timer]
OnBootSec=5 min
OnUnitActiveSec=5 min
Unit=nextcloudcron.service

[Install]
WantedBy=timers.target

OnBootSec시스템d가 부팅 시 시작된 후 5분 뒤에 첫 번째 실행을 예약합니다. OnUnitActiveSec서비스가 마지막으로 활성화된 후 5분 뒤에 두 번째 실행을 예약합니다. 타이머는 서비스와 동일하지 않습니다. .timer예약된 실행이 자동으로 이루어지도록 하려면 해당 장치를 활성화하고 시작해야 합니다.

4. systemd를 다시 로드하고 타이머를 활성화합니다.

systemd에게 새 유닛 파일을 읽도록 요청한 다음, 한 번의 명령으로 타이머를 활성화하고 시작하십시오.

sudo systemctl daemon-reload
sudo systemctl enable --now nextcloudcron.timer

타이머를 확인하세요:

systemctl status nextcloudcron.timer
systemctl list-timers --all | grep nextcloudcron

타이머가 로드되어 활성화되어 있어야 하며, list-timers'다음' 아래에 미래 시간이 표시되어야 합니다. 타이머가 비활성화되었거나 로드되지 않았거나 다음 활성화 시간이 표시되지 않는 경우, 파일 이름이 로 끝나는지 .timer, 해당 [Install]섹션에 가 포함되어 있는지 WantedBy=timers.target, 그리고 daemon-reload파일을 저장한 후 명령을 실행했는지 확인하십시오.

5. 테스트 하나를 실행하고 결과를 확인합니다.

다음 타이머 틱을 기다리지 않고 서비스를 한 번 실행할 수 있습니다.

sudo systemctl start nextcloudcron.service
sudo systemctl status nextcloudcron.service
sudo journalctl -u nextcloudcron.service -n 50 --no-pager

서비스 결과와 PHP 또는 Nextcloud 오류를 확인하십시오. 명령이 완료된 후, 일회성 작업이므로 nextcloudcron.service응답이 없을 수 있습니다 inactive (dead). 하지만 그렇다고 해서 실패한 것은 아닙니다. 타이머는 계속 활성화되어 다음 실행을 예약하며, 이전 실행이 성공적으로 종료되었는지 여부는 로그에 표시됩니다.

Nextcloud 관리 설정에서 백그라운드 작업 상태 영역을 열고 타이머가 작동한 후 마지막 작업 실행 시간이 증가하는지 확인하십시오. Nextcloud에서 최근 백그라운드 활동이 감지되면 개요 경고가 사라져야 합니다. 타이머를 활성화한 후 최소 한 번의 실행 간격이 지난 후에야 예약된 작업이 실행되지 않았다고 판단하십시오.

일반적인 고장 패턴을 진단하세요

자세한 내용은 최근 서비스 로그 및 Nextcloud 로그 파일을 참조하십시오.

sudo journalctl -u nextcloudcron.service --since "30 minutes ago" --no-pager
sudo -u www-data /usr/bin/php -f /var/www/nextcloud/occ background-job:list

작업 목록에는 등록된 작업이 표시되지만, 그 자체만으로는 타이머가 실행 중임을 증명할 수 없습니다. 타이머의 마지막 및 다음 활성화 시간, 서비스 로그, Nextcloud의 마지막 실행 표시기를 함께 사용하십시오.

다른 스케줄러를 사용해야 하는 시점

Systemd 타이머는 서버에서 systemd가 실행 중이고 로컬에서 서비스로 관리되는 스케줄을 원하는 경우에 유용합니다. 이미 표준 cron 데몬을 운영하고 있고 해당 crontab을 확인할 수 있는 경우, 동일한 기능을 호출하는 시스템 cron 항목을 사용하는 것도 cron.php지원 www-data됩니다. 동일한 Nextcloud 인스턴스에 대해 두 가지 방법을 모두 예약하지 마십시오. 중복 호출은 리소스를 낭비하고 문제 해결을 복잡하게 만들 수 있습니다.

AJAX 스케줄링은 Nextcloud 방문자 수에 따라 달라지므로 사용량이 많거나 다중 사용자 서버에서는 안정성이 떨어집니다. Webcron은 cron.phpHTTP를 통해 호출되므로 시스템 접근이 불가능한 매우 작은 인스턴스에 적합할 수 있지만, Nextcloud는 웹 실행 시 호출당 실행할 수 있는 작업량이 제한된다는 점을 명시하고 있습니다. Nextcloud가 컨테이너화되었거나 어플라이언스로 관리되는 경우, 해당 컨테이너에서 지원하는 스케줄러 또는 컨테이너 구성을 사용하십시오. 호스트 서비스가 /var/www/nextcloud해당 경로를 사용하는 경우 호스트에 해당 경로가 없으면 작동하지 않습니다.

정상적인 설정은 반복되는 다음 실행 시간으로 타이머가 활성화되어 있고, 서비스 실행이 PHP 오류 없이 완료되며, Nextcloud 마지막 실행 시간이 정상적으로 증가하는 것입니다. 이 세 가지 조건이 모두 충족되는데도 특정 앱 작업이 여전히 지연되는 경우, 스케줄러가 해당 작업이 자체 일정, 유지 관리 기간 또는 대기열 조건을 기다리는 동안 작동하고 있을 수 있습니다. 타이머 간격을 변경하기 전에 해당 작업을 별도로 진단하십시오.

공식 참고 자료

• Nextcloud 35 관리 설명서: 백그라운드 작업 및 systemd 타이머
• Nextcloud 관리 설명서: occ 명령어 사용
• Nextcloud 35 관리 설명서: 백그라운드 작업 명령
• Ubuntu 24.04 systemd.timer 매뉴얼