Linux에서 OneDrive 마운트하기 — NetDrive의 실험적 Ubuntu 빌드

Ubuntu에서 돌아가는 빌드 서버가 릴리스마다 공유 OneDrive for Business 라이브러리에서 스펙 문서 몇 개를 읽어야 하는데, 헤드리스 박스에 Microsoft 자체 동기화 클라이언트를 설치하는 건 현실적인 선택지가 아니다. NetDrive의 Linux 빌드는 이 문제를 우회한다. 계정을 일반 마운트 지점에 마운트하므로, cat /mnt/onedrive/specs/release-notes.md를 실행하는 스크립트는 누군가 동기화를 깜빡한 오래된 로컬 사본 대신 Microsoft 서버에 있는 실제 파일을 그대로 읽는다.

Ubuntu에서 OneDrive 마운트하기

NetDrive 는 Google Drive, OneDrive, S3, SFTP, WebDAV 등을 Windows 와 macOS 에서 일반 드라이브처럼 보이게 합니다 — 동기화도, 전체 다운로드도 없이.

• Ubuntu 16.04 이상에서 동작
• 개인 OneDrive와 OneDrive for Business를 나란히 동시 사용
• 파일은 필요할 때 스트리밍 — 미리 내려받지 않음

WindowsmacOS

Linux용 NetDrive 다운로드 →

무료 체험. 평생 라이선스와 구독 플랜 제공.

동기화 폴더보다 마운트 지점이 나은 이유

Microsoft의 OneDrive 동기화 클라이언트는 로컬 미러를 항상 최신으로 유지하는 데 초점이 맞춰져 있어서, 뭔가를 건드리기 전에 먼저 파일을 내려받으려 한다 — 노트북에서는 합리적인 절충이지만, 전체 용량이 수십 기가바이트에 달하는 공유 라이브러리에서 파일 세 개만 읽으면 되는 Linux 빌드 박스에는 어색한 방식이다. 마운트는 ‘전체 다운로드’ 단계를 건너뛴다. NetDrive는 마운트 지점을 통해 읽기·쓰기를 OneDrive 계정에 직접 대응시키므로, 스크립트의 open() 호출은 사전 동기화 과정 없이 최신 원격 파일을 받는다.

NetDrive는 첫 출시 때부터 OneDrive를 지원해 왔으며, OneDrive for Business를 개인 OneDrive와 별개의 연결 유형으로 취급한다 — Microsoft의 현대화된 API를 사용하고 독립된 설정으로 관리되므로, 업무 계정과 개인 계정을 서로 간섭 없이 동시에 마운트할 수 있다.

Ubuntu에 NetDrive 설치하기

NetDrive의 Linux 빌드는 Ubuntu 패키지 저장소를 통해 배포되지 않으므로, 설치는 apt가 아니라 GitHub를 거친다.

1. github.com/NetDrive/installer로 이동해 자신의 Ubuntu 버전에 맞는 릴리스를 받는다.
2. 인스톨러 저장소의 릴리스 노트를 따라간다 — NetDrive가 무언가를 마운트하려면 먼저 드라이버 컴포넌트를 설치해야 한다.
3. NetDrive 패키지 자체를 설치한다.
4. NetDrive를 실행한다. 첫 실행 시 드라이버 컴포넌트를 로드하며, 시스템 설정에 따라 sudo를 요구할 수 있다.

최소 지원 버전은 Ubuntu 16.04다. 업데이트는 apt upgrade가 아니라 GitHub 릴리스로 제공되며, Linux는 NetDrive 자체적으로 실험적 딱지가 붙어 있다 — Windows와 macOS가 테스트의 대부분을 받으므로, 사전 검증 없이 운영 환경에서 중요한 역할을 맡기기보다는 빌드 박스나 개발 머신에 더 적합하다.

단계별 안내: Ubuntu에서 OneDrive 연결하기

1. NetDrive의 Drive Manager를 열고 + Add Drive를 클릭한다.
2. 개인 Microsoft 계정이면 Select OneDrive를, Microsoft 365 업무 계정이면 OneDrive for Business를 선택한다.

3. 기본 브라우저에서 열리는 OAuth 흐름으로 로그인한다. 브라우저가 설치되지 않은 헤드리스 박스에서는 같은 계정으로 로그인된 다른 머신에서 일회성 인증을 완료하거나, X 포워딩 세션을 사용한다.
4. /mnt/onedrive처럼 마운트 지점을 지정한다 — 쓰기 권한이 있는 빈 디렉터리라면 무엇이든 상관없다.
5. Connect를 클릭한다. NetDrive가 Microsoft에 인증하고 해당 경로에 계정을 마운트한다.

디렉터리 목록은 폴더를 처음 열람할 때 OneDrive API에서 가져오며, 개별 파일은 실제로 열기 전까지는 내려받지 않는다.

터미널에서 마운트 확인하기

스크립트를 그 경로에 연결하기 전에, GUI만 믿지 말고 마운트가 실제로 이루어졌는지 확인하자.

# Confirm the mount is listed
mount | grep onedrive

# Or just try listing it
ls /mnt/onedrive

목록이 비어 있다면 마운트 지점 관련 문제보다 먼저 OAuth 단계를 다시 살펴보자 — 헤드리스 머신에서 브라우저 흐름이 중단되는 것이 OneDrive 연결이 완료되지 않는 가장 흔한 원인이다. OneDrive for Business의 경우, 개인용 OneDrive가 아니라 Business 연결 유형을 선택했는지 다시 확인한다. 둘은 로그인 흐름이 서로 달라서 서로의 계정으로는 인증되지 않는다.

Linux 빌드에서 염두에 둘 점

• 별도의 릴리스 주기 — Linux 드라이버 컴포넌트는 자체 일정으로 배포되므로, Windows나 macOS에 반영된 수정 사항이 같은 주에 Linux에도 자동으로 반영되지는 않는다.
• apt 연동 없음 — 설치와 업데이트는 Ubuntu 기본 저장소가 아니라 GitHub 릴리스에서 받는다.
• Windows와 macOS가 검증된 대상 — NetDrive 공식 안내는 Linux를 실험적으로 취급한다. CI 러너나 하루 몇 번 OneDrive를 읽는 개인 개발 머신에는 합리적인 용도지만, 무인 운영 파이프라인이라면 의존하기 전에 충분히 검증할 가치가 있다.

마무리

Ubuntu에서 OneDrive를 마운트하면 NetDrive가 Windows와 macOS에서 제공하는 것과 동일한 마운트 지점 접근을, apt 대신 GitHub에 있는 인스톨러를 통해 헤드리스 또는 데스크톱 Linux 박스에서도 얻을 수 있다. 더 많이 검증된 플랫폼에서 같은 공급자를 다루는 글은 Mount OneDrive on Windows를, Linux 빌드의 다른 연결 유형은 Mount Google Drive on Linux를, Linux 전반에 대한 더 넓은 그림은 NetDrive on Ubuntu Linux를 참고하라.

— Alex, NetDrive