Debian 12에 Emby 미디어 서버 설치하는 방법

Emby는 Plex 미디어 서버의 오픈 소스 대안입니다. Emby는 Linux, FreeBSD, Windows 및 MacOS와 같은 여러 운영 체제를 지원합니다. 클라이언트 측에서는 스마트폰에서 데스크탑에 이르기까지 거의 모든 장치를 지원합니다. 이는 거의 모든 곳에서 미디어 파일에 접근할 수 있음을 의미합니다.

이 가이드는 Debian 12에 Emby 미디어 서버를 설치하는 방법을 알려줍니다. Nginx를 리버스 프록시로 사용하여 Emby를 설치하고 UFW를 활성화합니다. 시작해 보겠습니다.

전제 조건

이 가이드를 완료하려면 다음이 필요합니다:

Debian 12 서버.
sudo 권한이 있는 비루트 사용자.
Emby를 실행하기 위해 도메인 이름 또는 공개 도메인이 필요합니다.

Emby 미디어 서버 설치

Emby 미디어 서버는 FreeBSD, Linux 및 Windows와 같은 여러 운영 체제를 지원하는 오픈 소스 미디어 서버입니다. 운영 체제에 맞는 특정 패키지를 다운로드하여 Emby 미디어 서버를 쉽게 설치할 수 있습니다.

시작하려면 다음 명령을 실행하여 Debian 저장소를 업데이트하고 모든 패키지를 최신 버전으로 업그레이드합니다.

sudo apt update && sudo apt upgrade  
sudo reboot

이제 Emby 다운로드 페이지를 방문하여 Emby의 최신 버전 링크를 복사합니다. 배포판으로 Debian을 선택해야 합니다. 그런 다음 아래의 wget 명령을 사용하여 Emby를 다운로드합니다.

wget https://github.com/MediaBrowser/Emby.Releases/releases/download/4.7.14.0/emby-server-deb_4.7.14.0_amd64.deb

다운로드가 완료되면 아래의 dpkg 명령을 실행하여 Debian 머신에 Emby를 설치합니다.

sudo dpkg -i emby-server-deb_*.deb  
sudo apt install -f

install emby

Emby가 설치된 후 emby-server 서비스가 자동으로 실행되고 활성화되어야 합니다. 아래의 systemctl 명령을 실행하여 확인합니다.

sudo systemctl is-enabled emby-server  
sudo systemctl status emby-server

emby-server 서비스 상태가 다음과 같이 실행 중이고 활성화되어 있는지 확인하세요:

verify service

기본적으로 emby-server는 포트 8096에서 실행됩니다. 아래의 ss 명령을 실행하여 시스템의 LISTEN 포트를 확인합니다.

ss -tulpn

emby-server가 포트 8096에서 실행되고 있는지 확인하세요.

verify port

Nginx를 리버스 프록시로 설치 및 구성하기

이 튜토리얼에서는 Nginx를 리버스 프록시로 사용하여 Emby를 실행합니다. 이제 Nginx 설치를 시작하고 리버스 프록시로 사용될 새로운 서버 블록 구성을 생성합니다. 그러므로 먼저 도메인 이름이 서버 IP 주소를 가리키도록 설정되어 있는지 확인하세요. 로컬 도메인 또는 공개 도메인 모두 가능합니다.

다음 apt 명령을 사용하여 Debian 서버에 Nginx를 설치합니다. y를 입력하여 확인하고 ENTER를 눌러 진행합니다.

sudo apt install nginx

install nginx

이제 아래의 명령을 실행하여 nginx 서비스를 확인하고 서비스가 실행 중이고 활성화되어 있는지 확인합니다.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

nginx가 실행 중이라면 active (running)이라는 출력을 얻어야 하며, 활성화된 경우 enabled와 같은 출력을 보게 됩니다.

verify nginx

다음으로, 아래의 nano 편집기 명령을 사용하여 새로운 Nginx 서버 블록 구성 /etc/nginx/sites-available/emby-server를 생성합니다. 이는 Emby 설치를 위한 리버스 프록시로 사용됩니다.

sudo nano /etc/nginx/sites-available/emby-server

다음 구성을 추가하고 server_name 및 add_header Content-Security-Policy 매개변수 내의 도메인 이름을 변경해야 합니다.

server {  
 listen 80;  
 server_name emby.howtoforge.local; #여기에 서브도메인.도메인명 입력  
   
 proxy_hide_header X-Powered-By;  
 add_header X-Xss-Protection "1; mode=block" always;  
 add_header X-Content-Type-Options "nosniff" always;  
 add_header Strict-Transport-Security "max-age=2592000; includeSubdomains" always;  
 add_header X-Frame-Options "SAMEORIGIN" always;  
 add_header 'Referrer-Policy' 'no-referrer';  
  
 add_header Content-Security-Policy "frame-ancestors mydomain.com emby.mydomain.com;"; #도메인명 및 인증서에 나열된 모든 서브도메인 추가  
   
  
 location / {  
 proxy_pass http://127.0.0.1:8096; # 로컬 emby ip 및 비 SSL 포트  
  
 proxy_hide_header X-Powered-By;  
 proxy_set_header Range $http_range;  
 proxy_set_header If-Range $http_if_range;  
 proxy_set_header X-Real-IP $remote_addr;  
 proxy_set_header Host $host;  
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
  
 #다음 세 줄은 웹소켓을 허용합니다  
 proxy_http_version 1.1;  
 proxy_set_header Upgrade $http_upgrade;  
 proxy_set_header Connection "upgrade";  
 }  
}

작업이 끝나면 파일을 저장하고 편집기를 종료합니다.

이제 아래의 명령을 실행하여 서버 블록 구성 /etc/nginx/sites-available/emby-server을 활성화하고 Nginx 구문 구성을 확인합니다.

sudo ln -s /etc/nginx/sites-available/emby-server /etc/nginx/sites-enabled/  
sudo nginx -t

올바른 Nginx 구문이 있다면 ‘syntax is ok - test is successful‘와 같은 출력을 얻어야 합니다.

이제 새로운 서버 블록 구성을 적용하기 위해 nginx 서비스를 재시작합니다.

sudo systemctl restart nginx

![setup server block](/files/01d62781-2e0e-4934-a122-a355f95ad27a.png)

UFW(간단한 방화벽) 설정하기

이 가이드에서는 UFW가 활성화된 상태에서 Emby를 실행합니다. 따라서 이 단계를 완료하여 UFW를 설치하고 OpenSSH 및 Nginx Full 프로필을 추가하여 SSH, HTTP 및 HTTPS 트래픽을 열어야 합니다.

다음 apt 명령을 사용하여 UFW(간단한 방화벽)를 설치합니다. 설치를 확인하려면 y를 입력합니다.

sudo apt install ufw

install ufw

설치가 완료되면 아래의 ufw 명령을 실행하여 OpenSSH 및 Nginx Full 프로필을 활성화합니다. 이렇게 하면 SSH, HTTP 및 HTTPS 프로토콜을 위한 포트가 열립니다.

sudo ufw allow OpenSSH  
sudo ufw allow 'Nginx Full'

이제 아래의 명령을 실행하여 UFW를 시작하고 활성화합니다. y를 입력하여 UFW를 실행합니다.

sudo ufw enable

활성화되면 ‘Firewall is active and enabled on system startup‘와 같은 출력을 얻어야 합니다.

enable ufw

이제 아래의 명령을 실행하여 UFW 설치를 확인합니다.

sudo ufw status

UFW의 상태가 Active로 표시되고 OpenSSH 및 Nginx Full 프로필이 활성화되어 있는 것을 볼 수 있습니다.

verify ufw

SSL/TLS 인증서로 Emby 보안 설정하기

로컬 네트워크에서 Emby를 실행하는 경우 설치를 보호하기 위해 자체 서명된 인증서를 생성할 수 있습니다. 공개 도메인의 경우 Letsencrypt에서 SSL/TLS 인증서를 사용하는 것이 좋습니다.

이 섹션에서는 Certbot을 통해 letsencrypt에서 SSL/TLS 인증서를 생성합니다.

아래 명령을 사용하여 Certbot 및 Certbot nginx 플러그인을 설치합니다. 설치를 확인하려면 y를 입력합니다.

sudo apt install certbot python3-certbot-nginx

설치가 완료되면 아래의 certbot 명령을 실행하여 Emby 설치를 위한 SSL/TLS 인증서를 생성합니다. 도메인 이름 및 이메일 주소 정보를 자신의 정보로 변경해야 합니다.

certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d emby.howtoforge.local

프로세스가 완료되면 SSL 인증서 파일이 /etc/letsencrypt/live/domain.com 디렉토리에 생성됩니다. 또한 Nginx 서버 블록 구성은 Certbot Nginx 플러그인에 의해 HTTPS로 자동으로 구성됩니다.

Emby 미디어 서버 설치하기

웹 브라우저를 열고 Emby 미디어 서버 설치의 도메인 이름(예: http://emby.howtoforge.local/)을 방문합니다.

설치가 성공하면 ‘Welcome to Emby‘와 같은 환영 메시지가 표시됩니다. 드롭다운 메뉴에서 선호하는 언어를 선택하고 Next를 클릭합니다.

default language

첫 번째 Emby 사용자를 생성하고 강력한 비밀번호를 입력해야 합니다. 그런 다음 계속 진행하려면 Next를 다시 클릭합니다.

setup user

새 라이브러리를 생성하라는 메시지가 표시되면 New Library 버튼을 클릭하거나 그냥 Next를 클릭하여 계속 진행할 수 있습니다. 설치가 완료된 후 미디어 라이브러리를 추가할 수 있습니다.

setup library

선호하는 메타데이터 언어를 선택하고 계속 진행하려면 Next를 클릭합니다.

metadata language

‘ Enable automatic port mapping ‘을 체크하여 포트 매핑을 자동으로 활성화합니다. 계속 진행하려면 Next를 클릭합니다.

term of service

이제 ‘ I accept the terms of service ‘ 옵션을 체크하고 Next를 클릭합니다.

프로세스가 완료되면 ‘You’re Done!‘라는 메시지가 표시됩니다. 설치를 완료하려면 Finish를 클릭합니다.

installation finished

이제 사용자를 클릭하여 Emby 미디어 서버에 로그인합니다.

관리 사용자 이름과 비밀번호를 입력한 후 Sign In을 클릭합니다.

올바른 사용자 이름과 비밀번호를 입력하면 다음과 같은 Emby 대시보드를 볼 수 있습니다:

emby dashboard

결론

축하합니다! 이제 Debian 12 서버에 Emby 미디어 서버를 설치했습니다. 또한 Emby 설치를 위한 Nginx를 리버스 프록시로 구성했습니다. 추가로 UFW를 구성하고 Letsencrypt에서 SSL/TLS 인증서로 Emby를 보안 설정했습니다.

마지막으로 Emby 설치를 초기화했으며 여기에서 미디어 파일을 추가할 수 있습니다.