[Docker] 손쉽게 넥스트클라우드 개인나스 구성

 

최근에 개인 서버를 나스로 활용할 생각을 하고 있었다.

서버는 이미 미니PC를 통해 사용하고 있고, 문제는 OS였는데, 시놀로지 OS를 사용하기에는 너무 무겁고 엄청난 고난을 겪을 것 같았다. 그래서 이전에 자주 들어본 Nextcloud를 사용하게 되었는데, 내 서버 OS에 다이렉트로 설치했다간, 언제 갑자기 개발환경들과 대환장 콜라보를 할지 몰라 컨테이너화를 하게 되었다.

---

전체 구조

Docker Compose
├── db      : MariaDB 컨테이너 (데이터베이스)
└── app     : Nextcloud 컨테이너 (웹 애플리케이션)

 

 

---

docker-compose.yml

version: "3.9"

services:
  # MariaDB 데이터베이스
  db:
    image: mariadb:10.6
    restart: always
    command: --transaction-isolation=READ-COMMITTED
    volumes:
      - ./db:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=myrootpass1234
      - MYSQL_PASSWORD=mypass1234
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud

  # Nextcloud 앱
  app:
    image: nextcloud
    restart: always
    ports:
      - 5000:80
    depends_on:
      - db
    volumes:
      - ./dir:/var/www/html
    environment:
      - MYSQL_PASSWORD=mypass1234
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_HOST=db

volumes:
  db:
  dir:

 

 

각 항목 설명

1. MariaDB 컨테이너 (db)

• image: MariaDB 10.6 버전 사용
• restart: always: 컨테이너 자동 재시작
• command: 트랜잭션 격리 수준 READ-COMMITTED
• volumes: ./db 폴더를 컨테이너의 /var/lib/mysql에 마운트 → 데이터 영구 저장
• environment: DB 계정 및 비밀번호 설정
  • MYSQL_ROOT_PASSWORD : 루트 계정
  • MYSQL_DATABASE : Nextcloud 데이터베이스
  • MYSQL_USER / MYSQL_PASSWORD : Nextcloud 접속용 계정

2. Nextcloud 컨테이너 (app)

• image: 공식 Nextcloud 이미지 사용
• restart: always: 앱 자동 재시작
• ports: 호스트 5000번 → 컨테이너 80번 매핑
• depends_on: db 컨테이너 먼저 시작
• volumes: ./dir → /var/www/html 마운트 → 파일과 설정 영구 저장
• environment: DB 연결 정보 설정
  • MYSQL_HOST=db : 연결할 DB 호스트
  • MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD : DB 계정 정보

3. 볼륨 정의

• db : MariaDB 데이터 저장용
• dir : Nextcloud 파일 및 설정 저장용

---

사용 방법

1. docker-compose.yml 파일 생성
2. 같은 디렉터리에 db와 dir 폴더 생성 (없으면 자동 생성 가능)
3. Docker Compose 실행

docker-compose up -d

4. 브라우저에서 http://localhost:5000 접속 후 초기 설정 진행

---

모바일 앱 접속 설정

Nextcloud iOS/Android 앱에서 로그인 시 “Current user is not logged in” 오류가 발생하는 경우가 있다.
이 문제는 HTTPS 설정과 관련이 깊다.

Nextcloud 컨테이너 내부 config/config.php 파일에 다음 옵션을 추가해야 한다

 

'overwriteprotocol' => 'https',

 

이 옵션은 Nextcloud가 외부에서 접속할 때 HTTPS 프로토콜을 사용하도록 강제한다.

특히 Docker + Nginx 환경에서 HTTPS 리버스 프록시를 사용하는 경우 필수 설정임.

---

Nginx 업로드 용량 제한 수정

기본 Nginx 설정에서는 업로드 파일 크기에 제한이 있다.
Nextcloud에서 대용량 파일 업로드가 필요하면 Nginx 설정을 수정해야 한다.

 

예시 (nginx.conf 또는 사이트 설정):

server {
    listen 443 ssl;
    server_name example.com;

    location / {
        proxy_pass http://172.0.0.1:5000;
        proxy_set_header Host example.com;
        proxy_set_header Connection upgrade;

        # Nextcloud 전용 업로드 제한 해제
        client_max_body_size 50G;
        client_body_timeout 36000s;
        proxy_read_timeout 36000s;
        proxy_send_timeout 36000s;
    }
}

• client_max_body_size : 업로드 최대 용량 설정
• Nextcloud PHP 설정(php.ini)에서도 upload_max_filesize와 post_max_size를 동일하게 늘려야 대용량 업로드가 정상 동작한다.

---