Nextcloud "트랜잭션 파일 잠금이 구성되지 않았습니다" 오류 해결 방법

Nextcloud에서 트랜잭션 파일 잠금이 구성되지 않았거나 비활성화되었다는 경고가 표시되면 파일 작업이 동시 쓰기 및 중단된 전송으로부터 보호되지 않을 수 있습니다. 일반적으로 해결 방법은 Redis 또는 Valkey와 같은 지원되는 키-값 저장소를 잠금용으로 구성하는 것입니다. 먼저 Nextcloud의 설치 방식을 확인한 다음 캐시 서비스와 Nextcloud를 함께 구성하십시오. Redis만 설치한다고 해서 경고가 사라지는 것은 아닙니다.

Nextcloud의 최신 관리 설명서에 따르면 트랜잭션 잠금은 기본적으로 데이터베이스를 사용합니다. 데이터베이스 백엔드를 사용할 수는 있지만 데이터베이스 부하가 증가합니다. Redis 또는 Valkey를 사용하면 전용 잠금 백엔드를 제공할 수 있습니다. 정확한 경고 문구는 Nextcloud 릴리스 버전에 따라 다릅니다. 최신 문서에는 "트랜잭션 파일 잠금이 비활성화되어 있어 경쟁 조건 문제가 발생할 수 있습니다."라고 나와 있습니다. 별도의 메모리 캐시 경고는 이와는 다른 문제입니다. 공식 트랜잭션 파일 잠금 가이드 및 관리자 페이지 경고 참조를 확인하세요 .

서버를 변경하기 전에

이 단계는 Nextcloud 호스트를 관리하는 환경을 가정합니다. 아래 명령어는 일반적인 패키지 설치 방식을 사용하는 Debian 또는 Ubuntu 환경을 기준으로 작성되었으며, 다른 Linux 배포판에서는 패키지 이름, 서비스 이름, PHP 버전 및 구성 경로가 다를 수 있습니다. Nextcloud AIO, Docker, Snap, TrueNAS 또는 호스팅 제공업체 이미지를 사용하는 경우, 해당 배포 환경의 서비스 설치 및 재시작 지침을 따르십시오. 호스트에 PHP 패키지를 설치해도 컨테이너 또는 어플라이언스 내부의 PHP 환경은 변경되지 않을 수 있습니다.

• Nextcloud 웹 루트와 해당 활성 주소를 찾으세요 config/config.php.
• 파일을 편집하기 전에 안전한 백업본을 만드세요. 해당 파일에는 데이터베이스 자격 증명 및 기타 기밀 정보가 포함될 수 있습니다.
• Nextcloud가 웹 서버를 하나만 사용하는지 아니면 여러 개를 사용하는지 확인하십시오. 멀티 노드 설정의 경우 모든 Nextcloud 노드에서 접근 가능한 공유 Redis/Valkey 서버 또는 클러스터가 하나 필요합니다.
• 사용자들이 중단 없는 파일 업로드에 의존하는 경우, 짧은 유지보수 시간을 계획하십시오.

1단계: 경고 및 설치 유형을 확인합니다.

관리자 계정으로 로그인하여 관리 설정 으로 이동한 다음, 개요 또는 보안 및 설정 경고를 검토하십시오. 정확한 메시지를 기록해 두세요. 만약 페이지에 메모리 캐시가 구성되지 않았다는 메시지만 표시된다면, 이는 다른 확인 사항입니다. 필요에 따라 APCu와 같은 로컬 캐시를 구성하되, 해당 캐시가 트랜잭션 잠금을 제공한다고 가정하지 마십시오. Nextcloud 문서에 따르면 캐시 설정은 명시적으로 활성화해야 합니다 config.php.

일반적인 Linux 설치 환경에서는 셸을 사용하여 배포 경로를 확인하고 공유 터미널 로그에 비밀 정보를 출력하지 않고 구성 파일을 검사할 수 있습니다. 예를 들어 서버에서 다음과 같이 할 수 있습니다.

cd /var/www/nextcloud
ls -l config/config.php

실제 경로로 바꾸십시오 /var/www/nextcloud. 컨테이너의 경우, 실행 중인 인스턴스가 사용하지 않는 호스트 측 파일을 편집하는 대신 컨테이너와 마운트된 구성을 식별하십시오.

2단계: 키-값 저장소를 설치하고 시작합니다.

데비안이나 우분투에서 기존 Redis 백엔드는 일반적으로 Redis 서비스와 PHP Redis 확장 프로그램을 사용합니다. 웹 서버에서 사용하는 PHP 버전에 맞는 패키지를 설치하세요.

sudo apt update
sudo apt install redis-server php-redis
sudo systemctl enable --now redis-server
sudo systemctl status redis-server

상태 출력에서 ​​서비스가 활성화되어 있음을 확인해야 합니다. Nextcloud를 제공하는 PHP 런타임이 Redis 확장 기능을 로드할 수 있는지 확인하십시오. 표준 설치에서는 php -m | grep -i redisCLI로 간단하게 확인할 수 있지만, CLI PHP와 웹 PHP는 서로 다른 버전이나 구성 파일을 사용할 수 있습니다. 웹 런타임에 모듈이 없는 경우, 해당 패키지를 설치하거나 활성화한 후 PHP-FPM 또는 웹 서버를 다시 시작하십시오.

Nextcloud 34.0.2 이상 버전에서는 KeyValueCacheRedis 호환 저장소를 위한 백엔드가 기본 제공됩니다. PHP Redis 확장 프로그램은 필요하지 않습니다. 이는 호스팅 환경에 PHP 모듈을 설치할 수 없는 경우 유용할 수 있지만, Redis 또는 Valkey 서비스가 실행 중이어야 합니다. 최신 Nextcloud 메모리 캐싱 가이드 에서는 두 가지 접근 방식을 모두 설명합니다. 두 가지를 모두 추가하는 대신 아래 백엔드 구성 중 하나를 선택하십시오.

3단계: Nextcloud에서 잠금 설정 구성

활성화된 배열을 편집 config/config.php하고 선택한 항목을 기존 $CONFIG배열에 추가하세요. PHP 구문과 쉼표는 그대로 유지하세요. 두 번째 구성 배열을 생성하거나 키를 중복해서 만들지 마세요. 캐시 설정은 변경해야 할 이유를 명확히 알고 있지 않는 한 그대로 유지하세요.

옵션 A: PHP Redis 확장 프로그램을 사용한 Redis 사용

웹 PHP 런타임에 지원되는 phpredis확장 프로그램이 설치되어 있는 경우 이 옵션을 사용하십시오. 6379번 포트에서 수신 대기하는 로컬 Redis 서버는 다음과 같은 구성을 사용할 수 있습니다.

'memcache.locking' => '\OC\Memcache\Redis',
'redis' => [
    'host' => '127.0.0.1',
    'port' => 6379,
    'timeout' => 0.0,
],

Redis에 인증이 필요한 경우, 올바른 암호를 설정하고 config.php파일 권한을 안전하게 관리하십시오. Redis를 공개적으로 노출하지 마십시오. 로컬 호스트 또는 보호된 사설 네트워크에 바인딩하고, 필요한 경우 Unix 소켓을 사용하십시오.

옵션 B: Redis 또는 Valkey를 사용한 KeyValueCache

Nextcloud 버전이 기본 제공되는 Redis 공급자를 지원하고 PHP Redis 확장 프로그램을 설치하지 않으려는 경우 이 옵션을 사용하십시오. 6379번 포트에서 수신 대기하는 로컬 서비스의 최소 예제는 다음과 같습니다.

'memcache.locking' => '\OC\Memcache\KeyValueCache',
'memcache.kvstore' => [
    'server' => [
        'host' => '127.0.0.1',
        'port' => 6379,
    ],
],

서비스에서 인증, TLS, 소켓, Sentinel 또는 클러스터 설정을 사용하는 경우 해당 설정을 추가하십시오. 예제에서 자격 증명을 복사하지 마십시오. 자세한 매개변수 및 지원되는 토폴로지는 공식 캐시 구성 참조를 확인하십시오 .

4단계: 연결 상태 및 다중 서버 설정 확인

Nextcloud는 서비스와 동일한 호스트, 포트, 소켓 및 자격 증명을 사용하여 구성된 캐시 서버에 연결할 수 있어야 합니다. 흔히 발생하는 오류는 localhostRedis가 단일 호스트에서만 실행되는데도 각 Nextcloud 웹 노드에 동일한 설정을 적용하는 것입니다. 다중 서버 배포 환경에서는 모든 웹 노드가 동일한 Redis 서버 또는 클러스터를 사용하도록 구성해야 합니다. Nextcloud 노드에 대한 네트워크 접근을 제한하고 적절한 인증 및 방화벽 규칙으로 Redis를 보호하십시오.

유닉스 소켓의 경우 PHP/웹 서버 계정에 소켓 읽기 및 쓰기 권한이 있는지 확인하십시오. 권한 또는 그룹 변경은 운영 체제마다 다르므로, 모든 사용자에게 쓰기 권한을 부여하는 것과 같은 포괄적인 권한을 적용하기보다는 Redis/Valkey 및 배포판 설명서를 따르십시오. 연결 거부, 인증 오류 또는 소켓 권한 오류로 인해 구성 키가 있더라도 Nextcloud가 잠금 공급자를 사용하지 못할 수 있습니다.

5단계: 올바른 서비스를 다시 시작합니다.

설정을 저장한 후, Redis 서비스 설정이 변경되었다면 해당 서비스를 재시작하고, Nextcloud를 제공하는 PHP 런타임도 재시작하십시오. 예를 들어 Apache 설치의 경우 Apache 재시작이 필요할 수 있으며, PHP-FPM 설치의 경우 해당 PHP-FPM 서비스를 재시작해야 합니다. 일부 배포판에서는 서비스 이름에 PHP 버전 번호가 포함될 수 있습니다. 컨테이너 환경에서는 배포에서 지원하는 방법을 통해 관련 서비스를 다시 생성하거나 재시작하십시오. 운영 서버에서는 관련 없는 서비스를 무턱대고 재시작하지 마십시오.

Nextcloud에서 구성 또는 구문 오류가 발생하는 경우 백업을 복원하고 쉼표 누락, 따옴표 불일치, 중복 키 또는 잘못된 편집 내용이 있는지 확인하십시오 config.php. PHP 배열 설정은 기존 구성 구조 내에 유지되어야 합니다.

6단계: 구성 확인 및 파일 작동 테스트

관리자 개요를 새로 고침하고 트랜잭션 파일 잠금 경고가 사라졌는지 확인하십시오. 로컬 캐시를 구성했는데도 메모리 캐시 경고가 계속 표시되는 경우, 해당 부분을 별도로 확인하십시오. Nextcloud는 단일 서버 배포 환경에서 로컬 캐싱으로 APCu 사용을 권장하며, Redis는 잠금 및 분산 캐싱을 처리합니다. 특히 다중 서버 구성에서는 Redis를 기본 로컬 캐시로 추가하지 마십시오.

Nextcloud의 명령줄 도구를 사용하여 유효한 잠금 설정을 확인할 수도 있습니다. occNextcloud 디렉터리에서 웹 서버 계정으로 실행하십시오. Debian/Ubuntu에서 해당 계정은 일반적으로 다음과 같습니다 www-data.

sudo -u www-data php occ config:system:get memcache.locking

값은 선택한 백엔드(예: \OC\Memcache\Redis또는 ) 와 일치해야 합니다 \OC\Memcache\KeyValueCache. 명령이 설정을 찾을 수 없는 경우 경로, 실행 사용자 및 활성 구성 파일을 확인하십시오. OCC 공식 가이드에서 관리자 권한으로 명령을 실행하는 방법을 확인할 수 있습니다.

마지막으로, 작은 테스트 파일을 업로드하고 이름을 변경한 후 다운로드하여 데스크톱 또는 모바일 클라이언트에서 변경 사항이 동기화되는지 확인하십시오. 이러한 검사는 모든 동시 작업 부하를 시뮬레이션하는 것은 아니지만, 변경 후에도 일반적인 파일 작업이 정상적으로 작동하는지 확인하는 데 도움이 됩니다. 사용량이 많거나 클러스터링된 서버의 경우, 정상 사용 중에 Nextcloud 로그와 Redis/Valkey 가용성을 모니터링하십시오. 경고가 계속 표시되는 경우, 옵션 A를 사용할 때 웹 PHP 런타임에 확장 프로그램이 있는지, 캐시 호스트에 연결할 수 있는지, 자격 증명과 소켓 권한이 올바른지, 모든 노드가 동일한 백엔드를 공유하는지 확인하십시오.

트랜잭션 파일 잠금의 기능과 한계는 무엇일까요?

트랜잭션 잠금은 작업이 중복될 때 파일 손상을 방지하고, 중단된 트랜잭션을 처리하며, 공유 파일 및 외부 저장소와 관련된 변경 사항을 조정하는 데 도움이 됩니다. 하지만 특정 사용자만 문서를 편집할 수 있도록 예약하거나, 다른 사용자가 편집 중인 위치를 표시하거나, 동시 편집을 병합하는 기능은 제공하지 않습니다. 경고 메시지는 서버 구성 문제일 가능성이 높으므로, 백엔드 구성 후 정상적인 업로드 및 동기화를 테스트해 보시기 바랍니다. 공동 편집 기능을 사용하려면 파일 잠금에 의존하기보다는 공동 작업에 최적화된 애플리케이션을 사용하는 것이 좋습니다.