Overbyrns' Plugins for unRAID v6

Details

This is my collection of plugins for UnRAID v6;

• Beets: The purpose of beets is to get your music collection right once and for all. It catalogs your collection, automatically improving its metadata as it goes using the MusicBrainz database. (It also downloads cover art for albums it imports.) Then it provides a bouquet of tools for manipulating and accessing your music.

• DenyHosts: Analyzes the sshd server log messages to determine what hosts are attempting to hack into your system. It also determines what user accounts are being targeted. It keeps track of the frequency of attempts from each host. Additionally, upon discovering a repeated attack host, the /etc/hosts.deny file is updated to prevent future break-in attempts from that host.

• Dropbox: Free service that lets you bring all your photos, docs, and videos anywhere. This means that any file you save to your Dropbox will automatically save to all your computers, phones and the Dropbox website. This plug-in makes it possible to use your UnRAID server as a Dropbox location.

• NZBGet: A cross-platform binary newsgrabber for nzb files, written in C++. It supports client/server mode, automatic par-check/-repair and a web-interface. NZBGet requires low system resources making it ideal for running alongside UnRAID.

• SSH: Provides encrypted communication sessions over a computer network using the SSH protocol. SSH is typically used to log into a remote machine and execute commands, but it also supports tunneling, forwarding TCP ports and it can transfer files using the associated SSH file transfer (SFTP) or secure copy (SCP) protocols.

• Logitech Media Server (LMS): Logitech Media Server (formerly Squeezebox Server, SlimServer and SqueezeCenter) is a streaming audio server supported by Logitech (formerly Slim Devices), developed in particular to support their Squeezebox range of digital audio receivers. Plugin originally developed by Tom (developer of UnRAID) and later enhanced and maintained by Alex R Berg. My thanks to these and others who have contributed to the plugin as this version would not be possible without their help.
  

• pyload: pyLoad is a fast, lightweight and full featured download manager for many One-Click-Hoster, container formats like DLC, video sites or just plain http/ftp links.

Download Links

Use the following direct links to download each plugin:

Beets - (https://raw.githubusercontent.com/overbyrn/unraid-v6-plugins/master/beets.plg)
DenyHosts - (https://raw.githubusercontent.com/overbyrn/unraid-v6-plugins/master/denyhosts.plg)
Dropbox - (https://raw.githubusercontent.com/overbyrn/unraid-v6-plugins/master/dropbox.plg)
NZBGet - (https://raw.githubusercontent.com/overbyrn/unraid-v6-plugins/master/nzbget.plg)
SSH - (https://raw.githubusercontent.com/overbyrn/unraid-v6-plugins/master/ssh.plg)
LMS - (https://raw.githubusercontent.com/overbyrn/unraid-v6-plugins/master/lms.plg)
pyload - (https://raw.githubusercontent.com/overbyrn/unraid-v6-plugins/master/pyload.plg)

Installation

1. Navigate to the Plugins tab on the Unraid interface
2. Click the 'install plugin' sub tab
3. Either paste the LINK or navigate to the .PLG file and press install
4. Go to UnRAID WebGui -> Settings -> <Plugin Name> and configure your initial settings

---

Specific Information for SSH Plugin:

It is important to understand the way this plug-in decides what users are allowed SSH access and there are a number of settings which work together to provide a flexible and yet secure set of login options. Please spend a few minutes reading the details below as it will help you configure your system correctly.

Creating & Selecting Users

The plug-in allows multiple users to have SSH access. Use the standard Users page in the UnRAID WebGUI to create and maintain your users. Alternatively, you may create users from the command line - see Advanced User Creation section below.

When you enter the SSH plug-in, all users are listed and you are able to choose between none, one or many. If no users are selected, user root will be assumed - however read below to understand how to configure for root access:

Configuration Options

• Permit Root Login

  This option determines if user root is enabled for SSH. NB. Review the other options below as they affect whether root (or other users) can login, depending on the configuration of your users. eg. password assigned/empty etc.

• Password Authentication

  If this option is set to "no", then it is not possible to login using SSH unless the user has been configured with a public / private key pair. (See Creating Key-Pairs section)

• Permit Empty Passwords

  If this option is set to "no" but the user you wish to login with has a blank password, then SSH login will not be possible. The exception to this is rule is when a user has been configured with a public / private key pair.

Scenario 1: you require SSH access for root. root already has a password...

• Enable option PermitRootUser
• Enable option Password Authentication

Scenario 2: you require SSH access for root. root does not have a password...

• Enable option PermitRootUser
• Enable option Password Authentication
• Enable option Permit Empty Passwords
• or
• Assign a private / public key-pair (See Creating Key-Pairs section)

Scenario 3: you require SSH access for standard user. User already has a password...

• Select the user from the selection list
• Enable option Password Authentication

Advanced User Creation

When a user is created from within the UnRAID WebGUI, it is assigned a user id (UID) of 1000 or greater. When you create a user from outside of UnRAID at command line level, you must ensure your user is created with a suitable UID. The plug-in assumes if a user has a UID >= 1000, the user is not a system user as is therefore presented as an option in the plug-in. You can check the UID settings on your UnRAID system by viewing /etc/login.defs:

#
# Min/max values for automatic uid selection in useradd
#
UID_MIN 1000
UID_MAX 60000
# System accounts
SYS_UID_MIN 101
SYS_UID_MAX 999

Create users from command line using the following;

useradd -m -g users -s /bin/bash someuser

The above command creates user "someuser", including home dir and valid shell.

Creating Key-Pairs

You may have your users authenticate with a public / private key-pair. This allows you to remove password authentication altogether if so desired. Key-pairs provide an additional level of security, especially when assigned a passphrase.

The plug-in has been designed to check for the existance of a public key for each user set-up for SSH (inc. root). Perform the following steps to configure a user for a key-pair. We will use the example user fred:

1. In UnRAID **Users** page; create a new user (or do it from command line)
2. Go to OpenSSH settings page and select that user for SSH. Hit Apply and/or Start SSH
3. Browse to the plug-in directory on your flash drive : /boot/config/plugins/ssh - There should now be a sub-directory called `fred` - Inside this directory is another called `.ssh` - Open the **read_me.txt** file which you will find in this directory. This file contains full instructions on how to create a key-pair and configure for the plug-in. It also contains steps on how to convert the OpenSSH private key into a Putty compatible format. (all utilities needed are supplied as part of the plug-in installation). A master copy of *read_me.txt* is also stored in the root plugin directory (/boot/config/plugins/ssh).

---

Support

Please provide feedback to any problems encountered or to request enhancements or missing features that you would like to see added.

Support requests should be made in the UnRAID forum. Please use the following thread for all support queries; (http://lime-technology.com/forum/index.php?topic=39169.0)

Kind Regards,
overbyrn