|
1 | | -# TSN-Ranksystem |
| 1 | +# TS3 Ranksystem |
| 2 | + |
| 3 | + |
| 4 | + |
2 | 5 |
|
3 | | -   [](https://github.com/Newcomer1989/TSN-Ranksystem/issues) |
| 6 | +System that automatically grants ranks in the form of server groups for online time or online activity to users, using the given server groups of the TS3 server. |
4 | 7 |
|
5 | | -The TSN Ranksystem is an easy to handle Level System to automatically grant ranks (servergroups) to users on a TeamSpeak Server for online time or online activity. You can create your own servergroups, with permissions, icons etc. of your choice, and define these for the Ranksystem. Its open source and so its free to use under the GNU license with version 3. |
| 8 | +This is a modified fork of the TSN-Ranksystem which is updated irregularly to a stable version (currently **1.3.17**) . It is intended to be fully compatible to TSN-Ranksystem at all times. The changeset on branch `develop` is always rebased onto TSN-Ranksystem and later on merged into `master`. |
6 | 9 |
|
7 | | -#### Official website: [TS-Ranksystem.com](https://ts-ranksystem.com) |
| 10 | +Please make sure that your TSN-Ranksystem (database) version is not above the (database) version of this fork (downgrade). |
| 11 | + |
| 12 | +## Docker |
| 13 | +You can find the docker images on docker hub as [jvmerkle/ts3-ranksystem](https://hub.docker.com/r/jvmerkle/ts3-ranksystem). |
| 14 | +Please note that the container **MUST BE accessed via a trusted proxy server only** (e.g. nginx). |
| 15 | +Make sure to set `BASE_HREF` to the relative URL path of the rank system (e.g. `https://foobar.com/frank/ranksystem` => `BASE_HREF=/frank/ranksystem/`) in the `docker-compose.yml` |
| 16 | + |
| 17 | +### First time setup |
| 18 | +Enable the `INSTALL_MODE=1` in the file `docker-compose.yml` by uncommenting the line. Then start the rank system with: |
| 19 | +```sh |
| 20 | +docker-compose up |
| 21 | +``` |
| 22 | +Navigate to [http://localhost:8080/install.php](http://localhost:8080/install.php) and set up the rank system. |
| 23 | +After performing the first time setup re-edit the `docker-compose.yml` by commenting or removing the `INSTALL_MODE`. |
| 24 | +Then start the docker containers in daemon mode: |
| 25 | +```sh |
| 26 | +docker-compose up -d |
| 27 | +``` |
| 28 | + |
| 29 | +### Existing installation |
| 30 | +Import your database into the `ranksystem-db` container and update the `DB_NAME` of the docker compose file if required. |
| 31 | + |
| 32 | +## Modifications |
| 33 | +Additions and (security) improvements to [Newcomer1989/TSN-Ranksystem](https://github.com/Newcomer1989/TSN-Ranksystem) |
| 34 | + |
| 35 | +- Disabled self-updating process, which __exposes information__ to *ts-n.net* such as |
| 36 | + - TeamSpeak Statistics (e.g. users per day/week/month/quarter) |
| 37 | + - Teamspeak hostname and port (e.g. localhost / abc.xyz) |
| 38 | + - ... |
| 39 | + - The update __check__ does __not__ enforce SSL peer verification and is therefore insecure |
| 40 | +- Secure api key comparison |
| 41 | +- No unnecessary webinterface HTTPS warning for rank systems behind a proxy |
| 42 | +- Docker-Ready |
| 43 | +- Aesthetics: |
| 44 | + - Website title is set to "TS3 Ranksystem" |
| 45 | + - The favicon link is removed from the page head |
| 46 | + - "Ranksystem info" is moved from the navbar to the footer |
| 47 | + |
| 48 | +## History |
| 49 | +The following patches are no longer applied (no longer required): |
| 50 | + |
| 51 | +- Removal of base64 encoded "copyright checks" which reported the violation to the *ts-n.net* server: |
| 52 | + - For `info.php` page modifications |
| 53 | + - For removal of the `info.php` hyperlink from the sidebar |
| 54 | +- Removal of an April fool |
| 55 | +- CSRF protection fix |
| 56 | + |
| 57 | +## License |
| 58 | +This project is licensed under the terms of the GNU General Public License v3.0. |
0 commit comments