在Debian 9上,如何安装Koel

・9 分钟阅读

使用不同的系统?

Koel是一个简单的基于Web的个人音频流应用程序,在客户端使用Vue编写,在服务器端使用Laravel编写。Koel源代码托管在github上 ,本指南将向你展示如何在新的Debian 9实例上安装Koel 。

要求

  • PHP版本5.6.4或更高版本,有以下扩展名:
    • OpenSSL
    • PDO
    • Mbstring
    • Tokenizer
    • XML
  • MariaDB
  • NodeJS带有yarn
  • Composer

开始之前

查看Debian版本。


lsb_release -ds
# Debian GNU/Linux 9.5 (stretch)

确保你的系统是最新的。


apt update && apt upgrade -y

安装必要的软件包。


apt install -y build-essential sudo dirmngr wget curl vim git

使用sudo访问创建一个新的非root用户帐户,并且切换到它。


adduser johndoe --gecos"John Doe"
usermod -aG sudo johndoe
su - johndoe

注:将johndoe替换为你的用户名。

设置时区。


sudo dpkg-reconfigure tzdata

安装PHP

安装PHP和所需的PHP扩展。


sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-mbstring php7.0-xml php7.0-mysql php7.0-curl php7.0-zip

检查版本。


php --version

# PHP 7.0.30-0+deb9u1 (cli) (built: Jun 14 2018 13:50:25) ( NTS )
# Copyright (c) 1997-2017 The PHP Group
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies
# with Zend OPcache v7.0.30-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies

安装MariaDB

安装MariaDB 。


sudo apt install -y mariadb-server

检查版本。


mysql --version
# mysql Ver 15.1 Distrib 10.1.26-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2

运行mysql_secure installation脚本以提高安全性,并为MariaDB root用户设置密码。


sudo mysql_secure_installation

将MariaDB shell作为root用户连接到。


sudo mysql -u root -p
# Enter password

为Koel创建一个空的Mariadb数据库和用户,并记住凭据。


CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT;

安装Nginx

安装Nginx 。


sudo apt install -y nginx

检查版本。


sudo nginx -v
# nginx version: nginx/1.10.3

运行 sudo vim /etc/nginx/sites-available/koel.conf 并为Koel配置Nginx 。


server {
 listen 80;
 server_name example.com;
 root /var/www/koel;
 index index.php;


 # Whitelist only index.php, robots.txt, and those start with public/ or api/ or remote
 if ($request_uri !~ ^/$|index.php|robots.txt|api/|public/|remote) {
 return 404;
 }

 location /media/ {
 internal;
 # A 'X-Media-Root' should be set to media_path settings from upstream
 alias $upstream_http_x_media_root;
 }

 location / {
 try_files $uri $uri/ /index.php?$args;
 }

 location ~ .php$ {
 try_files $uri $uri/ /index.php?$args;
 fastcgi_param PATH_INFO $fastcgi_path_info;
 fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
 fastcgi_index index.php;
 fastcgi_split_path_info ^(.+.php)(/.+)$;
 fastcgi_intercept_errors on;
 include fastcgi_params;
 }
}

通过将文件链接到sites-enabled目录来激活新的koel.conf配置。


sudo ln -s /etc/nginx/sites-available/koel.conf /etc/nginx/sites-enabled/

测试Nginx配置。

 
sudo nginx -t

 

重新加载Nginx 。


sudo systemctl reload nginx.service

安装Node.js

安装node.js 。


curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs

检查版本。


node --version
# v8.11.3

安装Yarn

安装Yarn软件包管理器。


curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo"deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install -y yarn

检查版本。


yarn --version
# 1.7.0

安装Composer

安装Composer。


php -r"copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r"if (hash_file('sha384', 'composer-setup.php') === '93b54496392c062774670ac18b134c3b3a95e5a5e5c8f1a9f115f203b75bf9a129d5daa8ba6a13e2cc8a1da0806388a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r"unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

检查版本。


composer --version
# Composer version 1.6.5 2018-05-04 11:44:59

安装Koel

创建一个空文档根目录,其中将安装Koel 。


sudo mkdir -p /var/www/koel

导航到文档根目录。

 
cd/var/www/koel

 

/var/www/koel的所有权更改为用户johndoe


sudo chown -R johndoe:johndoe /var/www/koel

将Koel存储库克隆到它,签出最新的标记版本,并且安装它依赖项。


git clone https://github.com/phanan/koel.git .
git checkout v3.7.2
composer install

运行php artisan koel:init命令来设置数据库和管理员帐户。


php artisan koel:init

运行vim .env并将APP_URL设置为你的URL 。


APP_URL=http://example.com

运行yarn install来编译和安装前端依赖项。

 
yarn install

 

/var/www/koel目录的所有权更改为www-data


sudo chown -R www-data:www-data /var/www/koel

设置已完成,要继续,在网络浏览器中打开域名,你将看到登录页面,然后,输入你以前创建的管理员帐户凭据登录。

杨和超 profile image