새 네트워크로 옮긴 후 Jellyfin 설정을 다시 구성하는 방법

네트워크를 옮긴 뒤 Jellyfin을 재구축할 때는 먼저 로컬 서비스 경로를 복원한 다음 저장소 마운트, 사용자 인증 정보, DNS, 원격 접속을 각각 별도의 단계로 검증하세요.

새 라우터, 서브넷, VLAN 또는 DNS 도메인을 사용하면 클라이언트, 마운트, 리버스 프록시가 더 이상 동일한 경로를 공유하지 않게 되어 정상적인 Jellyfin 데이터베이스도 고장 난 것처럼 보일 수 있습니다. 이전 네트워크 메모와 애플리케이션 데이터 복사본을 보관하세요. 목표는 클라이언트에서 서비스, 미디어까지 경로를 파악하고, 문제가 Jellyfin이 아닌 네트워크 계층에 있을 때 명확히 중단할 지점을 정하는 것입니다.

무엇이든 변경하기 전에 이전 경로 기록

서버 주소, 호스트 이름, 서브넷, 게이트웨이, DNS 이름, 마운트된 미디어 경로, 리버스 프록시 대상, 인증서 이름, 방화벽 규칙 또는 포트 포워딩 규칙을 기록해 두세요. 로컬 스트리밍과 원격 스트리밍은 구분하세요. 이전 호스트를 계속 사용할 수 있다면 새 주소를 할당하기 전에 Jellyfin 설정을 내보내고 사용자와 라이브러리 목록을 작성하세요.

이렇게 하면 재구축을 위한 기준이 마련됩니다. 사용자는 서비스에 접속하고, 서비스는 데이터베이스와 미디어에 접근하며, 백업은 저장 위치에 도달합니다. 공용 포트나 새 프록시 규칙부터 설정하지 마세요.

안정적인 주소에서 로컬 서비스 복원

서버에 DHCP 예약을 설정하거나 고정 주소를 할당한 다음, 같은 LAN에서 Jellyfin 웹 인터페이스가 열리는지 확인하세요. 서비스 바인딩 주소와 호스트 방화벽을 확인하고, DNS를 변경하기 전에 로컬 클라이언트로 테스트하세요. 앱은 시작되지만 라이브러리가 비어 있다면 데이터베이스를 다시 만들지 말고 중단한 뒤 저장소 경로를 확인하세요.

Jellyfin의 이전 지침은 내부 데이터가 경로에 따라 달라지며 컨테이너 경로가 기록된 미디어 위치와 일치해야 한다고 강조합니다(경로에 민감한 이전 지침). 경로 불일치는 메타데이터 문제가 아니라 네트워크 구성 문제로 처리하세요.

DNS보다 먼저 마운트와 권한을 다시 연결하세요

미디어 및 백업 볼륨을 안정적인 경로에 마운트한 다음 Jellyfin 서비스 계정으로 읽기 권한을 테스트하세요. 각 라이브러리에서 파일 하나씩 확인하고 애플리케이션 데이터 디렉터리에 파일을 하나 써 보세요. 캐시와 다운로드한 아트워크는 재구축 가능한 저장소에 두고, 사용자 미디어, 데이터베이스, 백업은 보호 역할의 저장소에 두세요.

Jellyfin이 시작되기 전에 재시작 시 마운트가 복구되고 라이브러리 검사에서 파일 누락 경고가 발생하지 않으면 PASS입니다. 마운트에 대화형 로그인이 필요하다면 계속 진행하기 전에 부팅 순서를 수정하세요.

Featured

ZimaBoard 2 - 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

$339.00 - $529.00

Buy Now

ID, DNS, 원격 액세스를 이 순서대로 재구축하세요

로컬 재생이 작동하면 호스트 이름과 내부 DNS 레코드를 복원하세요. IP 주소가 아닌 이름을 사용하는 클라이언트로 테스트한 다음, 집 밖에서 역방향 프록시나 VPN을 확인하세요. 인증과 권한 부여는 라우팅과 별도로 다루세요. 로그인이 실패했다고 해서 새 포트 포워딩이 잘못되었다는 뜻은 아닙니다.

실제 클라이언트 구성으로 다이렉트 플레이와 트랜스코딩을 각각 한 번씩 실행하세요. 확인된 엔드포인트, 재생 모드, 오류 발생 지점을 기록하세요. 커뮤니티의 이전 사례는 경로와 네트워크 가정을 비교하는 데 유용하지만, 해당 하드웨어나 라우터 설정을 일반화하지 마세요(이전 사례 연구).

롤백과 확장 계획을 명확히 하세요

로컬 재생, 사용자 액세스, 원격 라우팅 및 복원이 모두 통과할 때까지 기존 DNS 레코드, 구성 백업, 이전 네트워크 메모를 보관하세요. 공유 경로 성능이 저하될 때만 관리용 별도 VLAN이나 두 번째 네트워크 인터페이스처럼 전용 경로를 추가해 확장하세요. 서버가 안정적인 주소, 영구 마운트 또는 테스트를 마친 복구 경로를 확보하지 못하면 재구축을 중단하세요. 클라이언트 설정을 아무리 바꿔도 이러한 기반이 없으면 해결되지 않습니다.