nixos/middleman: Add self-hosted Paseo relay
Package paseo-relay and add a small `my.paseo-relay` module running it as a single node without Erlang distribution. Publish it on `paseo-relay.nul.ie` so Paseo daemons and the app can use our own relay instead of the hosted one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -48,7 +48,7 @@ their current addresses. Each container has its own page:
|
|||||||
|
|
||||||
| Container | Role |
|
| Container | Role |
|
||||||
|---|---|
|
|---|---|
|
||||||
| [`middleman`](containers/middleman.md) | Reverse proxy, ACME, nginx-sso, librespeed |
|
| [`middleman`](containers/middleman.md) | Reverse proxy, ACME, nginx-sso, librespeed, Paseo relay |
|
||||||
| [`vaultwarden`](containers/vaultwarden.md) | Password manager |
|
| [`vaultwarden`](containers/vaultwarden.md) | Password manager |
|
||||||
| [`colony-psql`](containers/colony-psql.md) | Shared PostgreSQL (14) |
|
| [`colony-psql`](containers/colony-psql.md) | Shared PostgreSQL (14) |
|
||||||
| [`chatterbox`](containers/chatterbox.md) | Matrix Synapse + bridges |
|
| [`chatterbox`](containers/chatterbox.md) | Matrix Synapse + bridges |
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
The front-end reverse proxy for the colony's public web services — the single ingress that
|
The front-end reverse proxy for the colony's public web services — the single ingress that
|
||||||
`estuary` DNATs HTTP/HTTPS (and Matrix federation on `:8448`) to. Terminates TLS with wildcard
|
`estuary` DNATs HTTP/HTTPS (and Matrix federation on `:8448`) to. Terminates TLS with wildcard
|
||||||
certificates it issues itself, provides nginx-sso for gated vhosts, and runs a librespeed
|
certificates it issues itself, provides nginx-sso for gated vhosts, and runs a librespeed
|
||||||
backend.
|
backend and a Paseo relay.
|
||||||
|
|
||||||
- **Source:** [`shill/containers/middleman/`](../../../../../nixos/boxes/colony/vms/shill/containers/middleman)
|
- **Source:** [`shill/containers/middleman/`](../../../../../nixos/boxes/colony/vms/shill/containers/middleman)
|
||||||
(`default.nix`, `vhosts.nix`)
|
(`default.nix`, `vhosts.nix`)
|
||||||
@@ -42,6 +42,17 @@ username/password provider. Its cookie domain is `.nul.ie`; gated vhosts include
|
|||||||
The frontend and backend are published as `speed.nul.ie` and `librespeed.ams1.int.nul.ie`, both
|
The frontend and backend are published as `speed.nul.ie` and `librespeed.ams1.int.nul.ie`, both
|
||||||
proxied to `localhost:8989`.
|
proxied to `localhost:8989`.
|
||||||
|
|
||||||
|
### Paseo relay
|
||||||
|
|
||||||
|
[`paseo-relay`](https://github.com/getpaseo/paseo-relay) (the `my.paseo-relay` module, package
|
||||||
|
`pkgs/paseo-relay.nix`) relays end-to-end encrypted traffic between Paseo daemons and the Paseo
|
||||||
|
app, in place of Paseo's hosted relay.
|
||||||
|
|
||||||
|
- Single node with no Erlang distribution, listening on `127.0.0.1:4000` and published as
|
||||||
|
`paseo-relay.nul.ie`. It keeps no state, so a restart only drops connections.
|
||||||
|
- The relay can't read or forge messages, so the vhost is open to the world. Its Prometheus
|
||||||
|
`/metrics` is not exposed; `/health` and `/ready` are.
|
||||||
|
|
||||||
## Network assignments
|
## Network assignments
|
||||||
|
|
||||||
See the consolidated [network assignments](../../../../networking.md#box-assignments) table (this box: `middleman`).
|
See the consolidated [network assignments](../../../../networking.md#box-assignments) table (this box: `middleman`).
|
||||||
@@ -78,6 +89,7 @@ all vhosts are `onlySSL`, kTLS and HTTP/2. "SSO" = gated behind nginx-sso (`gene
|
|||||||
| `mc-map-kink.nul.ie` | `kinkcraft-oci:8100` | Minecraft map ([`whale2`](../../whale2.md#game-servers)) |
|
| `mc-map-kink.nul.ie` | `kinkcraft-oci:8100` | Minecraft map ([`whale2`](../../whale2.md#game-servers)) |
|
||||||
| `speed.nul.ie` | `localhost:8989` | librespeed |
|
| `speed.nul.ie` | `localhost:8989` | librespeed |
|
||||||
| `librespeed.ams1.int.nul.ie` | `localhost:8989` | librespeed on the internal domain (internal wildcard cert) |
|
| `librespeed.ams1.int.nul.ie` | `localhost:8989` | librespeed on the internal domain (internal wildcard cert) |
|
||||||
|
| `paseo-relay.nul.ie` | `localhost:4000` | Paseo relay; websockets with long timeouts; `/metrics` blocked |
|
||||||
| `md.nul.ie` | `object-ctr:3000` | HedgeDoc; websockets |
|
| `md.nul.ie` | `object-ctr:3000` | HedgeDoc; websockets |
|
||||||
| `pb.nul.ie` | `object-ctr:8088` | wastebin |
|
| `pb.nul.ie` | `object-ctr:8088` | wastebin |
|
||||||
| `photos.nul.ie` | `jackflix-ctr:2342` | PhotoPrism; websockets |
|
| `photos.nul.ie` | `jackflix-ctr:2342` | PhotoPrism; websockets |
|
||||||
@@ -90,6 +102,6 @@ all vhosts are `onlySSL`, kTLS and HTTP/2. "SSO" = gated behind nginx-sso (`gene
|
|||||||
|
|
||||||
## Notable config files
|
## Notable config files
|
||||||
|
|
||||||
- [`nixos/boxes/colony/vms/shill/containers/middleman/default.nix`](../../../../../nixos/boxes/colony/vms/shill/containers/middleman/default.nix) — container definition: nginx, ACME, nginx-sso, librespeed, secrets
|
- [`nixos/boxes/colony/vms/shill/containers/middleman/default.nix`](../../../../../nixos/boxes/colony/vms/shill/containers/middleman/default.nix) — container definition: nginx, ACME, nginx-sso, librespeed, Paseo relay, secrets
|
||||||
- [`nixos/boxes/colony/vms/shill/containers/middleman/vhosts.nix`](../../../../../nixos/boxes/colony/vms/shill/containers/middleman/vhosts.nix) — all virtual hosts, the SSO include helpers, and the `.well-known` tree
|
- [`nixos/boxes/colony/vms/shill/containers/middleman/vhosts.nix`](../../../../../nixos/boxes/colony/vms/shill/containers/middleman/vhosts.nix) — all virtual hosts, the SSO include helpers, and the `.well-known` tree
|
||||||
- [`nixos/boxes/colony/vms/shill/containers/middleman/default.html`](../../../../../nixos/boxes/colony/vms/shill/containers/middleman/default.html) — default vhost landing page
|
- [`nixos/boxes/colony/vms/shill/containers/middleman/default.html`](../../../../../nixos/boxes/colony/vms/shill/containers/middleman/default.html) — default vhost landing page
|
||||||
|
|||||||
@@ -138,6 +138,8 @@ in
|
|||||||
extraSettingsFile = config.age.secrets."librespeed.toml".path;
|
extraSettingsFile = config.age.secrets."librespeed.toml".path;
|
||||||
};
|
};
|
||||||
};
|
};
|
||||||
|
|
||||||
|
paseo-relay.enable = true;
|
||||||
};
|
};
|
||||||
|
|
||||||
users = {
|
users = {
|
||||||
|
|||||||
@@ -378,6 +378,22 @@ in
|
|||||||
useACMEHost = pubDomain;
|
useACMEHost = pubDomain;
|
||||||
};
|
};
|
||||||
|
|
||||||
|
"paseo-relay.${pubDomain}" = {
|
||||||
|
locations = {
|
||||||
|
"/" = {
|
||||||
|
proxyPass = "http://127.0.0.1:${toString config.my.paseo-relay.port}";
|
||||||
|
proxyWebsockets = true;
|
||||||
|
extraConfig = ''
|
||||||
|
${proxyHeaders}
|
||||||
|
proxy_read_timeout 1h;
|
||||||
|
proxy_send_timeout 1h;
|
||||||
|
'';
|
||||||
|
};
|
||||||
|
"= /metrics".return = "404";
|
||||||
|
};
|
||||||
|
useACMEHost = pubDomain;
|
||||||
|
};
|
||||||
|
|
||||||
"md.${pubDomain}" = {
|
"md.${pubDomain}" = {
|
||||||
locations."/" = {
|
locations."/" = {
|
||||||
proxyPass = "http://object-ctr.${domain}:3000";
|
proxyPass = "http://object-ctr.${domain}:3000";
|
||||||
|
|||||||
@@ -20,6 +20,7 @@
|
|||||||
nvme = ./nvme;
|
nvme = ./nvme;
|
||||||
spdk = ./spdk.nix;
|
spdk = ./spdk.nix;
|
||||||
librespeed = ./librespeed;
|
librespeed = ./librespeed;
|
||||||
|
paseo-relay = ./paseo-relay.nix;
|
||||||
netboot = ./netboot;
|
netboot = ./netboot;
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,69 @@
|
|||||||
|
{ lib, pkgs, config, ... }:
|
||||||
|
let
|
||||||
|
inherit (lib) mkIf mapAttrs;
|
||||||
|
inherit (lib.my) mkOpt' mkBoolOpt';
|
||||||
|
|
||||||
|
cfg = config.my.paseo-relay;
|
||||||
|
in
|
||||||
|
{
|
||||||
|
options.my.paseo-relay = with lib.types; {
|
||||||
|
enable = mkBoolOpt' false "Whether to enable the Paseo relay.";
|
||||||
|
package = mkOpt' package pkgs.paseo-relay "Paseo relay package.";
|
||||||
|
host = mkOpt' str "127.0.0.1" "Address to listen on.";
|
||||||
|
port = mkOpt' port 4000 "Port to listen on (plain HTTP / WebSocket).";
|
||||||
|
environment = mkOpt' (attrsOf (oneOf [ str int bool ])) { }
|
||||||
|
"Extra `PASEO_RELAY_*` environment variables (see the relay's README).";
|
||||||
|
};
|
||||||
|
|
||||||
|
config = mkIf cfg.enable {
|
||||||
|
systemd.services.paseo-relay = {
|
||||||
|
description = "Paseo relay";
|
||||||
|
wants = [ "network-online.target" ];
|
||||||
|
after = [ "network-online.target" ];
|
||||||
|
|
||||||
|
environment = {
|
||||||
|
PASEO_RELAY_HOST = cfg.host;
|
||||||
|
PASEO_RELAY_PORT = toString cfg.port;
|
||||||
|
# Single node: no Erlang distribution (and so no epmd)
|
||||||
|
RELEASE_DISTRIBUTION = "none";
|
||||||
|
RELEASE_TMP = "/run/paseo-relay";
|
||||||
|
HOME = "/run/paseo-relay";
|
||||||
|
} // mapAttrs (_: v: if v == true then "true" else if v == false then "false" else toString v)
|
||||||
|
cfg.environment;
|
||||||
|
|
||||||
|
# The release script requires a cookie even without distribution
|
||||||
|
script = ''
|
||||||
|
RELEASE_COOKIE="$(head -c 32 /dev/urandom | sha256sum | cut -d' ' -f1)"
|
||||||
|
export RELEASE_COOKIE
|
||||||
|
exec ${cfg.package}/bin/paseo_relay start
|
||||||
|
'';
|
||||||
|
|
||||||
|
serviceConfig = {
|
||||||
|
DynamicUser = true;
|
||||||
|
RuntimeDirectory = "paseo-relay";
|
||||||
|
Restart = "always";
|
||||||
|
RestartSec = 5;
|
||||||
|
|
||||||
|
CapabilityBoundingSet = "";
|
||||||
|
NoNewPrivileges = true;
|
||||||
|
PrivateDevices = true;
|
||||||
|
PrivateTmp = true;
|
||||||
|
ProtectClock = true;
|
||||||
|
ProtectControlGroups = true;
|
||||||
|
ProtectHome = true;
|
||||||
|
ProtectHostname = true;
|
||||||
|
ProtectKernelLogs = true;
|
||||||
|
ProtectKernelModules = true;
|
||||||
|
ProtectKernelTunables = true;
|
||||||
|
ProtectProc = "invisible";
|
||||||
|
ProtectSystem = "strict";
|
||||||
|
RestrictAddressFamilies = [ "AF_INET" "AF_INET6" "AF_UNIX" ];
|
||||||
|
RestrictNamespaces = true;
|
||||||
|
RestrictRealtime = true;
|
||||||
|
LockPersonality = true;
|
||||||
|
SystemCallArchitectures = "native";
|
||||||
|
};
|
||||||
|
wantedBy = [ "multi-user.target" ];
|
||||||
|
};
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -7,6 +7,7 @@ in
|
|||||||
monocraft' = callPackage ./monocraft.nix { };
|
monocraft' = callPackage ./monocraft.nix { };
|
||||||
vfio-pci-bind = callPackage ./vfio-pci-bind.nix { };
|
vfio-pci-bind = callPackage ./vfio-pci-bind.nix { };
|
||||||
librespeed-go = callPackage ./librespeed-go.nix { };
|
librespeed-go = callPackage ./librespeed-go.nix { };
|
||||||
|
paseo-relay = callPackage ./paseo-relay.nix { };
|
||||||
# modrinth-app = callPackage ./modrinth-app { };
|
# modrinth-app = callPackage ./modrinth-app { };
|
||||||
chocolate-doom2xx = callPackage ./chocolate-doom2xx { };
|
chocolate-doom2xx = callPackage ./chocolate-doom2xx { };
|
||||||
windowtolayer = callPackage ./windowtolayer.nix { };
|
windowtolayer = callPackage ./windowtolayer.nix { };
|
||||||
|
|||||||
@@ -0,0 +1,30 @@
|
|||||||
|
{ lib, beam, fetchFromGitHub, ... }:
|
||||||
|
let
|
||||||
|
beamPackages = beam.packages.erlang_29.overrideScope (final: prev: {
|
||||||
|
elixir = prev.elixir_1_20;
|
||||||
|
});
|
||||||
|
in
|
||||||
|
beamPackages.mixRelease rec {
|
||||||
|
pname = "paseo-relay";
|
||||||
|
version = "0.1.0-unstable-2026-10-28";
|
||||||
|
|
||||||
|
src = fetchFromGitHub {
|
||||||
|
owner = "getpaseo";
|
||||||
|
repo = "paseo-relay";
|
||||||
|
rev = "5f4b7636af41a85ef20200c0b7e99dd1ea2ee1f2";
|
||||||
|
hash = "sha256-F4PQg5vU9sI3d9XWukbINdBmhbfcehBzeUVxPKZ06Jg=";
|
||||||
|
};
|
||||||
|
|
||||||
|
mixFodDeps = beamPackages.fetchMixDeps {
|
||||||
|
pname = "mix-deps-${pname}";
|
||||||
|
inherit src version;
|
||||||
|
hash = "sha256-3J2C4XGqjdM0TYf+Vkv5/AY59tiKLVX81Gxrs9pvKuY=";
|
||||||
|
};
|
||||||
|
|
||||||
|
meta = {
|
||||||
|
description = "WebSocket relay for Paseo daemons and clients";
|
||||||
|
homepage = "https://github.com/getpaseo/paseo-relay";
|
||||||
|
license = lib.licenses.asl20;
|
||||||
|
mainProgram = "paseo_relay";
|
||||||
|
};
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user