gru
eba9f89283
- Web Server reads static files inline; proxy middleware chain flattened - About window with license summary and project links; AGPL-3.0-or-later - Rewritten documentation: feature list, screenshots, performance guide - Fix false spikes in per-Vhost request-rate charts
68 lines
3.9 KiB
Markdown
68 lines
3.9 KiB
Markdown
# RustProxy documentation
|
|
|
|
Guides for operating RustProxy: installation, publishing services, security, certificates, monitoring and automation. The same pages are available in the administration panel under **`/docs → Reader`**, next to the interactive **API** reference.
|
|
|
|
- Project website and packages: [rustproxy.linuxiarz.pl](https://rustproxy.linuxiarz.pl/)
|
|
- Source code: [git.linuxiarz.pl/gru/RustProxy](https://git.linuxiarz.pl/gru/RustProxy)
|
|
- License: [GNU AGPL v3.0 or later](../LICENSE)
|
|
|
|
## Overview
|
|
|
|
- [Feature list](FEATURES.md) — everything RustProxy can do, grouped by area.
|
|
- [Screenshots](SCREENSHOTS.md) — a tour of the administration panel.
|
|
- [Performance](PERFORMANCE.md) — benchmark method, comparison with Nginx and tuning.
|
|
|
|
## Getting started
|
|
|
|
- [Installation and updates](INSTALL.md) — packages, source build, Docker image, first administrator, systemd and updates.
|
|
- [Configuration](CONFIGURATION.md) — SQLite or JSON configuration source, configuration map and changes that need a restart.
|
|
- [Troubleshooting](TROUBLESHOOTING.md) — symptom-based checks and a rollout checklist.
|
|
|
|
## Publishing services
|
|
|
|
- [Vhosts and backends](VHOSTS.md) — domains, listeners, backends, balancing, health checks and redirects.
|
|
- [Custom locations](CUSTOM_LOCATIONS.md) — path routing, rewrites, local responses and error fallbacks.
|
|
- [Web Server](WEB_SERVER.md) — static sites, downloads, `try_files`, rewrites, `.htaccess` subset and error pages.
|
|
- [PHP-FPM](PHP_FPM.md) — PHP profiles, pool isolation and application examples.
|
|
- [HTTP transport and TLS](TRANSPORT.md) — HTTPS, HTTP/2, HTTP/3, WebSockets, backend protocols and post-quantum key exchange.
|
|
- [TCP/UDP Streams](STREAMS.md) — non-HTTP forwarding.
|
|
|
|
## Security and access
|
|
|
|
- [Access and authentication](ACCESS.md) — ACLs, countries, rate limits, Basic Auth, Forward Auth and OIDC.
|
|
- [Certificates](CERTIFICATES.md) — PEM import, ACME HTTP-01/DNS-01, external Certbot files and automatic renewal.
|
|
- [Security model](SECURITY.md) — trust boundaries and deployment recommendations.
|
|
|
|
## Performance and delivery
|
|
|
|
- [Cache](CACHE.md) — HOT (memory) and COLD (disk) cache, freshness, `Cache-Status` and invalidation.
|
|
- [Response delivery](RESPONSE_DELIVERY.md) — compression, transformations and response headers.
|
|
|
|
## Operations
|
|
|
|
- [Dashboard](DASHBOARD.md) — Overview cards, layouts, presets and configuration history.
|
|
- [Monitoring](MONITORING.md) — Prometheus exporter, JSON metrics, Grafana and Nagios.
|
|
- [Logs](LOGS.md) — live, stored and error logs.
|
|
- [Backup and recovery](BACKUP.md) — encrypted backups, restore and the Secret Store.
|
|
- [Migration](MIGRATION.md) — upgrades and Nginx Proxy Manager import.
|
|
- [Docker discovery](DOCKER_DISCOVERY.md) — Docker agent and generated Vhosts.
|
|
- [Administration API](API.md) — authentication, tokens, endpoints and configuration sections.
|
|
|
|
## Integrations
|
|
|
|
| Integration | Purpose | Guide |
|
|
|---|---|---|
|
|
| Docker agent | Discover containers on Docker hosts and publish them as Vhosts | [Docker discovery](DOCKER_DISCOVERY.md) |
|
|
| Tinyauth, Authelia, authentik | Forward Auth for selected Vhosts | [Access](ACCESS.md) |
|
|
| OIDC (Authelia, authentik, Pocket ID, others) | Central login across unrelated domains | [Access](ACCESS.md) |
|
|
| ACME / Certbot | Certificates via HTTP-01 or DNS-01 (Cloudflare, OVH, RFC 2136) | [Certificates](CERTIFICATES.md) |
|
|
| Prometheus and Grafana | Metrics scraping and a ready dashboard | [Monitoring](MONITORING.md) |
|
|
| Nagios | Service checks for API, backends, latency and queues | [Monitoring](MONITORING.md) |
|
|
| Nginx Proxy Manager | Import of existing proxy hosts | [Migration](MIGRATION.md) |
|
|
| OPNsense | Certificate deployment from the os-acme-client plugin | `integrations/opnsense-acme/README.md` |
|
|
| MikroTik RouterOS | OCI image build for RouterOS containers | `integrations/routeros-oci-build/README.md` |
|
|
|
|
## Release notes
|
|
|
|
See the [changelog](../CHANGELOG.md).
|