문제 해결 & FAQ

문제 해결 & FAQ#

프로필 연결이 실패하거나 시간 초과됨#

증상: 로그인하여 연결을 클릭하면 “Couldn’t start login” 알림이 뜨거나, 브라우저를 연 뒤 “Login timed out” 알림이 뜹니다.

원인: 대개 다음 중 하나입니다:

  • 서버 URL이 잘못됐거나, 접속할 수 없거나, https:// 스킴이 빠졌습니다.

  • 서버가 Nextcloud의 Login Flow v2 엔드포인트(POST /index.php/login/v2)를 지원하지 않습니다 — 어지간히 최신 Nextcloud 인스턴스라면 이 엔드포인트가 있어야 합니다.

  • 열린 브라우저 탭에서 로그인을 끝내지 않았거나 너무 늦게 끝냈습니다 — 폴링은 약 20분 뒤에 포기합니다.

해결: 서버 URL을 다시 확인한 뒤 로그인하여 연결**(기존 프로필이라면 **다시 연결)을 재시도하고, 브라우저 탭에서 로그인을 바로 완료하세요.

블록에 “Authentication failed”가 표시됨#

증상: 이전에는 잘 표시되던 블록이 이제 “Authentication failed. Reconnect this profile in settings.”를 표시합니다.

원인: 프로필에 저장된 앱 비밀번호가 폐기되었거나 만료되었습니다 — 대개 Nextcloud 서버 자체의 설정 → 보안 → 기기 및 세션에서 제거되었기 때문입니다.

해결: 설정 → Harang Nextcloud에서 해당 프로필의 다시 연결을 클릭하고 로그인 절차를 다시 완료하세요.

파일을 붙여넣어도 첨부 파일이 업로드되지 않음#

증상: 이미지가 아닌 파일을 노트에 붙여넣어도 아무 일도 일어나지 않거나, “There’s no nc-folder property in the frontmatter.”가 표시됩니다.

원인: 활성 노트에 사용법에서 설명한 nc-folder 프런트매터 속성이 없거나, 그 값이 등록된 프로필 이름과 일치하지 않습니다.

해결: 노트의 프런트매터에 nc-folder: <프로필이름>/<경로>를 추가한(프로필이 하나뿐이라면 nc-folder: <경로>만) 뒤 파일을 다시 붙여넣으세요.

참고

붙여넣은 이미지는 의도적으로 건드리지 않습니다 — 이 업로드 경로가 아니라 Obsidian의 일반 이미지 붙여넣기 처리를 그대로 거칩니다.

설치 후 플러그인이 나타나지 않음#

해결: main.js, manifest.json, styles.css가 (하위 폴더가 아니라) <vault>/.obsidian/plugins/harang-nextcloud/ 바로 안에 있는지, 설정 → 커뮤니티 플러그인에서 플러그인이 활성화되어 있는지, Obsidian이 1.13.4 이상인지(사전 준비 사항 참고) 확인하세요. 파일을 설치하거나 업데이트한 뒤에는 Obsidian을 완전히 재시작하세요.

git pull 후 플러그인이 업데이트되지 않음#

증상: 최신 소스 변경 사항을 pull 했는데도 Obsidian이 여전히 이전 버전처럼 동작합니다.

원인: 소스로 설치할 경우 명시적인 재빌드와 수동 복사 단계가 필요합니다 — 새 소스를 pull하는 것만으로는 Obsidian이 실제로 불러오는 파일이 업데이트되지 않습니다.

해결: 설치의 방법 3에 나온 전체 업데이트 절차를 실행하세요:

git pull
npm install
npm run build

그런 다음 새로 빌드된 main.js``(``manifest.json/styles.css가 바뀌었다면 그것도)를 다시 <vault>/.obsidian/plugins/harang-nextcloud/에 복사하고 Obsidian을 재시작하세요.