Document live DNS deployment

This commit is contained in:
2026-10-07 17:26:32 +01:00
parent fd5685c5bb
commit 5163d7a893
2 changed files with 46 additions and 3 deletions
+39 -2
View File
@@ -5,8 +5,9 @@ The upstream project is pinned as a Git submodule, and the image build verifies
SHA-256 digest of every executable payload before including it.
The Compose stack also includes a local PS5 User Guide gateway: authoritative DNS
for `manuals.playstation.net`, HTTP/HTTPS redirect to the local exploit, and NXDOMAIN
for every other domain so the console cannot resolve PSN or update services.
for `manuals.playstation.net`, HTTP/HTTPS redirect to the local exploit, allowlisted
DNS forwarding for the homebrew store, and NXDOMAIN for every other domain so the
console cannot resolve PSN or update services.
Use this only on consoles you own or are authorized to test. The exploit can panic
the console, corrupt kernel state, expose administrative services, and execute
@@ -20,6 +21,42 @@ Documentation:
- [External payload candidate evidence](docs/payload-evidence/README.md)
- [Repository instructions for coding agents](AGENTS.md)
## Current deployment
The maintained LAN deployment runs on `net-utils01` from
`/opt/relapse-exploit-docker`:
| Service | LAN endpoint | Purpose |
| --- | --- | --- |
| Relapse page | `http://192.168.20.30:8000/` | Exploit page and payload assets |
| Restricted DNS | `192.168.20.30:53` UDP/TCP | User Guide override and store allowlist |
| User Guide gateway | `192.168.20.30:80` and `:443` TCP | Redirect to the local Relapse page |
Configure the PS5 with primary DNS `192.168.20.30` and secondary DNS `0.0.0.0`.
The DNS gateway resolves `manuals.playstation.net` locally, forwards only
`homebrew.page`, `github.com`, and `release-assets.githubusercontent.com` to its
configured upstream resolver, and returns NXDOMAIN for other names.
The console needs LAN access to DNS UDP/TCP 53 and TCP 80, 443, and 8000 on
`192.168.20.30`. For the homebrew store it also needs WAN egress on TCP 443 to the
three allowlisted domains; no WAN ingress rule is required. The server needs DNS
egress on UDP/TCP 53 to its configured resolver (`1.1.1.1` by default).
To deploy a reviewed commit:
```sh
ssh net-utils01
cd /opt/relapse-exploit-docker
git pull --ff-only
git submodule update --init --recursive
docker compose up -d --build
docker compose ps
curl -I http://127.0.0.1:8000/
```
Both Compose services must report `healthy`. Runtime changes require the rebuild
above; documentation-only changes need only the fast-forward pull.
## Clone and build
```sh