Ubuntu 24.04에 ONLYOFFICE Workspace Community 배포하기

Ubuntu 24.04에 ONLYOFFICE를 간편하게 설치하려면 Docker와 함께 ONLYOFFICE의 공식 Workspace Community 설치 프로그램을 사용하고, 도메인이 있고 이메일을 실행할 계획이 없다면 메일 구성 요소는 제외하세요. 시작하기 전에 서버 리소스와 사용 가능한 포트를 확인하십시오. ONLYOFFICE는 이처럼 리소스 집약적인 설정을 위해 최소 8GB RAM, 40GB의 여유 디스크 공간, 4코어 CPU를 요구합니다.

커뮤니티 설치 프로그램을 사용해야 할까요?

ONLYOFFICE Workspace는 문서 편집과 공동 작업 도구를 결합한 프로그램입니다. 커뮤니티 에디션은 무료 옵션입니다. 공식 Linux 설치 프로그램을 사용하면 Docs, Community Server, Control Panel, Talk를 설치할 수 있으며, 메일 서버는 별도로 추가할 수 있습니다. 이 설치 절차는 amd64 Ubuntu 서버에서 실행되는 공급업체의 Docker 기반 스크립트를 사용합니다. ONLYOFFICE의 현재 요구 사항은 Ubuntu 24.04를 명시적으로 언급하는 대신 호환되는 64비트 Linux 배포판을 설명하고 있으므로, 실제 사용 환경에 대한 호환성을 확인하고 사용 전에 공급업체의 최신 문서를 참조하십시오.

게시된 최소 사양에 미달하는 소규모 가상 머신에는 이 설정을 선택하지 마십시오. ONLYOFFICE는 최소 사양으로 CPU 코어 4개, RAM 8GB, 디스크 여유 공간 40GB를 권장하며, 권장 사양은 CPU 코어 6개와 RAM 12GB입니다. 설치 프로그램은 6GB의 스왑 파일을 자동으로 생성합니다. 업로드된 파일, 로그, 백업 및 향후 증가를 위해 추가 디스크 공간을 확보하십시오. 40GB는 최소 사양일 뿐이며, 사용량이 많은 팀을 위한 권장 용량이 아닙니다.

무엇을 먼저 준비해야 할까요?

• 관리자 권한이 있는 새로 설치되었거나 적절하게 준비된 64비트 Ubuntu 24.04 서버.
• 서버에 Docker가 설치되어 있습니다. 설치 프로그램은 Docker 설치 여부를 확인하고 설치 또는 업데이트할 수 있습니다.
• 최소 4개의 CPU 코어, 8GB의 RAM, 그리고 40GB의 여유 공간(설치 프로그램에서 관리하는 스왑 공간 포함)이 필요합니다.
• 설치 프로그램과 컨테이너 이미지를 다운로드하려면 네트워크에 접속해야 합니다.
• 설치하려는 구성 요소에 필요한 비어 있는 포트를 확인하십시오. 방화벽 규칙은 공급업체의 포트 목록을 기준으로 설정해야 합니다.

다른 웹 서버나 애플리케이션이 이미 필요한 포트를 사용하고 있다면, 설치 전에 해당 서비스를 중지하고 포트 또는 리버스 프록시 설정을 계획하십시오. 기존 서비스를 섣불리 종료하지 마십시오. 공용 서버의 경우, 사용자를 초대하거나 포털을 인터넷에 노출하기 전에 도메인 이름과 HTTPS 계획을 준비하십시오.

메일 없이 Workspace를 설치하는 방법은 무엇인가요?

1. 공식 설치 프로그램을 다운로드하세요.

SSH를 통해 Ubuntu 서버에 연결한 다음 ONLYOFFICE에서 제공하는 다운로드 호스트에서 스크립트를 다운로드하십시오.

curl -O https://download.onlyoffice.com/install/workspace-install.sh

관리자 권한으로 설치 프로그램을 실행하기 전에 파일이 제대로 도착했는지 확인하고 파일의 첫 부분을 검사하십시오.

ls -lh workspace-install.sh
less workspace-install.sh

뷰어를 종료하려면 누르십시오 q. 이 스크립트와 매개변수는 공급업체의 설치 설명서를 참조하십시오. 나중에 절차를 반복하기 전에 해당 페이지를 참조하여 변경 사항을 확인하십시오.

2. 커뮤니티 설치를 실행합니다.

관리자 권한으로 설치 프로그램을 실행하고, 안내된 대로 메일 전송을 건너뛰는 옵션을 선택하십시오.

sudo bash workspace-install.sh -ims false

이 -ims false매개변수는 설치 프로그램이 ONLYOFFICE Mail을 설치하지 않도록 지시합니다. 스크립트는 Docker를 사용하여 Workspace 구성 요소를 설치하고 구성하며, 필요한 경우 Docker를 설치하거나 업데이트할 수 있습니다. 스크립트에 표시되는 모든 프롬프트를 따르십시오. 설치가 실행되는 동안 SSH 세션을 열어 두고 패키지 또는 컨테이너 설정이 중단되지 않도록 하십시오.

메일 기능을 사용하려면 해당 매개변수를 단순히 제거하고 이메일이 자동으로 작동할 것이라고 생각하지 마십시오. 제조사의 메일 사용 설명서에는 적절한 DNS 레코드를 포함하여 기기에 유효한 도메인이 구성되어 있어야 한다고 명시되어 있습니다. 또한 메일 기능은 문서 공동 작업에 필요하지 않을 수 있는 서비스와 네트워크 포트를 추가합니다.

새 워크스페이스는 어떻게 여나요?

설치가 완료되면 서버에 접속 가능한 컴퓨터에서 브라우저를 열고 서버의 LAN IP 주소를 입력하십시오 . 예: http://192.168.1.20.NET Framework ...localhost127.0.0.1

원격 또는 인터넷 연결 배포의 경우, 정상 사용 전에 DNS 이름과 HTTPS를 구성해야 합니다. 설치 프로그램의 로컬 IP 확인 기능은 서비스가 네트워크에서 응답하는지 여부를 확인하는 것이며, 자체적으로 안전한 공용 액세스를 설정하지는 않습니다. 선택한 설치 유형에 맞는 공식 HTTPS 절차를 따르고, 선택한 워크스페이스 모듈에 필요한 포트만 허용하십시오.

설치가 실패하면 어떻게 되나요?

• 필수 포트가 사용 중입니다. 해당 포트를 사용하는 서비스를 확인하고 해당 서비스를 재구성하거나 배포 계획을 변경할지 결정하십시오. ONLYOFFICE는 필수 포트가 사용 가능한지 확인하는 것이 좋습니다. 익숙하지 않은 프로세스를 종료하지 마십시오.
• 설치 프로그램이 이미지를 다운로드할 수 없습니다. DNS, 외부 인터넷 연결 및 Docker 상태를 확인하십시오. 호스트가 의도적으로 인터넷에 연결되지 않은 경우, 공급업체에서 제공하는 설명서를 참조하여 Docker가 접근 가능한 로컬 DNS 확인자를 사용하도록 구성하십시오.
• 브라우저가 포털에 연결할 수 없습니다. 서버의 LAN 주소, 호스트 방화벽 및 설치 완료 여부를 확인하십시오. 외부 접속 문제를 해결하기 전에 동일 네트워크에 있는 컴퓨터에서 테스트해 보십시오.
• 서버 속도가 느리거나 메모리가 부족한 경우, 서버 리소스를 공급업체의 최소 및 권장 사양과 비교해 보세요. RAM이나 CPU를 추가해야 할 수도 있습니다. 호스트 사양이 부족한 경우 재부팅으로는 문제를 해결할 수 없습니다.

배포가 완료되었는지 어떻게 확인할 수 있나요?

설치 프로그램이 치명적인 오류 없이 완료되었는지, 다른 장치에서 서버의 LAN IP를 사용하여 포털이 열리는지, 그리고 초기 관리자 설정을 완료할 수 있는지 확인하십시오. 그런 다음 사용자를 추가하거나 파일을 공유하기 전에 방화벽 및 HTTPS 구성을 검토하십시오. 워크스페이스 데이터에 대한 별도의 백업 계획을 마련해 두십시오. 실행 중인 Docker 컨테이너는 백업이 아닙니다.

공식 문서

• ONLYOFFICE Workspace 커뮤니티 Docker 설치
• ONLYOFFICE Workspace Community Linux 설치 및 시스템 요구 사항
• ONLYOFFICE 커뮤니티 포트 및 설치 리소스
• ONLYOFFICE Workspace의 Linux용 HTTPS 구성