IT 정보
Nextcloud 윈도우 환경에서 외장하드 연결하기 (Docker, WSL2)
roaminpixel
2025. 5. 17. 00:00
728x90

"다음엔 헤매지 않기 위해, 오늘의 시행착오를 남긴다"
🧩 시작하기 전에: 내 환경 정리
- 💻 운영체제: Windows 11
- 🐳 Docker Desktop + WSL2 기반
- 📁 외장하드: D: 드라이브
- 🧱 설치 방식: docker-compose 사용
- ☁️ 사용한 서비스: Nextcloud
💡 WSL이란?
WSL = Windows Subsystem for Linux
👉 윈도우에서 리눅스를 돌릴 수 있게 해주는 기술
마치 윈도우 안에 리눅스 터미널이 하나 들어와 있는 느낌이야.
🧱 WSL1 vs WSL2 차이

✅ “WSL2 기반 Docker”란?
너가 지금 쓰는 Docker Desktop은
WSL2 리눅스 커널 위에 올라간 구조라는 뜻이야!
즉, Windows에서 Docker 실행 → WSL2 (리눅스 커널 위) → 그 위에서 Nextcloud 같은 리눅스 앱 실행
💡 이렇게 되면:
- Docker가 가볍고 빠르고,
- 윈도우랑 리눅스 파일 시스템도 /mnt/c, /mnt/d로 쉽게 연결돼
- 그래서 너의 외장하드 D:도 /mnt/d로 연결할 수 있었던 거야!
📦 왜 중요한가?

📌 WSL 버전 확인 방법

🌱 마무리 정리
- WSL2 기반이라는 말은
👉 윈도우 안에서 리눅스를 진짜 커널로 돌리는 환경이라는 뜻이고,
👉 Docker, 외장하드 연결, 개발환경 세팅이 다 WSL2 덕분에 가능한 거야!
❗ 내가 겪은 시행착오들
1. /mnt/usbdrive 경로가 안 보임
❌ 원인:
- docker-compose.yml에 외장하드 마운트 설정(volumes)이 누락됨
- 혹은 변경했지만 docker compose up -d로 반영 안 함
✅ 해결:

2. Nextcloud에 “외부 저장소” 옵션이 안 보임
❌ 원인:
- External storage support 앱 설치 안 됨
- 관리자 계정이 아닌 일반 사용자로 로그인
✅ 해결:
- 관리자 계정으로 로그인
- 우측 상단 → 앱 → External storage support 앱 설치
3. “외부 저장소를 구성할 권한이 없습니다” 오류
❌ 원인:
- config.php 설정 누락
✅ 해결:
C:\nextcloud\config\config.php에 아래 코드 추가:

4. 컨테이너 접속 시 nano 안 됨
❌ 원인:
- 컨테이너에 nano 편집기가 기본 설치되어 있지 않음
✅ 해결:

5. docker exec -it nextcloud bash 명령어가 안 됨
❌ 원인:
- 컨테이너 이름이 nextcloud가 아니라 nextcloud-app-1
✅ 해결:

6. 외부 저장소 등록했는데 초록불이 안 뜸
❌ 원인:
- 권한 부족 (www-data가 해당 경로에 접근 못함)
✅ 해결:

✅ 최종 상태 확인
- /mnt/usbdrive → Nextcloud에서 잘 보임
- 파일 업로드/삭제 문제 없음
- 외장하드와 Nextcloud 완벽 연동 완료! 🥳
🌱 마무리
이번 작업을 통해:
- WSL과 Docker 볼륨 연결 개념을 정확히 이해하게 됐고
- Nextcloud 권한과 설정을 익힐 수 있었음
- 다음 번엔 10분 만에 구축 가능할 것 같은 자신감 생김
추가 (250517)
❗️ 에러 메시지 요약
“일부 파일을 업로드할 수 없었습니다”
“접근 설정에 의해 동작이 차단됨”
👉 이건 Nextcloud가 /mnt/usbdrive 경로에 쓰기 권한이 없어서 생기는 오류야.
✅ 해결 방법: 컨테이너 안에서 권한 설정

💡 보완 팁 (WSL 마운트 설정 커스터마이징)
/etc/wsl.conf 파일 수정 (WSL에서):

✅ 적용 후 다시 확인할 것
- Nextcloud에 로그인
- usbdrive 폴더 클릭
- 다시 파일 업로드 테스트 → 오류 없이 올라가면 성공! 🎉
728x90
반응형