raspberry pi에 nextcloud office를 built-in CODE Server로 설치하는 방법 (feat. ChatGPT)

로

1. 사전 준비

📌 필요한 사항

  • 라즈베리파이(Raspberry Pi 4 이상 권장, 64-bit OS 추천)
  • Nextcloud 설치 완료
  • 도메인 및 SSL 인증서(Optional) (Let’s Encrypt 추천)
  • Docker(선택 사항) (Collabora를 Docker로 설치할 수도 있음)

📌 환경 체크

Nextcloud가 정상적으로 실행되는지 확인:

bash
sudo -u www-data php /var/www/html/nextcloud/occ status

PHP 및 MySQL 버전 체크:

bash
php -v
mysql --version

2. Nextcloud Office 앱 설치

  1. Nextcloud 관리자로 로그인
  2. 앱(Apps) → Office & Text 에서 Nextcloud Office(이전의 “Collabora Online”) 설치
  3. 앱(Apps) → Office & Text 에서 Built-in CODE Server 설치

설치 후 설정(Settings) → 관리(Admin) → Office 로 이동하여
✅ “Use the built-in CODE server” 옵션을 활성화

이제 Nextcloud가 내장된 CODE 서버를 사용하게 됨.

3. 방화벽 및 포트 확인

📌 기본 포트

  • Nextcloud: 80, 443
  • CODE Server: 9980

📌 방화벽 설정 (UFW 사용 시)

bash
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 9980/tcp
sudo ufw reload

4. 주요 오류 및 해결 방법

🔴 1. Nextcloud Office가 CODE 서버를 찾지 못함

🚨 오류 메시지:

“Could not establish connection to the Collabora Online server.”

✅ 해결 방법:

1️⃣ Nextcloud의 CODE 서버 활성화 상태 확인

bash
sudo -u www-data php /var/www/html/nextcloud/occ app:list | grep richdocumentscode

출력이 없으면 다음 명령으로 활성화:

bash
sudo -u www-data php /var/www/html/nextcloud/occ app:enable richdocumentscode

2️⃣ CODE 서버가 정상 실행 중인지 확인

bash
sudo netstat -tulnp | grep 9980

출력이 없다면 Nextcloud를 재시작:

bash
sudo systemctl restart apache2

또는 Nginx 사용 시:

bash
sudo systemctl restart nginx

🔴 2. 문서를 열 때 “Connection timeout” 발생

🚨 오류 메시지:

“Failed to load Collabora Online – please try again later.”

✅ 해결 방법:

1️⃣ PHP 메모리 증가
/etc/php/8.0/apache2/php.ini (버전에 따라 다를 수 있음)에서:

ini
memory_limit = 512M
upload_max_filesize = 100M
post_max_size = 100M

적용 후 웹 서버 재시작:

bash
sudo systemctl restart apache2

2️⃣ Nextcloud 캐시 설정 (Redis 권장)

bash
sudo apt install redis-server php-redis

/var/www/html/nextcloud/config/config.php 에 추가:

php
'memcache.local' => '\OC\Memcache\Redis',
'redis' => [
'host' => 'localhost',
'port' => 6379,
],

적용 후 웹 서버 재시작:

bash
sudo systemctl restart apache2

🔴 3. SSL/TLS 오류 발생

🚨 오류 메시지:

“Collabora Online server is not reachable via HTTPS.”

✅ 해결 방법:

1️⃣ Let’s Encrypt로 SSL 인증서 설정

bash
sudo apt install certbot python3-certbot-apache
sudo certbot --apache

또는 Nginx 사용 시:

bash
sudo certbot --nginx

2️⃣ Collabora Online과 Nextcloud 간의 HTTPS 강제 적용 해제
/var/www/html/nextcloud/config/config.php 에 추가:

php
'overwriteprotocol' => 'https',

적용 후 웹 서버 재시작:

bash
sudo systemctl restart apache2

🔴 4. Docker를 사용한 Collabora 설치

만약 Built-in CODE Server가 제대로 작동하지 않는다면 Docker로 설치할 수도 있음.

1️⃣ Docker 설치

bash
sudo apt install docker.io

2️⃣ Collabora Online 컨테이너 실행

bash
sudo docker run -t -d -p 9980:9980 --restart always --cap-add MKNOD collabora/code

3️⃣ Nextcloud 설정에서 “Use your own server” 선택 후 https://yourdomain.com:9980 입력

5. 결론

이제 Nextcloud Office에서 Built-in CODE Server를 사용할 수 있어!
만약 내장된 CODE Server가 느리거나 자주 끊긴다면, Docker를 이용한 Collabora Online 설치를 고려해봐.
추가적으로 문제가 발생하면 로그를 확인하고 대응하면 돼!

📌 로그 확인 방법:

bash
sudo tail -f /var/www/html/nextcloud/data/nextcloud.log
sudo journalctl -u apache2 -f

질문 있으면 언제든지 알려줘 😊

댓글 남기기