"일부 파일을 복사할 수 없으므로 업데이트를 진행할 수 없습니다."라는 워드프레스 오류 메시지를 해결하려면 다음 단계를 따르세요. 이 문제는 일반적으로 파일 권한 불일치로 인해 발생합니다.

HestiaCP 환경 에서 WordPress 사이트를 관리할 때 "일부 파일을 복사할 수 없으므로 업데이트를 수행할 수 없습니다."라는 오류 메시지가 나타날 수 있습니다.

이 경고는 다소 불안해 보일 수 있지만, 실제로는 워드프레스 권한 관련 문제 중 가장 흔한 문제 중 하나입니다.

이 문제는 일반적으로 플러그인, 테마 또는 워드프레스 코어의 자동 업그레이드 중에 발생합니다.

표면적으로는 단순히 "업데이트 실패"처럼 보이지만, 근본적인 원인은 거의 항상 파일 권한 불일치입니다.

다행인 점은 HestiaCP의 사용자 모델을 이해하고 나면 몇 가지 명령어만으로 문제를 완전히 해결할 수 있다는 것입니다.

문제의 근본 원인: 권한 불일치가 발생하는 이유는 무엇입니까?

HestiaCP 환경에서는 각 웹사이트(가상 호스트)가 별도의 시스템 사용자 권한으로 실행됩니다.

한편, 웹 서비스 프로세스(PHP-FPM/Nginx)는 해당 웹사이트에 대응하는 시스템 사용자 계정으로 실행됩니다.

따라서 일부 플러그인이나 테마 파일의 소유자가 루트 사용자 또는 다른 사용자가 되면 웹사이트 사용자는 해당 파일을 수정하거나 삭제할 권한이 없게 됩니다.

업그레이드 과정에서 WordPress는 이러한 파일을 복사하고 덮어써야 합니다. 권한이 올바르지 않으면 업그레이드가 중단되고 위와 같은 메시지가 표시됩니다.

핵심적인 이유는 한 문장으로 요약할 수 있습니다. 파일 소유자가 더 이상 웹사이트 시스템의 사용자가 아니기 때문입니다.

해결 방법: SSH 터미널에서 파일 권한을 복구합니다.

아래는 검증된 복구 단계입니다. SSH 터미널에서 명령어를 순서대로 실행하기만 하면 됩니다.

예시에서 your_user를 HestiaCP 사용자 이름으로, yourdomain.com을 실제 도메인 이름 으로 바꿔주세요.

이 과정은 서비스를 재시작할 필요가 없으며 사이트의 기존 데이터에도 영향을 미치지 않습니다.

전체 과정은 약 2분 정도 소요되며, 초보자도 복사 붙여넣기만 하면 첫 시도에 성공적으로 실행할 수 있습니다.

진행하기 전에, 과정 중 연결이 끊기는 것을 방지하기 위해 단말기에 관리자 권한으로 로그인할 수 있는지 확인하는 것이 좋습니다.

1단계: 변수 정의

먼저 터미널에 사용자 이름과 도메인 이름이라는 두 변수를 설정하여 이후 명령어를 직접 재사용할 수 있도록 합니다.

# 设置你的 Hestia 用户名和域名
HESTIA_USER="your_user"
HESTIA_DOMAIN="yourdomain.com"

변수가 정의되면 이후의 모든 명령은 해당 변수를 직접 참조할 수 있으므로 매번 수동으로 입력할 필요가 없습니다.

2단계: 파일 소유권 복원(핵심 복구)

웹사이트 디렉터리에 있는 모든 파일의 시스템 소유자와 사용자 그룹을 해당 HestiaCP 사용자에게 반환하도록 강제합니다.

chown -R $HESTIA_USER:$HESTIA_USER /home/$HESTIA_USER/web/$HESTIA_DOMAIN/public_html

이 단계는 전체 수리 과정의 핵심입니다. 소유권 문제가 해결되면 문제도 해결됩니다.

chown 명령어가 경로가 존재하지 않는다고 보고하는 경우, 먼저 변수의 철자가 실제 디렉터리와 일치하는지 확인하십시오.

3단계: HestiaCP의 표준 파일 및 디렉터리 권한 재설정

다음으로 디렉터리 권한을 755로, 파일 권한을 644로 설정하십시오.

# 修复所有目录权限为 755
find /home/$HESTIA_USER/web/$HESTIA_DOMAIN/public_html -type d -exec chmod 755 {} \;

# 修复所有文件权限为 644
find /home/$HESTIA_USER/web/$HESTIA_DOMAIN/public_html -type f -exec chmod 644 {} \;

이 두 가지 권한 설정은 HestiaCP의 표준 구성으로, 보안과 쓰기 가능성을 동시에 충족할 수 있습니다.

원클릭 스크립트(권장)

위의 모든 작업을 한 번에 완료하려면 다음 원클릭 스크립트를 사용할 수 있습니다.

your_user와 chenweiliang.com을 실제 값으로 바꾸고, 전체 단락을 터미널에 붙여넣은 다음 Enter 키를 누르세요.

USER="your_user" DOMAIN="chenweiliang.com" && chown -R $USER:$USER /home/$USER/web/$DOMAIN/public_html && find /home/$USER/web/$DOMAIN/public_html -type d -exec chmod 755 {} \; && find /home/$USER/web/$DOMAIN/public_html -type f -exec chmod 644 {} \;

추가 팁: 수리를 더욱 완벽하게 하려면

권한 문제를 해결하는 것은 "업데이트 멈춤" 문제의 직접적인 원인만 해결할 뿐입니다. 이 문제를 완전히 해결하려면 추가로 두 가지 조치를 취하는 것이 좋습니다.

첫째, 중단된 업그레이드로 인해 남은 잔여 파일을 정리하십시오. 둘째, SSH에 의존하지 않고 백그라운드 복구를 수행하는 방법을 배우십시오.

이 두 단계는 어렵지 않지만, 유사한 문제가 재발할 가능성을 크게 줄일 수 있습니다.

다음 작업들은 모두 권한이 복원된 상태를 전제로 합니다. 순서대로 수행하면 최상의 결과를 얻을 수 있습니다.

서버에 사이트가 여러 개 있는 경우, 이 과정을 스크립트 템플릿으로 구성하여 반복적으로 사용할 수도 있습니다.

임시 업그레이드 잔여물을 제거합니다

권한을 복원한 후에는 WordPress 업그레이드가 중단되었을 때 남아 있는 임시 파일을 정리하는 것이 좋습니다.

이러한 잔여 파일은 wp-content/upgrade 디렉터리에 있습니다. 이 파일을 제거하지 않으면 다음 업그레이드가 다시 중단될 수 있습니다.

rm -rf /home/$USER/web/$DOMAIN/public_html/wp-content/upgrade/*

SSH를 사용하고 싶지 않으세요? HestiaCP 관리자 페이지에서 수동으로 설정하세요.

명령줄 사용이 불편하다면 HestiaCP 백엔드에 로그인하여 파일 관리자를 통해 권한을 재설정할 수도 있습니다.

파일 관리자를 열고 /home/USER/web/DOMAIN/public_html/wp-content 경로로 이동하세요.

플러그인 또는 테마 폴더를 마우스 오른쪽 버튼으로 클릭하고 '권한 재설정'을 선택하세요.

권한을 재설정한 후 워드프레스 관리자 패널로 돌아가서 다시 업데이트를 클릭하세요. 그러면 일반적으로 문제없이 작동할 것입니다.

백엔드 작업을 수행한 후에도 동일한 오류가 계속 발생하면 위의 SSH 해결 방법으로 돌아가 소유권을 다시 확인하십시오.

요약

"일부 파일을 복사할 수 없어 업데이트를 수행할 수 없습니다."라는 메시지가 표시되더라도 서둘러 재설치하지 마세요. 대부분의 경우 권한 문제입니다.

`chown` 명령어 하나와 소유권 및 권한을 반환하는 `find` 명령어 두 개만 사용하면 WordPress 업데이트를 원활하게 완료할 수 있습니다.

업그레이드 전에 파일 소유권을 확인하는 습관을 들이면 이러한 종류의 오류가 재발하는 것을 근본적으로 방지할 수 있습니다.