Linux에서 ONLYOFFICE Document Server를 완전히 제거하는 방법

ONLYOFFICE Document Server 제거가 실패하면 서비스 파일, 구성, 데이터 디렉터리, Docker 볼륨 또는 패키지 관리자의 종속 패키지가 남아 있을 수 있습니다. 완전히 안전하게 제거하는 방법은 설치 경로를 파악하고, ONLYOFFICE가 활성 세션을 종료하도록 한 다음, 해당 패키지 또는 컨테이너를 제거하고, 영구 데이터와 공유 서비스를 검사한 후 나머지 항목을 삭제하는 것입니다.

서버에 문서, 필요한 캐시 파일, 인증서 또는 사용자 지정 구성이 남아 있는 경우 백업부터 시작하십시오. 문서 서버를 제거하면 Nextcloud, ownCloud 또는 해당 서버에 연결하는 다른 애플리케이션이 중단될 수 있습니다. 또한 "ONLYOFFICE 제거"가 "PostgreSQL, Nginx, RabbitMQ, Redis 또는 공유 글꼴 제거"를 자동으로 의미하는 것은 아닙니다. 이러한 구성 요소는 다른 소프트웨어에 사용될 수 있습니다.

제거하기 전에 설치 유형을 확인하세요.

먼저 패키지 데이터베이스와 Snap을 확인하세요.

dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice

이 명령들은 읽기 전용입니다. 패키지 관리자에서 빈 결과가 나온다고 해서 다른 방식으로 소프트웨어가 설치되지 않았다는 것을 의미하지는 않습니다. Docker의 경우 컨테이너와 이미지를 나열하려면 다음 명령을 사용하세요.

docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice

Linux 호스트에서 Docker Compose가 실행 중인 경우, 진행하기 전에 Compose 프로젝트와 해당 볼륨 선언을 찾으십시오. Kubernetes에 Helm을 사용하여 ONLYOFFICE Docs를 설치한 경우, Linux 패키지 명령 대신 차트의 제거 지침을 사용하십시오.

DEB 또는 RPM 설치를 어떻게 제거하나요?

1. 작업을 저장하고 사용자를 깔끔하게 연결 해제합니다.

ONLYOFFICE의 Linux 제거 가이드에 설명된 패키지 설치의 경우, 패키지를 제거하기 전에 종료 준비 스크립트를 실행하십시오.

sudo documentserver-prepare4shutdown.sh

이 스크립트는 활성 세션을 종료하고 문서가 저장되도록 도와줍니다. ONLYOFFICE에 따르면 이 작업은 최대 5분 정도 소요될 수 있습니다. 유지 관리 시간 동안 이 단계를 예약하고 연결된 사용자에게 먼저 알리십시오. 명령을 찾을 수 없는 경우, 관련 없는 스크립트로 대체하지 말고 설치된 패키지를 확인하고 해당 에디션의 공식 제거 페이지를 참조하십시오.

2. 우분투 또는 데비안에서 해당 패키지를 제거합니다.

커뮤니티 에디션의 공식 패키지 이름은 다음과 같습니다 onlyoffice-documentserver.

sudo apt purge onlyoffice-documentserver

패키지 이름은 에디션별로 다릅니다. 공식 개발자 에디션 제거 가이드에서는 .을 사용합니다 onlyoffice-documentserver-de. 에 표시된 정확한 이름을 확인 dpkg -l하고 해당 공급업체의 지침을 따르십시오. 이름이 비슷한 패키지를 추측하여 제거하지 마십시오.

APT purge 명령은 패키지 바이너리와 패키지 구성을 제거하지만, ONLYOFFICE는 패키지와 함께 설치된 종속성이 남아 있다고 표시합니다. APT에서 제안하는 내용을 확인한 후 실행하십시오. apt autoremove자동 실행을 피하고, 먼저 패키지 목록을 확인하여 다른 서비스에서 사용하는 항목은 남겨두십시오.

3. CentOS 또는 호환 시스템에서 RPM 패키지를 제거합니다.

커뮤니티 에디션 제거 페이지에서는 CentOS용 명령어를 다음과 같이 안내합니다.

sudo yum remove onlyoffice-documentserver

DNF를 사용하는 시스템에서는 RPM에서 보고된 패키지 이름을 사용하고, 확인 전에 제안된 트랜잭션을 검토하십시오.

sudo dnf remove onlyoffice-documentserver

에디션 및 저장소 차이로 인해 패키지 이름이 변경될 수 있습니다. ONLYOFFICE의 공식 지침에는 CentOS yum명령어가 구체적으로 명시되어 있으므로, Enterprise 또는 Developer 빌드를 제거하기 전에 사용 중인 배포판에서 해당하는 패키지 이름을 확인하십시오.

나머지 파일과 종속 파일은 어떻게 처리해야 할까요?

패키지 제거 시 디렉터리가 비어 있지 않다고 보고되면 ONLYOFFICE는 수동으로 제거할 수 있는 디렉터리 목록을 표시 /etc/onlyoffice합니다 /var/www/onlyoffice. 먼저 해당 디렉터리를 검사하고 보존하려는 구성, 인증서 또는 파일을 복사하십시오. 그런 다음 서버를 더 이상 사용하지 않을 예정이고 해당 디렉터리에 다른 애플리케이션의 데이터가 없는 경우에만 해당 경로를 정확히 삭제하십시오.

sudo rm -rv /etc/onlyoffice /var/www/onlyoffice

이 대상 명령을 와일드카드(예: )로 대체하지 마십시오 rm -rf /var/*/onlyoffice*. 나머지 서비스 및 패키지 상태를 확인하십시오.

systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice

패키지 관리자는 Nginx, PostgreSQL, RabbitMQ, Redis 및 글꼴 패키지가 종속성 또는 필수 구성 요소이기 때문에 설치된 상태로 둘 수 있습니다. 다른 애플리케이션에서 해당 패키지를 사용하지 않는지 확인한 후에만 제거하십시오. Debian 또는 Ubuntu 시스템에서는 패키지 제거를 고려하기 전에 역방향 종속성을 검사하십시오. RPM 기반 시스템에서는 해당 패키지에 종속된 서비스 및 패키지를 검사하십시오. ONLYOFFICE 저장소가 이 서버만을 위해 추가된 경우, 구성된 파일을 확인한 후 저장소 항목과 서명 키를 별도로 제거할 수 있습니다. 다른 ONLYOFFICE 제품에서 사용하는 공유 저장소 또는 키는 제거하지 마십시오.

리버스 프록시 및 방화벽 구성도 검토하십시오. Nginx 사이트 파일에서 ONLYOFFICE 호스트 이름 또는 프록시 대상을 검색한 다음, 문서 서버 전용 서버 블록만 편집하십시오. 관련 없는 가상 호스트는 그대로 유지하십시오. TLS 인증서는 별도로 관리되며 다른 사이트에서도 필요할 수 있습니다.

Docker 설치를 어떻게 제거하나요?

먼저 정확한 Compose 프로젝트 또는 컨테이너를 확인하십시오. Compose 설치의 경우 관련 Compose 파일이 있는 디렉터리로 이동하여 프로젝트를 중지하십시오.

docker compose down

이렇게 하면 프로젝트의 컨테이너와 네트워크는 제거되지만, 이름이 지정된 볼륨은 일반적으로 유지됩니다. 이는 재설치하거나 저장된 데이터가 필요할 때 유용합니다. 영구적으로 삭제하려면 제거하기 전에 Compose 파일을 검사하고 볼륨 목록을 확인하세요.

docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'

ONLYOFFICE 공식 Docker 이미지 문서에는 /var/log/onlyoffice, /var/www/onlyoffice/Data, 및 /var/lib/onlyoffice를 포함한 영구 경로가 명시되어 있습니다. PostgreSQL 데이터는 별도로 저장될 수도 있습니다. Compose 설정은 이러한 경로를 명명된 볼륨 또는 호스트 디렉터리에 매핑할 수 있습니다. 필요한 인증서나 데이터를 백업하십시오. 이 문서 서버 배포에만 속하는 것으로 확실히 확인된 볼륨과 바인드 마운트된 디렉터리만 제거하십시오.

검토 후, Compose 프로젝트는 다음 명령을 사용하여 선언된 명명된 볼륨을 제거할 수 있습니다.

docker compose down --volumes

이 명령은 해당 프로젝트의 영구 데이터를 삭제할 때만 사용하십시오. docker volume prune바로 가기로 실행하지 마십시오. 관련 없는 사용되지 않는 볼륨이 삭제될 수 있습니다. 명령으로 시작된 컨테이너의 경우 docker run, 해당 컨테이너를 중지하고 제거한 다음, 마운트된 부분을 별도로 검사하여 삭제하기로 선택한 데이터 경로 또는 볼륨만 제거하십시오.

docker stop <container_name>
docker rm <container_name>

마지막으로, 나머지 컨테이너에 ONLYOFFICE 이미지가 필요하지 않은 경우에만 해당 이미지를 제거하십시오. 다음에서 보고된 이미지와 태그를 정확히 사용하십시오 docker image ls.

docker image rm onlyoffice/documentserver:<tag>

Docker 공식 저장소에는 이미지의 데이터 경로 및 볼륨 사용법이 설명되어 있습니다. 실행 중인 컨테이너의 실제 마운트 위치는 기본값과 다를 수 있으므로, docker inspect추측보다는 Docker Compose 파일을 신뢰하는 것이 좋습니다.

Snap 패키지를 어떻게 제거하나요?

ONLYOFFICE Docs 스냅이 표시되는 경우 snap list공식 스냅 저장소 문서에는 다음과 같은 내용이 포함됩니다.

sudo snap remove onlyoffice-ds

그런 다음 다시 확인하십시오 snap list. 스냅샷 제거와 보존된 스냅샷 또는 사용자 데이터 삭제는 별개의 작업입니다. 저장된 스냅샷을 검사 snap saved하고 삭제하려는 ONLYOFFICE 스냅샷만 제거하십시오. 공유 스냅샷 데이터나 스냅샷을 무분별하게 삭제하지 마십시오.

제거 후 최종 점검

• 대상으로 지정한 패키지, 스냅 또는 컨테이너가 더 이상 설치되어 있거나 실행 중이 아닌지 확인하십시오.
• 이전 문서 서버 URL이 신뢰할 수 있는 네트워크 또는 호스트 자체에서 더 이상 응답하지 않는지 확인하십시오.
• 연결된 애플리케이션이 대체 문서 서버를 가리키도록 설정되었거나 커넥터가 비활성화되었는지 확인하십시오.
• Nginx, 방화벽, DNS 및 TLS 설정을 검토하여 ONLYOFFICE 관련 항목을 찾고, 더 이상 사용하지 않는 항목만 제거하십시오.
• 디스크 사용량과 패키지 관리자의 남은 종속성 목록을 확인하세요. 다른 서비스에서 필요로 하는 공유 데이터베이스, 프록시, 메시지 브로커 및 글꼴은 유지하세요.

패키지 제거가 실패하면 전체 오류 메시지를 읽고 강제 제거 옵션을 시도하기 전에 패키지 상태를 확인하십시오. 관리자 스크립트 오류 또는 중단된 업그레이드로 인해 해당 운영 체제 및 패키지 버전에 맞는 복구가 필요할 수 있습니다. 진단 없이 강제로 제거하면 패키지 관리자 상태가 불안정해질 수 있습니다. 표준 제거 절차가 정상적으로 작동하는 경우 이를 사용하는 것이 좋습니다.

공식 참고 자료

• ONLYOFFICE Docs Community Edition: Linux 설치 제거
• ONLYOFFICE Docs Developer Edition: Linux 설치 제거
• ONLYOFFICE 문서 서버 Docker 이미지 및 영구 데이터 경로
• ONLYOFFICE Docs Snap 패키지 및 제거 방법 안내
• ONLYOFFICE Kubernetes 관련 문서: Helm 제거