Jellyfin은 서버를 권위 있는 기준으로 유지하는 한편, 애드온이 인증, 메타데이터 동기화, 업데이트 수신, 각 재생 요청 처리를 담당하도록 하여 Kodi를 연동합니다.
Jellyfin이 사용자, 시청 상태, 메타데이터, 접근 규칙을 계속 관리하더라도 Kodi 기기는 기본 로컬 라이브러리처럼 느껴질 수 있습니다. 이러한 경험은 서로 다른 두 가지 통합 모델에서 비롯됩니다. Jellyfin for Kodi는 선택한 카탈로그 데이터를 Kodi에 복사하고, JellyCon은 서버를 더 동적으로 조회합니다. 이후 재생은 Jellyfin을 거치거나 변환된 네트워크 경로를 사용할 수 있으며, 이에 따라 일관성과 네트워크 전제가 모두 달라집니다.
서버는 계속해서 ID와 상태의 기준이 됩니다
Kodi는 Jellyfin 사용자로 인증하고 해당 계정에 허용된 라이브러리와 작업만 받습니다. 클라이언트 인터페이스가 Kodi 기본 형식이더라도 미디어 식별, 메타데이터 결정, 시청 진행률, 세션 표시 여부는 계속 서버가 관리합니다.
Kodi 메타데이터 동기화에 관한 사용자 중심의 설명은 전체 동기화를 수행하는 애드온과 더 가볍고 애드온 방식으로 탐색하는 JellyCon을 구분합니다. 차이는 카탈로그 상태가 어디에 구체화되는지에 있습니다.
이러한 권한 분리는 Kodi가 별도의 독립적인 미디어 관리자로 변하는 것을 막지만, 동시에 동기화 의무를 만듭니다. 로컬 Kodi 행은 계속해서 안정적인 Jellyfin 항목 ID에 매핑되어야 합니다.
동기화는 서버 변경 사항을 로컬 행으로 변환합니다
Jellyfin for Kodi는 처음에 선택한 메타데이터를 Kodi의 로컬 데이터베이스에 복사한 다음, 시작 시 동기화와 실시간 업데이트 기능을 사용해 변경 사항을 일치시킵니다. 대기열 모델을 사용하면 Kodi는 라이브러리를 매번 전체 재구축하지 않고 마지막으로 확인한 위치 이후의 변경 사항을 요청할 수 있습니다.
실제 Kodi 통합 사례에 따르면 동기화가 완료되면 라이브러리 데이터가 Kodi 기본 보기에 표시됩니다. 이러한 로컬 구체화 덕분에 서버가 LAN 원격 위치에 있어도 탐색이 즉각적으로 느껴질 수 있습니다.
경계는 데이터베이스 소유권에 있습니다. 동일한 Kodi 데이터베이스를 변경하는 다른 도구는 동기화된 표현과 충돌할 수 있습니다. 로컬 탐색이 빠르다고 해서 Kodi가 권위 있는 메타데이터 소스가 된 것은 아닙니다.
재생 모드가 서버 URL과 기본 경로 중 하나를 선택합니다
애드온 모드에서는 Jellyfin이 재생을 처리하고 일반적인 스트리밍 결정을 적용할 수 있습니다. 기본 모드에서는 경로 대체 기능이 서버의 파일 시스템 보기를 클라이언트에서 접근 가능한 네트워크 위치로 변환한 후 Kodi가 SMB 또는 NFS 경로에 직접 접근합니다.
기본 경로 재생에 관한 논의는 핵심 메커니즘을 강조합니다. 메타데이터 조정은 유지하면서 원본 미디어가 Jellyfin의 전송 경로를 우회할 수 있다는 점입니다. 이를 통해 서버의 중개를 줄일 수 있지만 공유 권한과 경로 일관성이 추가로 필요합니다.
따라서 기본 모드가 항상 더 빠른 것은 아닙니다. Kodi가 동일한 파일에 안정적으로 접근하고 직접 디코딩할 수 있을 때만 도움이 됩니다. 원격 클라이언트나 일관되지 않은 마운트 환경에서는 일반적으로 서버 중개 경로가 더 적합합니다.
분할 상태를 방지하는 조정 체크리스트
ID, 경로 또는 업데이트 위치가 서로 달라지면 조정이 실패합니다. 동기화 상태를 초기화하지 않고 Kodi를 재구성하거나, 대체 경로를 변경하지 않고 Jellyfin 경로를 바꾸거나, 서로 무관한 Kodi 데이터베이스 작성기를 함께 사용하면 두 애플리케이션이 모두 정상적으로 실행되더라도 오래된 행이 남을 수 있습니다.
더 넓은 범위의 클라이언트 기능 모델은 메타데이터를 동기화한 후에도 Kodi의 재생이 다른 클라이언트와 다를 수 있는 이유를 설명합니다. Kodi의 디코더 지원과 선택한 경로는 여전히 별개의 변수입니다. 별도의 현장 보고서 역시 화면에 보이는 증상만으로 병목 지점을 단정하기보다 Kodi 시작 시 동기화를 사용할 것을 뒷받침합니다.
변경 후에는 다음 네 가지 계약을 확인하세요. Kodi 프로필이 의도한 Jellyfin 사용자에 매핑되는지, 새 항목이 시작 시 동기화 또는 실시간 동기화를 통해 추가되는지, 시청 상태가 서버로 돌아가는지, 그리고 테스트 파일 하나가 선택한 애드온 또는 기본 경로를 통해 대체 경로 없이 재생되는지 확인해야 합니다.
기술 및 AI 허브
더 읽어보기

Jellyfin 성능이 LAN과 원격 연결에서 다른 이유
서버는 동일할 수 있지만, 원격 액세스를 사용하면 네트워크 예산이 달라지고 배송 또는 트랜스코딩 방식에 대한 결정이 달라지는 경우가 많습니다.

Jellyfin은 CGNAT 또는 이중 NAT 환경에서 안정적으로 작동하나요?
미디어 서버는 계속 정상적으로 작동하며, 아직 해결되지 않은 문제는 충분한 지속 처리량을 확보하면서 주소 변환을 거쳐 연결 가능한 안전한 경로를 만드는 것입니다.

네트워크 지연 시간이 자막이 포함된 Jellyfin HDR 재생에 미치는 영향
HDR 자막 재생은 네트워크 전송과 변환 타이밍이 연동되므로, 지터와 왕복 지연 시간으로 인해 평균 대역폭만으로는 드러나지 않는 재생 멈춤이 발생할 수 있습니다.

