jdel / sspks

A very simple Synology Package Server, reverse engineered from the official Synology package repository and SynoCommunity.
GNU General Public License v3.0
258 stars 64 forks source link

Scrutinizer Code Quality Code Coverage Build Status Build Status

Open in Gitpod

Simple SPK Server

A very simple Synology Package Server, reverse engineered from the official Synology package repository and SynoCommunity.

This php script will serve SPKs to a Synology Package Center while also offering regular HTTP browsing through the available SPKs.

Installation

Please see the INSTALL file for instructions.

Docker

Docker images are built automatically from this repository and are available on Docker Hub.

In order to use them you will need a working installation of Docker.

Simply run the following command:

docker run -d --name sspks \
  -v /path/to/your/local/packages:/packages \
  -v /path/to/your/local/cache:/cache \
  -p 9999:8080 \
  -e SSPKS_SITE_NAME="My Packages" \
  -e SSPKS_PACKAGES_DISTRIBUTOR_URL=https://cake.com \
  jdel/sspks

More environment variables are available to configure SSPKS:

Variables Description Values
SSPKS_SITE_NAME Define the Site Name Synology Repository
SSPKS_SITE_THEME Allows the selection of the theme used classic, material (default)
SSPKS_PACKAGES_FILE_MASK Defines the format of the package to be processed. *.spk
SSPKS_PACKAGES_MAINTAINER Name of the developer String
SSPKS_PACKAGES_MAINTAINER_URL Url of the developer, if available the maintainer is shown as link URL
SSPKS_PACKAGES_DISTRIBUTOR Package Center shows the publisher of the package String
SSPKS_PACKAGES_DISTRIBUTOR_URL If a package is installed and has a "help" webpage, Package Center will show a link to let user open it URL
SSPKS_PACKAGES_SUPPORT_URL Package Center shows a support link to allow users to seek technical support when needed URL
SSPKS_SITE_REDIRECTINDEX Instead of listing the packages, a direct redirect to the defined URL is set. URL

In the command above, replace /path/to/your/local/packages with the directory containing your packages, /path/to/your/local/cache with the directory that will hold the cache files and -p 9999 with the port you intend to serve packages on.

Should you want SSL/TLS (you really should), you need to handle SSL/TLS termination externally, for example with Traefik that will automatically fetch Let's Encrypt certificates for you.


Gitpod Environment Variables

The following features can be enabled through environment variables that have been set in your Gitpod preferences.:
* Please note that storing sensitive data in environment variables is not ultimately secure but should be OK for most development situations.


Contribute

Feel free to contribute, improve the code or the design by forking https://github.com/jdel/sspks.git