NextCloud Hub 데스크탑 클라이언트 상세 안내서

1. NextCloud Hub와 데스크탑 클라이언트의 이해

1.1 NextCloud Hub 개요: 데이터 주권의 실현

NextCloud Hub는 단순한 파일 호스팅 서비스를 넘어, 사용자와 조직이 자신의 데이터를 직접 통제하고 관리할 수 있는 ’자체 호스팅(Self-hosting) 생산성 플랫폼’이다.1 이는 모든 데이터가 제3자의 서버가 아닌 자신이 선택한 인프라(온프레미스, 클라우드, 하이브리드)에 저장됨을 의미하며, 이를 통해 데이터 유출 위험을 원천적으로 차단하고 완전한 ’데이터 주권’을 실현한다.3 Google Drive, Dropbox, Microsoft 365와 같은 상용 서비스와의 근본적인 차별점은 바로 이 지점에서 발생한다.2

NextCloud Hub의 핵심은 개별 애플리케이션의 단순한 집합이 아닌, 유기적으로 통합된 단일 협업 플랫폼이라는 점에 있다.4 Hub는 다음과 같은 핵심 구성 요소를 포함한다.

• Files: 파일 동기화 및 공유의 중심.

• Talk: 채팅, 화상 회의, 화면 공유 기능 제공.

• Groupware: Calendar, Contacts, Mail을 통합하여 팀 생산성 관리.

• Office: Collabora Online 또는 ONLYOFFICE와 연동하여 실시간 문서 공동 편집 지원.

• Assistant: 로컬에서 실행되는 AI 비서로, 이메일 요약, 콘텐츠 생성, 번역 등 지원.

• Flow: 반복적인 작업을 자동화하는 워크플로우 엔진.

이러한 통합은 사용자가 컨텍스트 전환 없이 원활한 업무 흐름을 유지하도록 돕는다. 예를 들어, 공유된 문서를 편집하면서 즉시 Talk 화상 회의를 시작하거나, Assistant를 호출하여 이메일 스레드를 요약하는 작업이 가능하다.6

이러한 기능적 확장은 NextCloud가 초기의 파일 동기화 및 공유(FSS) 솔루션에서 벗어나, 이제는 Microsoft 365나 Google Workspace와 직접 경쟁하는 포괄적인 ’콘텐츠 협업 플랫폼’이자 ’디지털 작업 공간’으로 진화했음을 보여준다. 이는 사용자의 모든 디지털 작업을 NextCloud 생태계 내에서 완결시키려는 명확한 전략적 방향성을 나타낸다.4

NextCloud는 AGPL-3.0 라이선스 기반의 오픈소스 소프트웨어로서, 투명성과 커뮤니티 기반의 지속적인 발전을 보장하며 특정 벤더에 대한 기술적 종속(Lock-in)을 방지한다.4

또한, NextCloud가 실현하는 데이터 주권은 단순히 데이터를 암호화하고 격리하는 것을 넘어선다. 기존 IT 자산과의 ’깊은 통합(Deep integration)’을 통해 조직이 이미 보유한 다양한 스토리지 인프라(FTP, Windows Network Drive, SharePoint, Amazon S3, NFS 등)를 그대로 활용하면서 중앙에서 통제하고 접근할 수 있는 관리의 유연성을 제공한다.3 이는 새로운 데이터 사일로(silo)를 만드는 대신, 분산된 데이터를 통합하고 통제권을 부여함으로써 진정한 의미의 데이터 주권을 완성하는 접근 방식이다.

1.2 데스크탑 클라이언트의 역할과 중요성: 로컬과 클라우드의 완벽한 결합

NextCloud 데스크탑 클라이언트는 NextCloud 서버에 저장된 파일을 사용자의 로컬 컴퓨터와 동기화하는 핵심 도구이다.9 이는 웹 브라우저를 통하지 않고도 파일에 접근하고 작업할 수 있게 하여 생산성을 극대화하는 관문 역할을 한다.1 Windows, macOS, Linux 등 주요 데스크탑 운영체제를 모두 지원하여 플랫폼에 구애받지 않는 일관된 사용자 경험을 제공한다.11

클라이언트는 단순한 파일 동기화 유틸리티를 넘어, 운영체제의 파일 탐색기(Windows 탐색기, macOS Finder 등)와 직접 통합되는 ’확장 인터페이스’로서 기능한다. 사용자는 익숙한 로컬 환경에서 파일 공유, 버전 관리, 파일 잠금과 같은 NextCloud의 고급 기능을 직접 수행할 수 있다.1

NextCloud는 파일 동기화를 위한 ‘Files’ 클라이언트 외에도, 웹 브라우저 없이 Talk 대화 및 회의에 신속하게 접근할 수 있는 별도의 ‘Talk’ 데스크탑 클라이언트를 제공한다.14 이는 NextCloud가 각 기능에 특화된 최적의 데스크탑 경험을 제공하려는 노력을 보여주는 사례이다.

2. 설치 및 계정 설정

2.1 운영체제별 설치 가이드

2.1.1 Windows 설치

Windows 사용자는 Nextcloud 공식 웹사이트에서 .msi 또는 .exe 형식의 설치 파일을 다운로드하여 설치를 진행할 수 있다.1 설치 마법사를 통해 진행되는 표준 설치 과정은 직관적이며 몇 번의 클릭만으로 완료된다.15

시스템 관리자나 고급 사용자는 명령줄 인터페이스(CLI)를 통해 설치 과정을 자동화하거나 세부적으로 제어할 수 있다. 이는 조직 내 대규모 배포 시 매우 유용하다.16

msiexec 명령어를 사용하여 다음과 같은 속성(Property)을 지정할 수 있다.

• 기능 선택 및 제외:

• REMOVE=DesktopShortcut: 바탕화면 바로가기 생성을 제외한다. StartMenuShortcuts, ShellExtensions 등 다른 기능도 제외할 수 있다.16

• ADDDEFAULT=Client: 셸 확장 등 부가 기능 없이 핵심 클라이언트만 설치한다.16

• 설치 경로 지정:

• INSTALLDIR="C:\Nextcloud": 기본 설치 경로를 변경한다.16

• 동작 제어:

• SKIPAUTOUPDATE="1": 클라이언트의 자동 업데이트 기능을 비활성화한다.16

• LAUNCH="1": 설치 완료 후 클라이언트를 자동으로 실행한다.16

• DO_NOT_SCHEDULE_REBOOT="1": 셸 확장 설치 후 필요한 시스템 재부팅을 자동으로 예약하지 않는다.16

2.1.2 macOS 설치

macOS 사용자는 공식 웹사이트에서 .pkg 또는 .dmg 파일을 다운로드하여 표준적인 애플리케이션 설치 절차를 따르면 된다.16 설치가 완료되면 Nextcloud 클라이언트는 별도의 메인 UI 창 없이 상단 메뉴 막대(menu bar)에 아이콘 형태로 상주하며 백그라운드에서 작동하는 것이 특징이다.19

터미널 사용에 익숙한 경우, Homebrew나 MacPorts와 같은 패키지 관리자를 통해서도 설치할 수 있다. 예를 들어, Homebrew를 사용하는 경우 다음 명령어로 Talk 클라이언트를 설치할 수 있다.21

brew install --cask nextcloud-talk

2.1.3 Linux 설치

Linux 환경에서는 배포판의 특성에 따라 다양한 설치 방법이 제공된다.14

• PPA (Ubuntu/Debian 계열): 가장 권장되는 방법 중 하나로, 공식 PPA(Personal Package Archive)를 추가하여 apt 패키지 관리자를 통해 설치 및 업데이트를 관리할 수 있다. 터미널에 다음 명령어를 순서대로 입력한다.23

sudo add-apt-repository ppa:nextcloud-devs/client
sudo apt update
sudo apt install nextcloud-client

• AppImage: 배포판에 독립적인 실행 파일 형식으로, Nextcloud가 공식적으로 제공하는 패키지다. 공식 웹사이트에서 AppImage 파일을 다운로드한 후, 실행 권한을 부여하고 실행하면 된다.23

• Flatpak: Flathub를 통해 배포판 독립적인 Flatpak 패키지를 설치할 수 있다.23

• 파일 탐색기 통합: Nautilus(GNOME), Dolphin(KDE) 등 주요 파일 관리자와의 완벽한 통합(우클릭 메뉴 등)을 위해서는 nautilus-nextcloud와 같은 별도의 패키지를 추가로 설치해야 할 수 있다.13

2.2 서버 연결 및 초기 설정

클라이언트를 처음 실행하면 Nextcloud 서버 주소(URL)를 입력하는 창이 나타난다.15 웹 브라우저에서 접속할 때 사용하는 주소와 동일한 주소를 입력한 후 다음 단계로 진행한다.

서버 주소를 입력하면 시스템의 기본 웹 브라우저가 자동으로 열리며, Nextcloud 로그인 페이지로 이동한다. 이곳에서 사용자 이름과 암호를 입력하여 로그인한 후, 데스크탑 클라이언트가 계정 데이터에 접근할 수 있도록 권한을 부여(‘Grant access’)해야 한다. 이 과정은 보안성이 높은 OAuth 2.0 인증 방식을 기반으로 한다.1

2.2.1 2단계 인증(2FA)과 앱 암호

서버에 2단계 인증(TOTP 등)이 활성화된 경우, 일반 계정 비밀번호로는 데스크탑 클라이언트와 같은 외부 애플리케이션에서 인증에 실패한다.27 이는 보안 강화를 위한 당연한 조치이며, 이 문제를 해결하기 위해 ’앱 암호(App Password)’를 사용해야 한다.

앱 암호는 단순한 인증 수단을 넘어, 각 애플리케이션의 접근을 개별적으로 통제하고 관리할 수 있는 세분화된 보안 제어 메커니즘으로 기능한다. 2단계 인증의 일차적 목적은 비(非)브라우저 클라이언트의 인증을 가능하게 하는 것이지만, 부가적으로는 각 클라이언트/디바이스에 고유한 접근 토큰을 부여하는 역할을 한다. 만약 특정 디바이스를 분실하거나 보안이 의심될 경우, 전체 계정의 비밀번호를 변경할 필요 없이 해당 디바이스의 앱 암호만 무효화하여 접근을 차단할 수 있다. ‘보안’ 설정 페이지에서는 생성된 각 앱 암호의 마지막 사용 시간을 추적하고 개별적으로 접근 권한을 취소(revoke)할 수 있다.29

앱 암호 생성 및 사용 절차는 다음과 같다.

1. Nextcloud 웹 인터페이스에 로그인하여 우측 상단 프로필 아이콘을 클릭한 후 ‘설정’ > ‘보안’ 메뉴로 이동한다.19

2. 페이지 하단의 ‘앱 및 세션’ 섹션에서 ’새 앱 암호 만들기’를 클릭하고, 식별하기 쉬운 이름(예: ‘Windows Desktop Client’)을 입력한다.27

3. 생성된 고유한 암호를 복사한다. 이 암호는 다시 표시되지 않으므로 안전한 곳에 보관하거나 즉시 사용해야 한다.

4. 복사한 앱 암호를 데스크탑 클라이언트의 암호 입력란에 붙여넣어 로그인을 완료한다.27

2.2.2 로컬 동기화 폴더 설정

서버 인증이 완료되면 로컬 동기화 설정을 구성하는 단계로 넘어간다. 여기서는 두 가지 주요 옵션을 선택할 수 있다.

• 동기화 범위 선택: 서버의 모든 파일을 로컬 컴퓨터와 동기화할지, 아니면 특정 폴더만 선택적으로 동기화할지 결정한다.1

• 로컬 폴더 위치: 동기화된 파일이 저장될 로컬 컴퓨터의 폴더를 지정한다. 기본 경로는 보통 사용자 홈 디렉토리 내의 Nextcloud 폴더이지만, ‘변경’ 버튼을 통해 원하는 다른 경로로 수정할 수 있다.1

초기 설정 단계에서 ‘가상 파일 사용’ 옵션을 활성화하여 디스크 공간을 효율적으로 사용할 수도 있다.32 모든 설정을 마친 후 ‘연결’ 버튼을 누르면 동기화가 시작된다.

3. 핵심 기능 완벽 활용 가이드

3.1 파일 동기화 메커니즘 심층 분석

Nextcloud 동기화의 기본 원칙은 로컬 컴퓨터와 서버 양쪽의 변경 사항(생성, 수정, 삭제)을 지속적으로 감지하여 항상 최신 상태로 유지하는 양방향 동기화이다.1 데스크탑 클라이언트는 사용자의 작업 환경과 필요에 따라 여러 동기화 전략을 제공한다.

3.1.1 선택적 동기화(Selective Sync)

선택적 동기화는 서버의 전체 폴더 구조 중에서 사용자가 동기화를 원하는 특정 폴더만 로컬 컴퓨터에 다운로드하는 기능이다.26 클라이언트의 계정 설정 탭에서 ‘동기화할 항목 선택’ 메뉴를 통해 동기화할 폴더를 체크하거나 해제하여 손쉽게 설정할 수 있다.26

이 방식의 가장 큰 장점은 로컬 디스크 공간을 절약하고, 불필요한 파일의 동기화로 인한 네트워크 트래픽을 줄일 수 있다는 점이다. 하지만 동기화하도록 선택하지 않은 폴더와 파일은 로컬 파일 탐색기에서 보이지 않으므로, 해당 데이터에 접근하려면 웹 인터페이스를 사용해야 하는 단점이 있다. 또한, 구조적으로 하위 폴더만 선택하고 상위 폴더는 동기화에서 제외할 수 없는 제약이 따른다.32

3.1.2 가상 파일 시스템(Virtual File System, VFS)

‘주문형 파일(Files On-Demand)’ 또는 ’가상 드라이브’로도 불리는 가상 파일 시스템(VFS)은 서버에 있는 모든 파일과 폴더를 실제 데이터 없이 ‘자리 표시자(placeholder)’ 파일 형태로 로컬 컴퓨터에 보여주는 혁신적인 기술이다.1

사용자가 자리 표시자 파일을 더블클릭하여 처음 열 때, 해당 파일만 서버에서 실시간으로 다운로드된다. 다운로드된 파일은 일정 기간 로컬 캐시에 보관되어 오프라인 상태에서도 접근할 수 있다.1 이 방식은 최소한의 로컬 저장 공간만 사용하면서도 서버의 전체 파일 구조에 접근할 수 있어 매우 효율적이다.26

계정 설정에서 폴더별로 ‘가상 파일 사용’ 옵션을 활성화하여 이 기능을 사용할 수 있다.32 VFS가 활성화되면 파일 탐색기에서 각 파일의 상태를 아이콘으로 확인할 수 있으며, 우클릭 컨텍스트 메뉴를 통해 ’항상 이 장치에 유지(Always keep on this device)’를 선택하여 특정 파일을 영구적으로 오프라인 상태로 만들거나, ’공간 확보(Free up space)’를 선택하여 다시 온라인 전용 상태로 되돌릴 수 있다.32

운영체제별로 구현 방식에 차이가 있다. Windows에서는 OneDrive와 유사한 네이티브 API를 사용하여 파일 탐색기와 매끄럽게 통합되지만, macOS와 Linux에서는 .nextcloud 확장자를 가진 0바이트 파일을 생성하고 이를 클라이언트가 가로채 처리하는 방식으로 구현되어 사용자 경험에 약간의 차이가 있을 수 있다.35

VFS의 도입은 동기화 패러다임의 전환을 의미한다. 전통적인 선택적 동기화 모델이 사용자가 ’무엇을 로컬에 둘 것인가’를 명시적으로 결정하는 ‘관리’ 중심의 방식이었다면, VFS는 시스템이 ’사용자가 필요로 할 때 데이터를 가져온다’는 원칙으로 작동하는 ‘접근성’ 중심의 방식이다. VFS는 편의성과 저장 공간 효율성을 극대화하지만, 안정적인 오프라인 작업을 위해서는 사용자가 ‘항상 오프라인 사용 가능’ 상태로 변경하는 추가적인 행동을 취해야 하는 트레이드오프가 존재한다. 이는 상시 온라인 환경을 전제로 사용자 경험을 단순화하는 방향으로의 변화이며, 사용자의 작업 패턴에 따라 장점이 될 수도, 단점이 될 수도 있다.

다음 표는 각 동기화 방식의 특징을 비교 분석한 것이다.

3.2 파일 탐색기를 통한 협업 기능

데스크탑 클라이언트는 운영체제의 파일 탐색기와 깊게 통합되어, 웹 UI를 열지 않고도 다양한 협업 기능을 직접 사용할 수 있게 해준다.1

3.2.1 파일 및 폴더 공유

동기화된 폴더 내의 파일이나 폴더를 우클릭하면 나타나는 ‘Nextcloud’ 컨텍스트 메뉴에서 ’공유 옵션’을 선택하여 공유 대화상자를 열 수 있다.1

• 내부 사용자/그룹 공유: Nextcloud 서버에 등록된 다른 사용자나 그룹의 이름을 입력하여 직접 공유하고, 편집, 재공유 등의 권한을 부여할 수 있다.37

• 공개 링크 공유: 계정이 없는 외부 사용자와 공유하기 위해 고유한 URL 링크를 생성할 수 있다.37

• 고급 공유 옵션: 생성된 링크에 대해 다음과 같은 세부적인 제어가 가능하다.

• 암호 설정

• 만료일 지정

• 업로드 및 편집 허용

• 다운로드 숨기기 (보안 보기)

• 파일 드롭 (File Drop): 상대방은 폴더 내용물을 볼 수 없고 오직 파일 업로드만 가능.3

최신 클라이언트(v3.7 이상)에서는 공유 대화상자가 재설계되어 여러 개의 공유 링크를 생성하고 관리하는 것이 더욱 편리해졌다.40

3.2.2 파일 잠금(File Locking)

사용자가 로컬 컴퓨터에서 파일을 열어 편집하는 동안, 해당 파일은 서버에서 자동으로 잠금 처리된다. 이는 다른 사용자가 동시에 같은 파일을 편집하여 발생할 수 있는 데이터 손실이나 충돌을 효과적으로 방지해준다.3 이 기능은 특히 여러 사람이 Microsoft Office 문서와 같은 바이너리 파일을 다루는 환경에서 매우 중요하다. 서버 관리자는 관리자 설정에서 잠금 시간 초과(timeout)를 구성할 수 있다.7

3.3 클라이언트 인터페이스 및 상태 관리

3.3.1 시스템 트레이 아이콘

클라이언트의 현재 상태를 직관적으로 보여주는 핵심 지표로, Windows의 작업 표시줄, macOS의 메뉴 막대에 위치한다. 각 아이콘의 의미는 다음과 같다.13

• 녹색 체크: 동기화가 완료되었고 서버와 정상적으로 연결된 상태.

• 파란색 순환: 파일 업로드 또는 다운로드 등 동기화가 진행 중인 상태.

• 회색 평행선: 사용자에 의해 동기화가 일시 중지된 상태.

• 노란색 느낌표: 정보성 알림이 있거나 해결되지 않은 동기화 충돌이 발생한 상태.

• 빨간색 X: 서버 주소 오류, 인증 실패 등 설정 오류나 심각한 문제가 발생한 상태.

3.3.2 메인 다이얼로그

시스템 트레이 아이콘을 좌클릭하면 열리는 창으로, 최근 파일 변경, 공유 활동, 오류, 서버 알림 등을 시간순으로 보여준다.31 동기화 관련 문제가 발생했을 때 가장 먼저 확인해야 할 정보 창이다.

3.3.3 파일 탐색기 오버레이 아이콘

동기화 폴더 내의 각 파일과 폴더 아이콘 위에 겹쳐 표시되어, 개별 항목의 동기화 상태를 시각적으로 알려준다. 이 아이콘들은 시스템 트레이 아이콘과 유사한 의미를 가지며, 사용자가 파일들의 상태를 한눈에 파악할 수 있도록 돕는다.13

다음 표는 파일 탐색기에 표시되는 주요 오버레이 아이콘의 의미를 설명한다.

3.3.4 사용자 상태 설정

Nextcloud 서버에 ‘User status’ 앱이 설치되어 있는 경우, 데스크탑 클라이언트의 메인 다이얼로그에서 직접 자신의 상태(온라인, 자리 비움, 방해 금지 등)와 상태 메시지를 설정할 수 있다.31 이는 Nextcloud Talk와 같은 다른 Hub 애플리케이션과의 연동성을 높여 팀원 간의 현재 상태 공유를 원활하게 한다.

4. 고급 구성 및 최적화

4.1 네트워크 설정

4.1.1 대역폭 제한

클라이언트 설정의 ‘네트워크’ 탭에서 업로드 및 다운로드 속도를 제한하여 네트워크 대역폭 사용량을 조절할 수 있다.7 이는 인터넷 회선 속도가 느리거나 화상 회의 등 다른 애플리케이션의 네트워크 사용량을 보장해야 할 때 유용하다. ‘자동으로 제한’ 옵션을 선택하거나, 특정 속도(KB/s 단위)를 직접 입력하여 수동으로 설정할 수 있다.42

이 기능은 클라이언트 측면에서 트래픽을 조절하는 방식이다. 서버 관리자가 모든 사용자의 대역폭을 중앙에서 통제하고자 할 경우, Nextcloud 서버 자체에는 해당 기능이 내장되어 있지 않다. 대신, Nginx와 같은 리버스 프록시 서버 단에서 limit_rate와 같은 지시어를 사용하여 서버 측 대역폭 제한을 구현해야 한다.43 즉, 개별 사용자를 위한 ’클라이언트 측 제한’과 서버 자원 관리를 위한 ’서버 측 제한’은 서로 다른 계층에서 작동하는 별개의 기능이다.

4.1.2 프록시 서버 설정

기업이나 기관 네트워크와 같이 인터넷 연결을 위해 프록시 서버를 경유해야 하는 환경에서는 클라이언트의 ‘네트워크’ 설정에서 프록시 서버 정보를 구성해야 한다.7 ‘시스템 프록시 사용’ 옵션을 통해 운영체제에 설정된 값을 자동으로 사용하거나, ’수동으로 프록시 지정’을 선택하여 프록시 서버의 주소, 포트, 필요한 경우 인증 정보(사용자 이름 및 암호)를 직접 입력할 수 있다.46

만약 Nextcloud 서버가 리버스 프록시 뒤에서 운영되는 경우, 클라이언트 연결 문제 발생 시 서버 측의 config.php 파일 설정이 올바른지 확인해야 한다. 특히 trusted_proxies, overwriteprotocol, overwritehost 등의 매개변수가 리버스 프록시 환경에 맞게 정확하게 설정되어야 클라이언트가 서버와 정상적으로 통신할 수 있다.48

4.2 동기화 제외 설정 (무시된 파일 편집기)

특정 패턴의 파일이나 폴더를 동기화 대상에서 제외하여 불필요한 트래픽을 줄이고 잠재적인 충돌을 방지할 수 있다.13 설정 창의 ‘일반’ 탭에 있는 ’무시된 파일 편집기’를 통해 제외 목록을 관리할 수 있다.

기본적으로 시스템 임시 파일, Nextcloud의 잠금 파일 등이 제외 목록에 포함되어 있다. 사용자는 여기에 자신만의 규칙을 추가할 수 있다. 예를 들어, 소스 코드 프로젝트의 node_modules/ 폴더나 컴파일 부산물(*.o, *.obj), 디자인 작업의 임시 파일(~*.*) 등을 추가할 수 있다. 와일드카드 문자(*, ?)를 사용하여 유연한 패턴 매칭이 가능하다.13

4.3 알림 설정

클라이언트는 파일 공유, 댓글, Talk 메시지, 동기화 오류 등 다양한 이벤트에 대해 데스크탑 알림을 표시한다. 설정의 ‘일반’ 탭에 있는 ‘서버 알림 표시’ 체크박스를 통해 이러한 알림의 표시 여부를 전반적으로 제어할 수 있다.41

하지만 데스크탑 클라이언트의 알림 시스템은 서버의 상태를 반영하는 ’뷰어’에 가깝고, 알림의 생성과 영구적인 상태 관리는 서버 측에서 이루어진다는 점을 이해하는 것이 중요하다. 예를 들어, 사용자들이 생일 알림이나 앱 추천 알림이 반복적으로 나타나는 불편함을 겪는 경우가 있는데 52, 이는 데스크탑 클라이언트에서 알림을 닫아도 서버에서는 해당 알림이 ‘읽지 않음’ 상태로 남아있기 때문이다. 클라이언트가 재시작되거나 서버와 다시 통신할 때 동일한 알림이 다시 수신되는 것이다.53

이러한 문제를 근본적으로 해결하기 위해서는 웹 인터페이스에 로그인하여 서버의 알림 센터에서 직접 해당 알림을 해제하거나, ’Nextcloud announcements’와 같이 알림을 생성하는 서버 앱 자체의 설정을 변경하거나 비활성화해야 한다.52

5. 문제 해결 가이드

5.1 동기화 충돌 해결

동기화 충돌은 두 명 이상의 사용자가 거의 동시에 같은 파일을 수정했거나, 한 사용자가 오프라인 상태에서 파일을 수정한 후 온라인이 되었을 때 서버의 파일이 이미 다른 사용자에 의해 변경된 경우에 발생한다.55

Nextcloud 클라이언트는 이러한 충돌을 자동으로 병합하지 않는다. 대신 데이터의 무결성을 보존하기 위해, 서버에 있는 버전을 기본 파일(예: mydata.txt)로 다운로드하고, 사용자의 로컬 변경 사항은 mydata (conflicted copy 2024-01-01 123000).txt와 같이 타임스탬프가 포함된 별도의 파일로 안전하게 보관한다.55

충돌 해결을 위한 단계별 절차는 다음과 같다.

1. 시스템 트레이 아이콘의 노란색 느낌표나 메인 다이얼로그에 표시된 ‘해결되지 않은 충돌’ 알림을 확인한다.55

2. 충돌이 발생한 폴더로 이동하여 원본 파일과 (conflicted copy...) 파일 두 개를 모두 텍스트 편집기나 해당 애플리케이션으로 연다.

3. 두 파일의 내용을 주의 깊게 비교하여 필요한 변경 사항을 수동으로 원본 파일에 병합한다.

4. 병합 작업이 완료되고 원본 파일이 최종 버전을 담고 있는지 확인한 후, 더 이상 필요 없는 (conflicted copy...) 파일을 삭제한다.

5. 파일을 삭제하면 충돌 상태가 해결되고, 업데이트된 원본 파일이 서버로 정상적으로 동기화된다.55

충돌을 예방하기 위해서는 공동 작업 시 파일 잠금 기능을 적극적으로 활용하거나, Nextcloud Office와 같은 실시간 협업 편집 도구를 사용하는 것이 가장 효과적인 방법이다.7

5.2 일반적인 연결 및 동기화 오류

효과적인 문제 해결을 위해서는 클라이언트와 서버 양측의 로그를 종합적으로 분석하는 능력이 중요하다. 사용자는 클라이언트 UI에서 ’네트워크 오류’와 같은 모호한 메시지만 보게 되는 경우가 많지만, 문제의 근본 원인은 클라이언트 자체의 버그, 서버 설정 오류, 또는 둘 사이의 네트워크 문제 등 다양할 수 있다. 클라이언트 로그는 클라이언트가 어떤 작업을 시도했고 서버로부터 어떤 응답을 받았는지에 대한 정보를, 서버 로그는 클라이언트의 요청을 어떻게 처리했는지에 대한 정보를 제공한다. 이 두 가지를 교차 분석해야만 정확한 원인 규명과 해결이 가능하다.

5.2.1 서버 연결 실패

클라이언트가 서버에 연결하지 못할 경우, 다음 단계를 따라 체계적으로 원인을 진단할 수 있다.

1. 웹 브라우저 접근 확인: 가장 먼저 웹 브라우저로 Nextcloud 서버 주소에 정상적으로 접속되는지 확인한다. 웹에서도 접속이 안 된다면 서버 자체 또는 네트워크의 문제일 가능성이 높다.59

2. WebDAV 인터페이스 확인: 클라이언트는 WebDAV 프로토콜을 사용하므로, 브라우저 주소창에 https://your.server.com/remote.php/dav와 같은 형식의 WebDAV URL을 입력해본다. “This is the WebDAV interface…“와 같은 메시지가 나타나면 WebDAV API는 정상 작동하는 것이다.59

3. 주요 원인 점검:

• 방화벽: 클라이언트 PC의 방화벽이나 회사 네트워크 방화벽이 Nextcloud 서버로의 아웃바운드 연결을 차단하고 있는지 확인한다.61

• 리버스 프록시 설정: Nginx, Apache 등 리버스 프록시를 사용하는 경우, 서버의 config.php 파일에 trusted_proxies와 overwriteprotocol => 'https' 등의 설정이 올바르게 구성되어 있는지 반드시 확인해야 한다.48

• SSL/TLS 인증서: 서버가 유효하지 않은(만료, 자체 서명 등) SSL 인증서를 사용하면 클라이언트가 보안상의 이유로 연결을 거부할 수 있다.60

• Hairpin NAT 문제: 서버와 클라이언트가 동일한 로컬 네트워크에 있을 때, 공인 도메인으로 접속 시 일부 라우터가 이를 제대로 처리하지 못하는 경우가 있다. 이 경우, 클라이언트가 서버의 로컬 IP 주소로 직접 접속하도록 설정하거나 로컬 DNS 서버를 구성해야 한다.61

5.2.2 자주 발생하는 동기화 오류

다음 표는 사용자들이 자주 겪는 동기화 오류 메시지와 그에 대한 핵심 해결 방안을 요약한 것이다.

5.3 로그 파일을 활용한 심층 진단

5.3.1 클라이언트 로그 수집

문제의 원인을 정확히 파악하기 위해 클라이언트 로그를 수집하는 것이 매우 중요하다.

• 로그 확인 방법:

• 실시간 로그 창: 클라이언트 창이 활성화된 상태에서 키보드의 F12 또는 Ctrl+L을 누르면 실시간 로그를 보여주는 창이 열린다.26

• 명령줄 실행: 터미널이나 명령 프롬프트에서 nextcloud --logwindow 명령어로 클라이언트를 실행하면 로그 창을 함께 띄울 수 있다.59

• 디버그 아카이브 생성: 설정 메뉴의 ‘도움말’ 섹션에서 ‘디버그 아카이브 생성’ 기능을 사용하면 로그 파일과 설정 정보를 포함한 압축 파일을 간편하게 생성할 수 있다. 이는 기술 지원을 요청할 때 유용하다.59

• 로그 및 설정 파일 위치:

• Windows: 설정 파일은 %APPDATA%\Nextcloud\nextcloud.cfg에, 로그 파일은 %LOCALAPPDATA%\Nextcloud\logs\ 폴더에 위치한다.26

• macOS: 설정 파일은 $HOME/Library/Preferences/Nextcloud/nextcloud.cfg에 위치한다.26

• Linux: 설정 파일은 $HOME/.config/Nextcloud/nextcloud.cfg에 위치한다.26

5.3.2 서버 로그 분석

클라이언트 로그만으로 문제 해결이 어려울 경우, 서버 측 로그를 함께 분석해야 한다.

• Nextcloud 로그: 기본적으로 Nextcloud 데이터 디렉토리 내의 nextcloud.log 파일에 저장된다. 웹 UI의 ‘관리 설정’ > ‘로깅’ 메뉴를 통해서도 확인할 수 있다.68 더 상세한 분석이 필요할 경우,

config.php 파일에서 loglevel을 0(DEBUG)으로 설정하여 더 많은 정보를 기록하도록 할 수 있다.

• 웹 서버 로그: Apache(error.log)나 Nginx(error.log)의 오류 로그는 HTTP 수준의 문제나 서버 설정 오류를 진단하는 데 필수적이다.59

• PHP-FPM 로그: PHP 프로세스 자체의 오류를 확인하는 데 사용된다.71

6. 참고 자료

1. How to use the Nextcloud client - IONOS, https://www.ionos.com/digitalguide/server/tools/nextcloud-client/
2. What is Nextcloud and what is it used for? - IONOS, https://www.ionos.com/digitalguide/server/tools/what-is-nextcloud/
3. Nextcloud Files - Open source file sync and share platform, https://nextcloud.com/files/
4. Nextcloud - Open source content collaboration platform, https://nextcloud.com/
5. 넥스트클라우드 - 위키백과, 우리 모두의 백과사전, https://ko.wikipedia.org/wiki/%EB%84%A5%EC%8A%A4%ED%8A%B8%ED%81%B4%EB%9D%BC%EC%9A%B0%EB%93%9C
6. Content collaboration platform - Nextcloud Hub, https://nextcloud.com/hub/
7. Nextcloud features that put you in control, https://nextcloud.com/features/
8. Nextcloud Enterprise pricing, https://nextcloud.com/pricing/
9. github.com, https://github.com/nextcloud/desktop#:~:text=The%20Nextcloud%20Desktop%20Client%20is,Nextcloud%20Server%20with%20your%20computer.
10. Desktop sync client for Nextcloud - GitHub, https://github.com/nextcloud/desktop
11. Desktop Clients — Nextcloud latest User Manual latest documentation, https://docs.nextcloud.com/desktop/latest/
12. 데스크톱 클라이언트 — Nextcloud latest User Manual latest 문서, https://docs.nextcloud.com/server/latest/user_manual/ko/desktop/index.html
13. Using the Synchronization Client — Nextcloud latest User Manual latest documentation, https://docs.nextcloud.com/server/latest/user_manual/en/desktop/usage.html
14. Download and install Nextcloud, https://nextcloud.com/install/
15. Installation Nextcloud for Windows, https://www.hiz-saarland.de/fileadmin/user_upload/dienste/hizcloud/Anleitungen/Installation_Nextcloud_for_Windows_eng_v3.pdf
16. Installing the Desktop Synchronization Client — Nextcloud Client Manual 3.9.4 documentation, https://docs.nextcloud.com/desktop/3.9/installing.html
17. Installation — Nextcloud latest User Manual latest documentation, https://docs.nextcloud.com/server/latest/user_manual/en/desktop/installation.html
18. 설치 — Nextcloud latest User Manual latest 문서, https://docs.nextcloud.com/server/latest/user_manual/ko/desktop/installation.html
19. Nextcloud - MacOS - Start9 | Documentation, https://docs.start9.com/0.3.4.x/guides/service-guides/nextcloud/nextcloud-setup/nextcloud-mac.html
20. How to install Nextcloud on Mac - TechDirectArchive, https://techdirectarchive.com/2024/12/10/how-to-install-nextcloud-on-mac/
21. Nextcloud Talk Desktop client - GitHub, https://github.com/nextcloud/talk-desktop
22. Install nextcloud-client on macOS with MacPorts, https://ports.macports.org/port/nextcloud-client/
23. The correct way to install/upgrade NextCloud client on Ubuntu, https://help.nextcloud.com/t/the-correct-way-to-install-upgrade-nextcloud-client-on-ubuntu/127145
24. How to install the Nextcloud Client on Ubuntu - TechRepublic, https://www.techrepublic.com/article/how-to-install-the-nextcloud-client-on-ubuntu/
25. Nextcloud Desktop Client download | SourceForge.net, https://sourceforge.net/projects/nextcloud-desktop-cli.mirror/
26. RD: Getting the Nextcloud desktop app - SURF User Knowledge Base, https://servicedesk.surf.nl/wiki/spaces/WIKI/pages/117178931/RD+Getting+the+Nextcloud+desktop+app
27. Two Factor Authentication for Nextcloud | NextCloudPi Documentation, https://pant.github.io/nextcloudpi-test-docs/en_Two-Factor-Authentication-for-Nextcloud.html
28. Configuring an App Password - BookStack, https://bookstack.grit.ucsb.edu/books/nextcloud-user-instructions/page/configuring-an-app-password
29. Recommendations for extra App & Device passwords (Noob question) : r/NextCloud - Reddit, https://www.reddit.com/r/NextCloud/comments/1if1x0r/recommendations_for_extra_app_device_passwords/
30. How to Set Up a Password Manager in Nextcloud #nextcloud #passwordmanager #security #installerguru - YouTube, https://www.youtube.com/watch?v=SnjYSnGLsbg
31. 동기화 클라이언트 사용하기 — Nextcloud latest User Manual latest 문서, https://docs.nextcloud.com/server/latest/user_manual/ko/desktop/usage.html
32. Nextcloud desktop client 3.2 with status feature and Virtual Files available now, https://nextcloud.com/blog/nextcloud-desktop-client-3-2-with-status-feature-and-virtual-files-available-now/
33. Desktop and mobile synchronization — Nextcloud latest User Manual latest documentation, https://docs.nextcloud.com/server/latest/user_manual/en/files/desktop_mobile_sync.html
34. Nextcloud introduces Virtual Drive in Desktop Client to simplify desktop integration, https://nextcloud.com/blog/nextcloud-introduces-virtual-drive-in-desktop-client-to-simplify-desktop-integration/
35. How do virtual files work in the client - #3 by jospoortvliet - Desktop - Nextcloud community, https://help.nextcloud.com/t/how-do-virtual-files-work-in-the-client/154234/3
36. macOS 가상 파일 클라이언트 — Nextcloud latest User Manual latest 문서, https://docs.nextcloud.com/server/latest/user_manual/ko/desktop/macosvfs.html
37. Sharing in Nextcloud, https://nextcloud.com/blog/sharing-in-nextcloud/
38. File Sharing — Nextcloud latest User Manual latest documentation, https://docs.nextcloud.com/server/latest/user_manual/en/files/sharing.html
39. WebDAV를 통해 Nextcloud 파일에 접근하기, https://docs.nextcloud.com/server/latest/user_manual/ko/files/access_webdav.html
40. Desktop Client 3.7 with new share dialog, better syncing and more! - Nextcloud, https://nextcloud.com/blog/desktop-client-3-7/
41. Using the Synchronization Client — Nextcloud latest User Manual latest dokumentazioa, https://docs.nextcloud.com/server/latest/user_manual/eu/desktop/usage.html
42. Nextcloud Windows Client: miserable upload performance - Desktop, https://help.nextcloud.com/t/nextcloud-windows-client-miserable-upload-performance/220875
43. Limit Bandwidth for User Downloads : r/NextCloud - Reddit, https://www.reddit.com/r/NextCloud/comments/rorrn8/limit_bandwidth_for_user_downloads/
44. NextCloud Limit Bandwidth from server and not client - MangoLassi, https://mangolassi.it/topic/17540/nextcloud-limit-bandwidth-from-server-and-not-client
45. Nextcloud client windows10 crash on setting proxy at setup - ℹ️ Support, https://help.nextcloud.com/t/nextcloud-client-windows10-crash-on-setting-proxy-at-setup/223884
46. Windows Client: Use a proxy only for one connection, https://help.nextcloud.com/t/windows-client-use-a-proxy-only-for-one-connection/63136
47. Nextcloud Desktop Client 3.14.x with proxy, https://help.nextcloud.com/t/nextcloud-desktop-client-3-14-x-with-proxy/207474
48. Problem with login to nextcloud windows client · Issue #3707 - GitHub, https://github.com/nextcloud/desktop/issues/3707
49. Reverse proxy — Nextcloud latest Administration Manual latest documentation, https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/reverse_proxy_configuration.html
50. Reverse proxy setup broke desktop sync client with 2FA : r/NextCloud - Reddit, https://www.reddit.com/r/NextCloud/comments/hfimts/reverse_proxy_setup_broke_desktop_sync_client/
51. Nextcloud Client: Meaning of “Show Server Notifications” (or “Show Desktop Notifications”), https://help.nextcloud.com/t/nextcloud-client-meaning-of-show-server-notifications-or-show-desktop-notifications/153293
52. Dismissing notifications? - Desktop - Nextcloud community, https://help.nextcloud.com/t/dismissing-notifications/67232
53. How do I get rid of these notifications? : r/NextCloud - Reddit, https://www.reddit.com/r/NextCloud/comments/fgss2h/how_do_i_get_rid_of_these_notifications/
54. Useless and annoying popup message on desktop, https://help.nextcloud.com/t/useless-and-annoying-popup-message-on-desktop/59325
55. Conflicts — Nextcloud latest User Manual latest documentation, https://docs.nextcloud.com/server/latest/user_manual/en/desktop/conflicts.html
56. 충돌 — Nextcloud latest User Manual latest 문서, https://docs.nextcloud.com/server/latest/user_manual/ko/desktop/conflicts.html
57. Sync Conflicts : r/NextCloud - Reddit, https://www.reddit.com/r/NextCloud/comments/zxjdek/sync_conflicts/
58. File sharing with desktop client - NextCloud - Reddit, https://www.reddit.com/r/NextCloud/comments/1ib3xq8/file_sharing_with_desktop_client/
59. Troubleshooting — Nextcloud latest Administration Manual latest documentation, https://docs.nextcloud.com/server/latest/admin_manual/desktop/troubleshooting.html
60. Nextcloud clients wont connect But I can login via Web - Desktop, https://help.nextcloud.com/t/nextcloud-clients-wont-connect-but-i-can-login-via-web/157120
61. NextCloud Desktop Windows is not connecting to the server, https://help.nextcloud.com/t/nextcloud-desktop-windows-is-not-connecting-to-the-server/162087
62. Desktop client fails to connect - Desktop - Nextcloud community, https://help.nextcloud.com/t/desktop-client-fails-to-connect/62929
63. Desktop App Sync Connection/Size Limit, https://help.nextcloud.com/t/desktop-app-sync-connection-size-limit/215581
64. [Bug]: Error 499 while syncing thousands of new or modified files · Issue #7526 · nextcloud/desktop - GitHub, https://github.com/nextcloud/desktop/issues/7526
65. FAQ — Nextcloud latest User Manual latest 문서, https://docs.nextcloud.com/server/latest/user_manual/ko/desktop/faq.html
66. Advanced Usage — Nextcloud Client Manual 3.7.50 documentation, https://docs.nextcloud.com/desktop/3.4/advancedusage.html
67. Path for error log files for the Windows desktop client? .thinking: - ℹ️ Support, https://help.nextcloud.com/t/path-for-error-log-files-for-the-windows-desktop-client-thinking/153927
68. General troubleshooting — Nextcloud latest Administration Manual latest documentation, https://docs.nextcloud.com/server/latest/admin_manual/issues/general_troubleshooting.html
69. Logging — Nextcloud latest Administration Manual latest documentation, https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/logging_configuration.html
70. Where to find the logs? - ℹ️ Support - Nextcloud community, https://help.nextcloud.com/t/where-to-find-the-logs/177167
71. Where is the location/file path of the nextcloud log file in Yunohost? - Support, https://forum.yunohost.org/t/where-is-the-location-file-path-of-the-nextcloud-log-file-in-yunohost/28894