Ubuntu 24.04 LTS에 ONLYOFFICE Workspace를 설정하는 방법

ONLYOFFICE Workspace는 온라인 문서 편집 기능과 더욱 폭넓은 협업 포털을 결합한 솔루션입니다. Ubuntu 24.04 LTS 환경에서 가장 간편한 서버 설정 방법은 Docker를 사용하여 ONLYOFFICE Workspace 커뮤니티 공식 설치 스크립트를 배포하는 것입니다. Docker는 Workspace 구성 요소를 격리된 컨테이너에서 실행하므로, 수동으로 구축하는 것보다 배포 및 업데이트가 훨씬 쉽습니다.

이 가이드에서는 커뮤니티 에디션을 기준으로 설명하며, 처음 관리자를 위한 실용적인 선택부터 시작합니다. 선택 사항인 ONLYOFFICE 메일 서버 없이 Workspace를 설치하는 것입니다. 이렇게 하면 첫 배포 시 DNS 및 메일 배달 관련 설정이 필요 없어집니다. 필요한 경우 나중에 제어판에서 메일 서버를 추가할 수 있습니다.

2026년 10월 현재, Docker는 Ubuntu 24.04 LTS(Noble)를 공식적으로 지원합니다. ONLYOFFICE의 최신 Workspace Community 문서에서는 최소 4코어 CPU, 8GB RAM, 40GB의 여유 디스크 공간, 6GB의 스왑 공간을 갖춘 amd64 Linux 호스트를 권장합니다. 원활한 배포를 위해 더 높은 CPU와 RAM을 권장합니다. 프로덕션 서버에 배포하기 전에 최신 ONLYOFFICE Workspace Community Docker 설치 가이드 와 Docker의 Ubuntu 설치 문서를 확인하십시오.

시작하기 전에 필요한 것

Ubuntu 24.04 LTS 서버 또는 가상 머신, 권한이 있는 계정 sudo, 패키지 및 컨테이너 이미지를 다운로드하기 위한 인터넷 연결, 그리고 Workspace 서비스에 필요한 충분한 여유 리소스가 필요합니다. 다른 컴퓨터에서 포털에 접속할 수 있도록 하려면 서버에 안정적인 LAN 주소 또는 공용 IP 주소도 필요합니다.

amd64는 Intel 및 AMD 프로세서에서 사용되는 일반적인 64비트 x86 서버 아키텍처를 의미합니다. Docker가 다른 아키텍처를 지원한다고 해서 ONLYOFFICE Workspace에서도 자동으로 지원한다고 생각하지 마십시오. 현재 Workspace 요구 사항에는 amd64 Linux가 명시적으로 지정되어 있습니다.

1단계: Ubuntu 호스트에 충분한 리소스가 있는지 확인합니다.

터미널을 열거나 SSH를 통해 서버에 연결하세요. 다음 명령어를 실행하세요:

uname -m
free -h
df -h

uname -m프로세서 아키텍처를 보고합니다. 호환되는 x86-64 호스트에서는 일반적으로 을 볼 수 있습니다 x86_64. free -h은 RAM과 스왑 공간을 보여주고, 은 df -h사람이 읽기 쉬운 단위로 사용 가능한 디스크 공간을 보여줍니다.

메모리나 저장 공간이 부족한 서버에서는 작업을 계속하지 마십시오. 설치는 완료될 수 있지만, 이후 편집 또는 인덱싱 작업 부하에서 오류가 발생할 수 있으며, 이는 용량 문제를 먼저 해결하는 것보다 진단하기가 더 어렵습니다.

2단계: Docker의 공식 Ubuntu 저장소에서 Docker Engine을 설치합니다.

Docker Engine은 Workspace 배포에 사용되는 컨테이너를 생성하고 실행하는 서비스입니다. Docker의 최신 Ubuntu 설치 지침은 Ubuntu 24.04 LTS를 지원하며, 일반적인 서버 설치에는 Docker 자체 APT 저장소를 사용할 것을 권장합니다.

먼저 기본 저장소 도구를 설치하세요.

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings

Docker의 현재 서명 키와 저장소를 추가합니다.

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

다음으로 Docker Engine과 Compose 플러그인을 설치하세요.

sudo apt install -y docker-ce docker-ce-cli containerd.io   docker-buildx-plugin docker-compose-plugin

서비스가 실행 중인지 확인하십시오.

sudo systemctl status docker --no-pager

3단계: ONLYOFFICE를 사용하기 전에 Docker를 확인합니다.

이 간단한 검사를 통해 Docker 문제와 Workspace 문제를 구분할 수 있습니다. 다음 명령을 실행하세요.

sudo docker run --rm hello-world

Docker는 아주 작은 테스트 이미지를 다운로드하고, 컨테이너를 시작하고, 확인 메시지를 출력한 후 종료됩니다. 이 과정이 실패하면 Workspace 스크립트를 계속 진행하기 전에 Docker 문제를 먼저 해결하십시오.

docker초보자들이 흔히 저지르는 실수는 권한 오류를 ONLYOFFICE 오류로 간주하는 것입니다 . 이 가이드에서는 의도적으로 `docker-resources`를 사용 sudo docker하므로 Docker 그룹에 계정을 추가할 필요가 없습니다. Docker는 해당 그룹의 멤버십이 루트 수준의 제어 권한을 부여하므로 명령어를 간소화하기 위해 무분별하게 사용자를 추가하지 말라고 경고합니다.

4단계: ONLYOFFICE Workspace 공식 설치 프로그램을 다운로드하세요.

ONLYOFFICE는 자체 다운로드 도메인에 설치 스크립트를 게시합니다. 직접 다운로드하세요.

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

다운로드한 관리 스크립트를 실행하기 전에 내용을 검토하는 것이 좋습니다.

less workspace-install.sh

q나가 려면 누르 세요 less. 이것은 스크립트가 안전하다는 것을 증명하는 것은 아니지만, 루트 권한을 부여하기 전에 소스를 확인하고 예상치 못한 명령을 발견할 기회를 제공합니다.

5단계: 메일 서버 없이 Workspace를 먼저 설치합니다.

최초 배포 시에는 ONLYOFFICE Mail 단계를 건너뛰고 공식 스크립트를 실행하십시오.

sudo bash workspace-install.sh -ims false

이 -ims false매개변수는 "메일 서버 구성 요소를 설치하지 마십시오"라는 의미입니다. 이렇게 하면 초기 설정이 Workspace 포털, 문서 편집기 및 관리 구성 요소에만 집중됩니다. ONLYOFFICE 문서에 대해서만 메일 기능을 제어판에서 나중에 설치할 수 있습니다.

이미 메일 서비스 도메인이 제대로 구성되어 있고 전체 설치를 원하시는 경우, ONLYOFFICE에서 제공하는 다음 양식을 참조하십시오.

sudo bash workspace-install.sh -md "mx1.example.com"

실제 메일 서비스 호스트 이름으로 바꾸십시오 mx1.example.com. 호스트 이름은 서버로 확인되어야 하며, 메일 도메인에는 적절한 DNS 레코드가 필요합니다. 설치 프로그램을 계속 진행하기 위해 임의로 만든 호스트 이름을 사용하지 마십시오. 잘못된 DNS 설정은 Workspace 배포를 성공적으로 완료했음에도 불구하고 메일 배달 문제를 일으키는 가장 쉬운 원인 중 하나입니다.

6단계: 컨테이너가 실제로 실행 중인지 확인합니다.

스크립트 실행이 완료되면 실행 중인 컨테이너를 검사하십시오.

sudo docker ps

온라인에서 볼 수 있는 예시와 컨테이너 이름이 다르더라도 걱정하지 마세요. 이름과 내부 구성 요소는 릴리스마다 변경될 수 있습니다. 중요한 것은 예상되는 ONLYOFFICE 컨테이너가 존재하고, 해당 컨테이너가 반복적으로 재시작되거나 종료되는 대신 실행 중 상태인지 확인하는 것입니다.

컨테이너가 계속 재시작되는 경우, 실제 이름을 확인한 후 docker ps -a다음 명령을 실행하세요.

sudo docker logs --tail 100 CONTAINER_NAME

CONTAINER_NAMEDocker에서 표시하는 이름으로 바꾸세요 . 이렇게 하는 것이 튜토리얼에서 사용했던 기존 컨테이너 이름을 복사하는 것보다 안전합니다.

7단계: 서버의 실제 네트워크 주소를 사용하여 포털을 엽니다.

다음 명령어를 사용하여 서버 주소를 찾으세요:

hostname -I

서버에 접속 가능한 브라우저에서 다음 링크를 여세요.

http://SERVER_IP

localhostONLYOFFICE의 Docker 가이드에서는 포털을 확인할 때 IP 주소 대신 머신의 네트워크 IP 주소를 사용하도록 명시적으로 권장합니다 127.0.0.1. 설치 후 초기 시작에는 몇 분 정도 소요될 수 있으므로, 짧은 지연이 배포 실패를 의미하는 것은 아닙니다.

8단계: 관리자 설정 완료

처음 실행 페이지에서는 포털 관리자 계정을 생성하라는 메시지가 나타납니다. 강력한 비밀번호를 설정하고, 유효한 이메일 주소를 입력하고, 올바른 언어와 시간대를 선택한 후, 라이선스 약관에 동의하십시오. ONLYOFFICE는 기본 비밀번호 정책에 따라 8~120자 사이의 길이가 요구되며, 나중에 보안 설정을 강화할 수 있다고 안내합니다.

초기 설정 마법사를 완료한 후, 문서 모듈을 열고 테스트 문서를 생성할 수 있는지 확인하십시오. 로그인 성공 여부만으로도 포털 접속이 가능하다는 것을 입증할 수 있으며, 문서를 열고 편집하는 과정을 통해 문서 편집 구성 요소가 올바르게 연결되었는지도 확인할 수 있습니다.

사용자를 초대하기 전에 설치 보안을 강화하십시오.

서버를 임시 연구실 용도 이상으로 사용할 경우 일반 HTTP에서 HTTPS로 전환하십시오. ONLYOFFICE 제어판에서 Let's Encrypt 인증서를 생성 및 적용하거나 기존 인증서와 개인 키를 사용할 수 있습니다. 내장된 Let's Encrypt 워크플로를 사용하려면 인증서 발급 중에 80번 포트에 접근할 수 있어야 합니다. 자세한 내용은 ONLYOFFICE HTTPS 구성 가이드를 참조하십시오 .

또한 실제로 필요한 네트워크 포트를 검토하십시오. ONLYOFFICE는 Workspace 커뮤니티 포트 참조표를 제공합니다 . 해당 표에 나와 있다고 해서 데이터베이스 또는 내부 서비스 포트를 인터넷에 노출하지 마십시오.

Ubuntu에는 호스트 방화벽인 UFW가 포함되어 있지만, Docker와 관련된 중요한 주의 사항이 있습니다. Docker 문서에 따르면 컨테이너에서 공개된 포트는 UFW 규칙을 우회할 수 있습니다. 즉, "UFW에서 차단했다"는 것만으로는 Docker에서 공개된 포트에 접근할 수 없다는 것을 보장할 수 없습니다. Docker의 방화벽 동작 방식을 검토하고, 인터넷에 연결된 서버의 경우 UFW만으로 모든 컨테이너 포트를 제어한다고 가정하기보다는 적절하게 설계된 호스트 또는 상위 방화벽 정책을 사용하는 것이 좋습니다. Ubuntu 자체 방화벽에 대한 자세한 내용은 Ubuntu Server 방화벽 문서를 참조하십시오 .

흔히 발생하는 문제와 우선 확인해야 할 사항

설치 프로그램에서 필요한 포트가 이미 사용 중이라고 표시됩니다.

임의 서비스 중지 전에 리스너를 확인하세요.

sudo ss -ltnp | grep -E ':(80|443)\b'

Apache, Nginx, 다른 컨테이너 또는 관리 패널이 이미 해당 포트를 사용하고 있다면 어떤 서비스가 포트를 계속 사용할지 결정해야 합니다. 운영 중인 웹 서버를 섣불리 종료하지 마십시오.

설치 후 포털이 로드되지 않습니다.

Docker를 먼저 확인하세요:

sudo systemctl is-active docker
sudo docker ps -a

Docker가 비활성화된 경우 Docker를 시작하고 로그를 확인하십시오. 워크스페이스 컨테이너는 실행 중이지만 페이지에 접속할 수 없는 경우, 올바른 서버 IP를 사용하고 있는지, 라우팅, 클라우드 보안 그룹 및 상위 방화벽에서 필요한 웹 트래픽을 허용하는지 확인하십시오.

설치 중에 서버 메모리가 부족해집니다

다시 확인해 보세요 free -h. 워크스페이스 스크립트 기반 가이드에서는 최소 6GB의 스왑 공간과 8GB의 RAM을 최소 요구 사양으로 제시하고 있습니다. 매우 작은 VM은 여러 이미지가 동시에 초기화될 때 불안정해질 수 있습니다. 메모리 부족 문제를 해결하기 위해 모든 서비스를 최적화하는 것보다 더 큰 VM으로 마이그레이션하는 것이 일반적으로 더 깔끔한 해결책입니다.

나중에는 OFFICE Mail만 있으면 됩니다.

Workspace를 다시 설치할 필요는 없습니다. ONLYOFFICE 문서에서는 제어판의 업데이트 페이지에서 메일 서버를 추가하는 방법을 안내합니다. 그 전에 실제 서비스 호스트 이름과 DNS 레코드를 준비하십시오. 기존 Workspace 설치에 메일을 추가하는 방법에 대한 자세한 내용은 ONLYOFFICE 가이드를 참조하십시오 .

설치 스크립트 대신 Docker Compose를 선호하시는군요.

이는 배포 정의를 더욱 세밀하게 제어하고 싶을 때 유효한 대안입니다. ONLYOFFICE의 최신 Compose 지침은 Ubuntu 22.04 이상 버전에서 Docker Compose 2.16.0 이상을 요구하며, 관리자에게 cgroupWorkspace YAML 파일에서 관련 줄을 활성화하도록 안내합니다. Ubuntu 24.04는 "22.04 이상" 범주에 속합니다. 관련 없는 튜토리얼에서 가져온 이전 Compose 파일을 복사하는 대신 ONLYOFFICE의 공식 Docker Compose 가이드를 따르십시오.

설치가 완전히 완료되었는지 어떻게 알 수 있을까요?

정상적인 설치는 다음과 같은 몇 가지 독립적인 상태 확인을 통해 확인할 수 있습니다. Docker가 활성화되어 있는지, Workspace 컨테이너가 계속 실행 중인지, 다른 컴퓨터에서 서버의 실제 네트워크 주소를 사용하여 포털이 열리는지, 관리자가 로그인할 수 있는지, 그리고 테스트 문서가 브라우저 편집기에서 열리는지 등을 확인해야 합니다. 서비스를 공개적으로 제공할 계획이라면 브라우저가 신뢰하는 인증서를 사용하여 HTTPS가 제대로 작동하는지도 확인해야 합니다.

우분투 24.04를 처음 설치할 때는 이러한 점검 후 바로 메일, 사용자 지정 리버스 프록시, 타사 스토리지 및 인증 통합을 추가하는 것보다 중단하는 것이 좋습니다. 한 번에 하나의 기능만 추가하고, 검증하고, DNS, 방화벽 및 컨테이너 변경 사항을 기록해 두세요. 이렇게 하면 나중에 문제를 훨씬 더 예측 가능하게 해결할 수 있습니다.