Based off work of https://gitlab.com/frag-o-matic/lan-cache So credits go to Bruno Gysels and MultiPlay.co.uk for the base they made!
Come visit us @ www.cu-lan.be | www.gunsnbits.de | www.discoverpc.net/ | https://lanfest.intel.com/netwar
OS: Debian 8.6 amd64 (Jessie)
- 1-8-2017 fh
- General
- Templated hosts file (as it was in "installer" branch)
- Updated configuration to be compatible with fhibler/lc-installer (forked from bntjah/lc-installer)
- DNS
- Replaced bind9 with unbound
- Improvements and fixes to unbound configuration
- Added additional domains for various CDNs
- HTTPS
- Incorporated sniproxy
- General
- 3-2-2017 bn_ & raz3r83
- General
- Updated the caches for Uplay CDN
- DNS
- Added additional domains for Uplay CDN
- General
- 3-7-2017 bn_ & Nexusofdoom
- DNS
- Added additional domain for Blizzard CDN
- DNS
- 3-27-2017 Travispk
- Cleaned up Readme
- Cleaned up interfaces
- Made some tweaks to unbound.conf to make it faster and lower the TTL if changes are necessary during event
- 3-30-2017 Travispk
- Cleaned up hosts to be in a more logical order
This repository contains instructions and configuration details for the a service, which is used for caching binary Gaming content for lan parties. It is part of the repository https://github.com/bntjah/lc-installer and is used as submodule of it. Of course it can be used standalone as well, although please be aware that the configuration files are mostly templated and therefore have to be changed manually for the use in different environments.
The quickest and easiest way ot get lancache up and running is the use of: https://github.com/bntjah/lc-installer (warning might contain bugs! So proceed on your own accord!)
If you want to install it manually, please follow the instructions below:
1) Install the required utilities
sudo apt-get install curl git unbound build-essential libpcre3 libpcre3-dev zlib1g-dev libreadline-dev libncurses5-dev git libssl-dev
2) Clone the git repo
git clone -b master http://github.com/bntjah/lancache
3) Install nginx
curl http://nginx.org/download/nginx-1.11.8.tar.gz | tar zx
cd ngnix-1.11.8
./configure --with-http_ssl_module --with-http_slice_module
make
sudo make install
4) Add the virtual interfaces (used for caching in nginx) to /etc/network/interfaces
# Ip used for STEAM caching
auto eth0:1
iface eth0:1 inet static
address 10.0.1.11
netmask 255.255.0.0
# Ip used for RIOT caching
auto eth0:2
iface eth0:2 inet static
address 10.0.1.12
netmask 255.255.0.0
# Ip used for Blizzard caching
auto eth0:3
iface eth0:3 inet static
address 10.0.1.13
netmask 255.255.0.0
# Ip used for Hirez caching
auto eth0:4
iface eth0:4 inet static
address 10.0.1.14
netmask 255.255.0.0
# Ip used for Origin caching
auto eth0:5
iface eth0:5 inet static
address 10.0.1.15
netmask 255.255.0.0
# Ip used for Sony caching
auto eth0:6
iface eth0:6 inet static
address 10.0.1.16
netmask 255.255.0.0
# Ip used for Microsoft caching
auto eth0:7
iface eth0:7 inet static
address 10.0.1.17
netmask 255.255.0.0
# Ip used for Tera caching
auto eth0:8
iface eth0:8 inet static
address 10.0.1.18
netmask 255.255.0.0
# Ip used for GOG caching
auto eth0:9
iface eth0:9 inet static
address 10.0.1.19
netmask 255.255.0.0
# Ip used for ArenaNetworks caching
auto eth0:10
iface eth0:10 inet static
address 10.0.1.20
netmask 255.255.0.0
# Ip used for WarGaming caching
auto eth0:11
iface eth0:11 inet static
address 10.0.1.21
netmask 255.255.0.0
# Ip used for Uplay caching
auto eth0:12
iface eth0:12 inet static
address 10.0.1.22
netmask 255.255.0.0
5) Create the user lancache
sudo adduser --system --no-create-home lancache
sudo addgroup --system lancache
sudo usermod -aG lancache lancache
6) Just create the folders:
sudo mkdir -p /srv/lancache/data/blizzard/
sudo mkdir -p /srv/lancache/data/microsoft/
sudo mkdir -p /srv/lancache/data/installs/
sudo mkdir -p /srv/lancache/data/other/
sudo mkdir -p /srv/lancache/data/tmp/
sudo mkdir -p /srv/lancache/data/hirez/
sudo mkdir -p /srv/lancache/data/origin/
sudo mkdir -p /srv/lancache/data/riot/
sudo mkdir -p /srv/lancache/data/gog/
sudo mkdir -p /srv/lancache/data/sony/
sudo mkdir -p /srv/lancache/data/steam/
sudo mkdir -p /srv/lancache/data/wargaming
sudo mkdir -p /srv/lancache/data/tera
sudo mkdir -p /srv/lancache/data/arenanetworks
sudo mkdir -p /srv/lancache/data/uplay
sudo mkdir -p /srv/lancache/logs/Errors
sudo mkdir -p /srv/lancache/logs/Keys
sudo mkdir -p /srv/lancache/logs/Access
6.1) chown the folder:
sudo chown -R lancache:lancache /srv/lancache
7) Copy the conf folder and contents (where you originally git cloned it to in step 4) to /usr/local/nginx/conf/
sudo cp -R ~/lancache/conf /usr/local/nginx/
7.1) Replace the proxy_bind variable with your primary IP address (not one of the virtual ones)
8) Copy the Lancache file from init.d/ to /etc/init.d/ by:
sudo cp -R lancache /etc/init.d/lancache
9) Make it an executable:
sudo chmod +x /etc/init.d/lancache
10) Put it in the standard Boot:
sudo update-rc.d lancache defaults
11) Copy limits.conf to /etc/security/limits.conf
12) Copy hosts to /etc/hosts
12.1) Replace the hostnames with the virtual IPs
13) Disable IPv6
sudo echo "net.ipv6.conf.all.disable_ipv6=1" >/etc/sysctl.d/disable-ipv6.conf
sudo sysctl -p /etc/sysctl.d/disable-ipv6.conf
14) Install sniproxy for passing through HTTPS traffic (cannot be cached)
14.1) git clone https://github.com/dlundquist/sniproxy
14.2) sudo curl https://raw.githubusercontent.com/OpenSourceLAN/origin-docker/master/sniproxy/sniproxy.conf -o /etc/sniproxy.conf
19.3) cd sniproxy
19.4) ./autogen.sh && ./configure && make check && sudo make install
19.5) Start sniproxy with ./sniproxy -c /etc/sniproxy.conf
15) Copy the unbound configuration from unbound/unbound.conf to /etc/unbound/unbound.conf
15.1) Replace the interfaces: section with the normal ip (not the virtual ones)
15.2) Replace all A records with the appropriate IPs (the virtual IPs for the appropriate caching service)
A) Monitor through nload
sudo apt-get install nload -y
sudo nload -U G - u M -i 102400 -o 102400
B) Monitor network usage through iftop
sudo apt-get install iftop -y
sudo iftop -i eth0
(Instead of eth0 just use your physical interface)
If your lancache server is a DHCP client, please add public resolvers (not the ones who you use for your LAN party guests) to dhclient.conf to avoid resolving issues for the cache server. This can be achieved like this: - Add to /etc/dhclient.conf: prepend domain-name-servers 8.8.8.8, 8.8.4.4;
Alternatively you can use one of those mechanism to avoid resolv.conf being overwritten by DHCP or other services: https://www.cyberciti.biz/faq/dhclient-etcresolvconf-hooks/