xjtdy888 / sspks

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

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.

Contribute

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