NGINX + Google PageSpeed
Configuring NGINX to build correctly is a pain. Not because of anything wrong with it, but rather because of how slim the standard install is: no HTTPS, no Web-Sockets, no PAM, etc., since they are all independent modules. While this is sound in principle, it's inconvenient for end-users.
Luckily, most distributions fork it, make a few changes and bundle it with everyone's favorite modules. Installing NGINX from your distribution's repositories will always give you a batteries-included configuration. This convenience presents a dilemma: either accept what your distribution gives you and lose the flexibility of customizing your installation or bite the bullet and try to figure everything out yourself.
I could no longer accept the default installation once I decided to have Google PageSpeed on my servers. If you're on this repository, I don't think I need to explain the benefits. In short, Mod PageSpeed is a collection of filters that apply optimizations to content going through it such as compression, minification, conversion to modern formats, lazy-loading, and more.
There was painfully little documentation on the topic of forking a Debian package, but I managed to piece it together. This repository is the result: a seamless way to substitute Debian-flavored NGINX with Debian-flavored NGINX + PageSpeed. Enjoy!
Installation
This installation guide aims to support any modern Debian-based system (including Ubuntu). Open an issue if it doesn't work. The Debian packages are built on Ubuntu 20.04, and should be compatible with newer releases.
Download Keys
The GitHub worker signs the packages using the key below. You need to trust them to be able to install the packages.
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 8028BE1819F3E4A0
Connect Source
Create /etc/apt/sources.list.d/nginx-pagespeed.list and put the following line into it:
deb https://nginx-pagespeed.knyz.org/dist/ /
This will enable apt to find the PageSpeed-patched versions of NGINX.
Pin Source
To prevent other sources from overwriting NGINX during updates, pin it by creating /etc/apt/preferences.d/99nginx-pagespeed and placing the following inside of it:
Package: *
Pin: origin http://nginx-pagespeed.knyz.org/
Pin-Priority: 900
This will make apt unconditionally prefer PageSpeed-patched versions of NGINX.
Installing
- Run
sudo apt update, look out for any errors. - Run
apt-cache policy nginx-full, validate that the selected candidate is fromnginx-pagespeed.knyz.org. - Run
sudo apt install nginx-full, ornginx-lightdepending on what you're looking for
Done!
Usage
There are more than enough guides around PageSpeed. My recommended setup is to place the following file into /etc/nginx/conf.d/pagespeed.conf:
pagespeed on;
pagespeed FileCachePath "/var/cache/pagespeed/";
pagespeed FileCacheSizeKb 102400;
pagespeed FileCacheCleanIntervalMs 3600000;
pagespeed FileCacheInodeLimit 500000;
pagespeed RewriteLevel CoreFilters;
Remember to run sudo systemctl reload nginx after any changes.
![make: *** [Makefile:16: modules] Error 2 when compiling module only against patch aarch64 PSOL Libraries](https://avatars.githubusercontent.com/u/30222551?v=4)
82 Nov 18, 2022
7 Jan 1, 2023
59 Dec 29, 2022
4 Oct 31, 2022
1 Jan 10, 2022
30 Jul 1, 2022
34 Dec 23, 2022
12 May 20, 2022
10 Aug 27, 2022
2.8k Dec 31, 2022
134 Dec 20, 2022
9 Dec 20, 2022
123 Dec 24, 2022
53 Dec 21, 2022
5 Feb 16, 2022
3 Jun 8, 2022
5 Dec 23, 2022
6 May 11, 2023
11 Nov 23, 2022