우분투 서버에서 Ampache 서버를 실행하는 방법

Ampache를 사용하면 Ubuntu 서버를 브라우저나 호환 앱에서 재생할 수 있는 자체 호스팅 음악 라이브러리로 만들 수 있습니다. 이 가이드에서는 Ubuntu Server 26.04 LTS, Apache, MariaDB 및 Ampache 8.3.0을 사용합니다. Ampache 8은 PHP 8.5 이상이 필요하므로 이전 버전의 Ubuntu를 사용하기 전에 공식 설치 요구 사항을 확인하십시오.

서버를 공용 인터넷에서 접속 가능하게 하려면 sudo 계정, 음악 파일을 저장할 수 있는 충분한 디스크 공간, 그리고 도메인 이름이 필요합니다. 설치가 완료될 때까지 설치 프로그램은 신뢰할 수 있는 네트워크에만 접근하도록 제한하십시오.

Ubuntu 서버에 Ampache 설치

1. Apache, MariaDB, PHP 및 오디오 도구를 설치합니다.

Ubuntu를 업데이트하고 서버 구성 요소와 PHP 확장 프로그램을 설치하세요. Ampache가 이를 확인합니다. FFmpeg 및 오디오 유틸리티는 미디어 처리 및 트랜스코딩을 지원합니다.

sudo apt update
sudo apt upgrade -y
sudo apt install apache2 mariadb-server php8.5 php8.5-cli php8.5-curl php8.5-gd php8.5-intl php8.5-mbstring php8.5-mysql php8.5-xml php8.5-zip ffmpeg flac lame vorbis-tools inotify-tools zip unzip curl
sudo systemctl enable --now apache2 mariadb

Ubuntu 26.04에는 PHP 8.5가 포함되어 있습니다. 서버에서 다른 PHP 버전을 사용하는 경우 해당 버전과 호환되는 Ampache 릴리스를 선택하거나 Ampache의 버전별 가이드를 따르십시오. 버전이 지정되지 않은 php패키지가 Ampache 8의 요구 사항을 충족한다고 가정하지 마십시오.

2. 데이터베이스와 전용 사용자를 생성합니다.

MariaDB의 로컬 관리 셸을 엽니다. 애플리케이션 계정은 Ampache의 데이터베이스에만 접근할 수 있으며, Ubuntu의 로컬 MariaDB 관리는 별도로 유지됩니다.

sudo mariadb

MariaDB 프롬프트에서 데이터베이스를 생성하고 예제 암호를 길고 고유한 암호로 바꾸십시오. SQL에서 올바르게 이스케이프 처리하지 않는 한 암호에 작은따옴표를 사용하지 마십시오.

CREATE DATABASE ampache CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ampacheuser'@'localhost' IDENTIFIED BY 'REPLACE_WITH_A_LONG_RANDOM_PASSWORD';
GRANT ALL PRIVILEGES ON ampache.* TO 'ampacheuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

3. Ampache 릴리스 아카이브를 다운로드합니다.

공식 릴리스 페이지에는 버전별 아카이브 목록이 있습니다. 아래 예시는 Ampache 8.3.0과 PHP 8.5 빌드를 고정한 것입니다. 설치 시 최신 릴리스가 있는 경우 버전과 파일 이름을 모두 업데이트해야 합니다.

cd /tmp
wget https://github.com/ampache/ampache/releases/download/8.3.0/ampache-8.3.0_php8.5.zip
sudo mkdir -p /var/www/ampache
sudo unzip ampache-8.3.0_php8.5.zip -d /var/www/ampache
sudo chown -R root:www-data /var/www/ampache
sudo chmod -R g+rX /var/www/ampache
sudo chown www-data:www-data /var/www/ampache/config
sudo chmod 775 /var/www/ampache/config

웹 서버는 설정 과정에서 구성 디렉터리를 생성해야 합니다. 나머지 애플리케이션 파일은 루트 소유로 유지하고 Apache에서 읽을 수 있도록 허용하면 됩니다.

4. Apache가 Ampache의 공개 디렉토리를 가리키도록 설정합니다.

Ampache의 웹 루트는 public하위 디렉터리입니다. Ampache 전용으로 새로 구축한 서버에서는 기본 가상 호스트를 편집해야 합니다. Apache가 이미 다른 사이트를 서비스하고 있는 경우에는 별도의 가상 호스트를 사용하십시오.

sudo nano /etc/apache2/sites-available/000-default.conf

기존 <VirtualHost *:80>블록 안에 서버 이름과 문서 루트를 설정한 다음 디렉터리 규칙을 추가하세요.

ServerName ampache.example.com
DocumentRoot /var/www/ampache/public

<Directory /var/www/ampache/public>
    AllowOverride All
    Require all granted
</Directory>

Apache의 재작성 규칙을 활성화하고, Ampache에서 제공하는 재작성 파일을 생성하고, 구성을 테스트하고, Apache를 다시 로드합니다.

sudo a2enmod rewrite
cd /var/www/ampache
sudo php bin/installer htaccess -e -p
sudo apache2ctl configtest
sudo systemctl reload apache2

이 AllowOverride All설정을 통해 Apache는 해당 파일을 읽을 수 있습니다. Ampache는 재작성 기능을 사용할 수 없는 경우 스트리밍 및 API에서 404 오류가 발생할 수 있다고 경고합니다. 사용자 지정 가상 호스트를 사용하는 경우 재작성 규칙 가이드를 참조하십시오 .

5. Ampache 설치 프로그램에서 서버를 확인하세요.

신뢰할 수 있는 네트워크에 연결된 컴퓨터에서 다음 명령을 실행하세요 http://ampache.example.com/install.php. DNS를 구성하지 않은 경우 서버의 개인 IP 주소를 사용하세요. 언어를 선택하고 " 구성 시작"을php8.5- 클릭한 다음 요구 사항 페이지를 검토하세요. 계속 진행하기 전에 누락된 PHP 모듈을 모두 해결하고, 필요한 경우 해당 패키지를 설치 하고 Apache를 다시 시작하세요.

6. 데이터베이스에 연결하고 설정을 작성합니다.

localhost데이터베이스 호스트, ampache데이터베이스 이름, 그리고 이전에 생성한 자격 증명을 입력하십시오 ampacheuser. MariaDB 루트 계정 대신 이 전용 계정을 사용하십시오. 표준 설치 유형을 선택하십시오. Ampache에서 오디오 트랜스코딩을 사용하려면 트랜스코딩 옵션에서 FFmpeg을 선택하고, 그렇지 않으면 트랜스코딩을 비활성화하십시오. 구성 파일을 저장하려면 [구성 생성]을 선택하십시오.

7. Ampache 관리자 계정을 생성합니다.

강력한 Ampache 관리자 사용자 이름과 암호를 만드세요. 이 계정은 Ampache에서 음악과 사용자를 관리하는 데 사용되며, Ubuntu 로그인 및 MariaDB 계정과는 별개입니다. 설치 프로그램이 데이터베이스 업데이트를 적용하도록 한 다음 로그인하세요.

8. 음악을 카탈로그로 추가하세요

Apache가 음악 폴더를 읽을 수 있도록 설정하세요. 파일이 실제로 있는 경로를 사용하십시오. 예시에서는 새 라이브러리 디렉터리를 생성합니다.

sudo mkdir -p /srv/music
sudo chgrp -R www-data /srv/music
sudo chmod -R g+rX /srv/music

트랙 파일을 해당 위치에 복사하거나 마운트한 다음 Ampache 관리자 계정으로 로그인하세요. 관리자 메뉴를 열고 ' 카탈로그 추가'를 선택합니다 . '<파일 이름>'과 같은 이름을 입력하고 Music전체 경로를 '<파일 이름>'으로 설정한 후 /srv/music로컬 음악 카탈로그를 선택하여 추가합니다. Ampache가 파일을 읽을 수 있도록 업데이트를 실행하세요. 카탈로그 가이드에서 카탈로그 관리 및 권한에 대한 설명을 확인할 수 있습니다.

안전한 원격 접속을 통해 라이브러리를 최신 상태로 유지하세요.

인터넷에서 접근 가능한 서버의 경우, 도메인의 DNS 레코드를 해당 서버로 지정하고 주소를 공유하기 전에 HTTPS를 구성해야 합니다. Ampache의 Ubuntu 가이드에서는 Apache와 함께 Certbot을 사용합니다.

sudo apt install snapd
sudo snap install certbot --classic
sudo certbot --apache -d ampache.example.com

인증서를 설치한 후, Ampache가 HTTPS 링크를 생성하도록 설정 force_ssl = "true"하십시오 /var/www/ampache/config/ampache.cfg.php. UFW(Ubuntu Firewall)에서 방화벽을 활성화하기 전에 서버의 SSH 포트를 허용하고, 그 다음 80번 포트와 443번 포트에서 웹 트래픽을 허용하십시오. MariaDB의 3306번 포트는 공용 인터넷에 대해 폐쇄된 상태로 유지하십시오. Ubuntu 방화벽 설명서에서 UFW 규칙에 대한 자세한 내용을 확인할 수 있습니다.

음악 스캔에서 아무것도 찾지 못하면 카탈로그 경로가 올바른지, 계정이 www-data파일을 읽고 각 디렉터리를 탐색할 수 있는지 확인하십시오. 정기적인 카탈로그 새로 고침 및 기타 예약된 작업을 위해서는 Ampache의 cron 작업을 구성하십시오 .