리눅스에서 qBittorrent 웹 UI를 설정하는 방법

Linux에서 qBittorrent 웹 UI를 설정하려면 먼저 qBittorrent 를 설치하고 qbittorrent-nox, 루트가 아닌 사용자로 한 번 실행한 다음 브라우저를 통해 로그인하십시오. 처음 실행 시 웹 UI 주소와 로그인 정보가 출력됩니다. 서비스를 온라인 상태로 유지하기 전에 강력한 암호를 설정하십시오. 원격 접속을 위해서는 기본 HTTP 포트를 공용 인터넷에 노출하는 대신 SSH 터널 또는 HTTPS 프록시를 사용하십시오.

1. qBittorrent-nox를 설치합니다

헤드리스 qbittorrent-nox패키지는 데스크톱 창 없이 실행되며 브라우저에서 제어됩니다. 사용 중인 배포판의 패키지 관리자를 통해 설치하세요.

• 우분투 또는 데비안: sudo apt update && sudo apt install qbittorrent-nox
• 페도라: sudo dnf install qbittorrent-nox
• 아치 리눅스: sudo pacman -S qbittorrent-nox

Ubuntu 패키지는 Universe 구성 요소에 있습니다. APT가 패키지를 찾지 못하면 Universe를 활성화하십시오. 패키지 버전은 릴리스에 따라 다릅니다. 패키지를 찾을 수 없는 경우 공식 Ubuntu , Debian , Arch 또는 Fedora 패키지 카탈로그를 확인하십시오. 상위 설치 가이드에서 패키지 및 버전 옵션에 대한 설명을 확인할 수 있습니다.

2. qBittorrent를 일반 사용자 권한으로 실행합니다.

클라이언트를 실행할 때 루트 권한이 없는 계정을 사용하지 마십시오 sudo. qBittorrent는 클라이언트를 실행하는 계정의 설정과 다운로드 내역을 저장합니다. 빠른 테스트를 위해서는 일반 루트 계정을 사용하십시오. 서버에서는 `qBittorrent`와 같은 전용 계정을 사용하십시오. `qBittorrent -v` 또는 `qBittorrent -v` (사용 가능한 경우) 명령어 qbtuser를 사용하여 계정을 생성하십시오 . 동일한 계정으로 클라이언트를 초기화하십시오.sudo adduser qbtusersudo useradd -m -s /bin/bash qbtuser

sudo -iu qbtuser
qbittorrent-nox

법적 고지 사항에 동의하라는 메시지가 나타나면 수락하십시오. qBittorrent는 일반적으로 웹 UI URL http://localhost:8080과 관리자 사용자 이름을 출력합니다. 저장된 암호가 없는 최신 버전은 터미널에 임시 임의 암호를 출력합니다. 일부 이전 버전에서는 여전히 값이 표시될 수 있습니다 adminadmin. 사용 중인 버전에서 출력되는 값을 사용하고 기본 암호를 즉시 변경하십시오.

3. 로그인 후 비밀번호를 변경하세요.

Linux 시스템에서 인쇄된 주소를 브라우저에 열고 로 로그인합니다 admin. 클라이언트가 헤드리스 서버에서 실행되는 경우 아래 설명된 대로 SSH를 통해 연결합니다. 설정 또는 환경설정 → 웹 UI 에서 고유하고 강력한 암호를 설정합니다. 포트가 8080이미 사용 중이 아니라면 그대로 유지합니다. 로컬 호스트 전용 설정의 경우 웹 UI를 에 바인딩한 127.0.0.1다음 변경 사항을 저장합니다.

4. SSH 터널을 사용하여 원격으로 연결합니다.

웹 UI는 기본적으로 HTTP를 사용하므로, 공용 포트 포워딩을 직접 설정하면 로그인 정보가 노출될 수 있습니다. 컴퓨터에서 Linux 서버로 SSH 터널을 여세요.

ssh -L 8080:127.0.0.1:8080 linux_user@server_address

터미널 세션을 열어둔 상태로 http://127.0.0.1:8080컴퓨터에서 접속하세요. SSH 없이 접속하려면 VPN을 사용하거나 리버스 프록시를 통해 TLS 종료를 구성하십시오. qBittorrent의 Linux HTTPS 및 NGINX 가이드에서 지원되는 접근 방식 중 하나를 확인할 수 있습니다. 인증을 비활성화하거나 웹 UI를 신뢰할 수 없는 네트워크에 노출하지 마십시오.

5. systemd를 사용하여 시스템을 계속 실행 상태로 유지하세요.

초기 설정을 저장한 후 Ctrl+C 를 눌러 포그라운드 프로세스를 종료하고 계정 셸을 종료하십시오. 많은 배포 패키지에 qbittorrent-nox@.service템플릿이 포함되어 있습니다. 위에서 사용한 계정에 대해 템플릿을 활성화하고 상태를 확인하십시오.

sudo systemctl enable --now qbittorrent-nox@qbtuser
sudo systemctl status qbittorrent-nox@qbtuser

qbtuser다른 계정을 선택했다면 교체하십시오 . 해당 장치가 없는 경우, 사용 중인 배포판의 상위 systemd 설정 가이드를 따르십시오 . 부팅 관리 없이 임시 백그라운드 실행을 하려면 .을 사용하십시오 qbittorrent-nox -d.

6. 토렌트를 추가하고 다운로드한 파일을 찾으세요

웹 UI에서 '토렌트 추가' 또는 더하기 아이콘을 클릭합니다. .torrent파일을 선택하거나 마그넷 링크 옵션을 선택하고 마그넷 URI를 붙여넣습니다. 작업을 시작하기 전에 저장 경로를 확인하고, 다운로드 또는 공유 권한이 있는 콘텐츠만 추가하세요.

Linux 호스트에서 데이터를 다운로드하며, 브라우저가 표시되는 장치로 전송되지 않습니다. 다운로드 설정에서 구성된 저장 경로를 확인하십시오. 서비스 계정의 파일은 해당 계정의 경로에 저장되며, 반드시 사용자의 개인 홈 디렉터리에 저장되는 것은 아닙니다. SSH, SFTP 또는 공유 폴더를 사용하여 파일을 가져오십시오. 토렌트 다운로드가 완료되면 확인 메시지를 읽고 데이터를 유지할지 삭제할지 선택하십시오.

문제 해결

• 페이지가 로드되지 않습니다. 설정에서 포트를 확인 sudo systemctl status qbittorrent-nox@qbtuser하고 터널이 동일한 포트를 사용하는지 확인하십시오.
• 로그인에 실패했습니다. 시작 출력 또는 서비스 로그를 확인하십시오 sudo journalctl -u qbittorrent-nox@qbtuser -n 50 --no-pager. qBittorrent 구성의 소유자인 동일한 Linux 계정을 사용하십시오. 암호가 잠겨 있는 경우 프로젝트의 암호 복구 가이드를 참조하십시오.
• 포트 8080이 사용 중입니다. 웹 UI 설정에서 다른 포트를 선택하거나 명령어를 사용하여 테스트하십시오 qbittorrent-nox --webui-port=8081. 브라우저 URL과 SSH 터널을 업데이트하십시오. qBittorrent-nox 설명서에서 명령줄 옵션을 확인할 수 있습니다.