mirror of
https://github.com/NginxProxyManager/nginx-proxy-manager.git
synced 2026-11-20 15:10:05 +00:00
For proxy hosts, redirection hosts, 404 hosts and streams. The request body is validated like a create/update (400 on invalid input), then the host config goes through a dry run with nginx -t. The result says whether nginx accepts the host, with the same humanised error a save would fail with, the state of each custom location and the reachability of the upstream targets, plus warnings (e.g. a certificate that would only be requested on save, or broken configs of other hosts). The dry run has no side effects: the host's file is only written for the test, no meta is patched, no .err file is touched, nginx is not reloaded, and broken files of other hosts are moved aside for the test and put back byte-identical instead of being repaired. A host that doesn't exist yet is rendered under a reserved, non-numeric name whose files are always removed. Needs the create permission, or update when an id is given. As on save, users who aren't admins can't test an advanced config of their own (403 before nginx -t runs; locations without one keep the saved one). Tests are rate limited and the targets they probe count against the per user budget of POST /upstreams/check (lib/upstream/check-budget.js); with the budget used up nginx is still tested and the targets are reported as rate_limited. Unit tests cover the result building and the dry run (an opt-in test, NPM_TEST_NGINX=1, runs it against a real nginx). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
415 lines
9 KiB
JSON
415 lines
9 KiB
JSON
{
|
|
"openapi": "3.1.0",
|
|
"info": {
|
|
"title": "Nginx Proxy Manager API",
|
|
"version": "2.x.x",
|
|
"description": "This is the official API documentation for Nginx Proxy Manager.\n\nMost endpoints require authentication via Bearer Token (JWT). You can generate a token by logging in via the `POST /tokens` endpoint.\n\nFor more information, visit the [Nginx Proxy Manager Documentation](https://nginxproxymanager.com)."
|
|
},
|
|
"servers": [
|
|
{
|
|
"url": "http://127.0.0.1:81/api"
|
|
}
|
|
],
|
|
"components": {
|
|
"securitySchemes": {
|
|
"$ref": "./components/security-schemes.json"
|
|
}
|
|
},
|
|
"tags": [
|
|
{
|
|
"name": "public",
|
|
"description": "Endpoints that do not require authentication"
|
|
},
|
|
{
|
|
"name": "audit-log",
|
|
"description": "Endpoints related to Audit Logs"
|
|
},
|
|
{
|
|
"name": "logs",
|
|
"description": "Endpoints for viewing system, Let's Encrypt and per-host logs"
|
|
},
|
|
{
|
|
"name": "access-lists",
|
|
"description": "Endpoints related to Access Lists"
|
|
},
|
|
{
|
|
"name": "certificates",
|
|
"description": "Endpoints related to Certificates"
|
|
},
|
|
{
|
|
"name": "404-hosts",
|
|
"description": "Endpoints related to 404 Hosts"
|
|
},
|
|
{
|
|
"name": "proxy-hosts",
|
|
"description": "Endpoints related to Proxy Hosts"
|
|
},
|
|
{
|
|
"name": "redirection-hosts",
|
|
"description": "Endpoints related to Redirection Hosts"
|
|
},
|
|
{
|
|
"name": "streams",
|
|
"description": "Endpoints related to Streams"
|
|
},
|
|
{
|
|
"name": "reports",
|
|
"description": "Endpoints for viewing reports"
|
|
},
|
|
{
|
|
"name": "settings",
|
|
"description": "Endpoints for managing application settings"
|
|
},
|
|
{
|
|
"name": "tokens",
|
|
"description": "Endpoints for managing authentication tokens"
|
|
},
|
|
{
|
|
"name": "upstreams",
|
|
"description": "Endpoints for discovering and checking upstream (forward) hosts"
|
|
},
|
|
{
|
|
"name": "users",
|
|
"description": "Endpoints for managing users"
|
|
}
|
|
],
|
|
"paths": {
|
|
"/": {
|
|
"get": {
|
|
"$ref": "./paths/get.json"
|
|
}
|
|
},
|
|
"/audit-log": {
|
|
"get": {
|
|
"$ref": "./paths/audit-log/get.json"
|
|
}
|
|
},
|
|
"/audit-log/{id}": {
|
|
"get": {
|
|
"$ref": "./paths/audit-log/id/get.json"
|
|
}
|
|
},
|
|
"/logs/sources": {
|
|
"get": {
|
|
"$ref": "./paths/logs/sources/get.json"
|
|
}
|
|
},
|
|
"/logs/tail": {
|
|
"get": {
|
|
"$ref": "./paths/logs/tail/get.json"
|
|
}
|
|
},
|
|
"/nginx/access-lists": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/access-lists/get.json"
|
|
},
|
|
"post": {
|
|
"$ref": "./paths/nginx/access-lists/post.json"
|
|
}
|
|
},
|
|
"/nginx/access-lists/{listID}": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/access-lists/listID/get.json"
|
|
},
|
|
"put": {
|
|
"$ref": "./paths/nginx/access-lists/listID/put.json"
|
|
},
|
|
"delete": {
|
|
"$ref": "./paths/nginx/access-lists/listID/delete.json"
|
|
}
|
|
},
|
|
"/nginx/certificates": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/certificates/get.json"
|
|
},
|
|
"post": {
|
|
"$ref": "./paths/nginx/certificates/post.json"
|
|
}
|
|
},
|
|
"/nginx/certificates/dns-providers": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/certificates/dns-providers/get.json"
|
|
}
|
|
},
|
|
"/nginx/certificates/validate": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/certificates/validate/post.json"
|
|
}
|
|
},
|
|
"/nginx/certificates/test-http": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/certificates/test-http/post.json"
|
|
}
|
|
},
|
|
"/nginx/certificates/{certID}": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/certificates/certID/get.json"
|
|
},
|
|
"delete": {
|
|
"$ref": "./paths/nginx/certificates/certID/delete.json"
|
|
}
|
|
},
|
|
"/nginx/certificates/{certID}/download": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/certificates/certID/download/get.json"
|
|
}
|
|
},
|
|
"/nginx/certificates/{certID}/renew": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/certificates/certID/renew/post.json"
|
|
}
|
|
},
|
|
"/nginx/certificates/{certID}/upload": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/certificates/certID/upload/post.json"
|
|
}
|
|
},
|
|
"/nginx/proxy-hosts": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/proxy-hosts/get.json"
|
|
},
|
|
"post": {
|
|
"$ref": "./paths/nginx/proxy-hosts/post.json"
|
|
}
|
|
},
|
|
"/nginx/proxy-hosts/test": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/proxy-hosts/test/post.json"
|
|
}
|
|
},
|
|
"/nginx/proxy-hosts/{hostID}": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/proxy-hosts/hostID/get.json"
|
|
},
|
|
"put": {
|
|
"$ref": "./paths/nginx/proxy-hosts/hostID/put.json"
|
|
},
|
|
"delete": {
|
|
"$ref": "./paths/nginx/proxy-hosts/hostID/delete.json"
|
|
}
|
|
},
|
|
"/nginx/proxy-hosts/{hostID}/enable": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/proxy-hosts/hostID/enable/post.json"
|
|
}
|
|
},
|
|
"/nginx/proxy-hosts/{hostID}/disable": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/proxy-hosts/hostID/disable/post.json"
|
|
}
|
|
},
|
|
"/nginx/redirection-hosts": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/redirection-hosts/get.json"
|
|
},
|
|
"post": {
|
|
"$ref": "./paths/nginx/redirection-hosts/post.json"
|
|
}
|
|
},
|
|
"/nginx/redirection-hosts/test": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/redirection-hosts/test/post.json"
|
|
}
|
|
},
|
|
"/nginx/redirection-hosts/{hostID}": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/redirection-hosts/hostID/get.json"
|
|
},
|
|
"put": {
|
|
"$ref": "./paths/nginx/redirection-hosts/hostID/put.json"
|
|
},
|
|
"delete": {
|
|
"$ref": "./paths/nginx/redirection-hosts/hostID/delete.json"
|
|
}
|
|
},
|
|
"/nginx/redirection-hosts/{hostID}/enable": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/redirection-hosts/hostID/enable/post.json"
|
|
}
|
|
},
|
|
"/nginx/redirection-hosts/{hostID}/disable": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/redirection-hosts/hostID/disable/post.json"
|
|
}
|
|
},
|
|
"/nginx/dead-hosts": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/dead-hosts/get.json"
|
|
},
|
|
"post": {
|
|
"$ref": "./paths/nginx/dead-hosts/post.json"
|
|
}
|
|
},
|
|
"/nginx/dead-hosts/test": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/dead-hosts/test/post.json"
|
|
}
|
|
},
|
|
"/nginx/dead-hosts/{hostID}": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/dead-hosts/hostID/get.json"
|
|
},
|
|
"put": {
|
|
"$ref": "./paths/nginx/dead-hosts/hostID/put.json"
|
|
},
|
|
"delete": {
|
|
"$ref": "./paths/nginx/dead-hosts/hostID/delete.json"
|
|
}
|
|
},
|
|
"/nginx/dead-hosts/{hostID}/enable": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/dead-hosts/hostID/enable/post.json"
|
|
}
|
|
},
|
|
"/nginx/dead-hosts/{hostID}/disable": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/dead-hosts/hostID/disable/post.json"
|
|
}
|
|
},
|
|
"/nginx/streams": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/streams/get.json"
|
|
},
|
|
"post": {
|
|
"$ref": "./paths/nginx/streams/post.json"
|
|
}
|
|
},
|
|
"/nginx/streams/test": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/streams/test/post.json"
|
|
}
|
|
},
|
|
"/nginx/streams/{streamID}": {
|
|
"get": {
|
|
"$ref": "./paths/nginx/streams/streamID/get.json"
|
|
},
|
|
"put": {
|
|
"$ref": "./paths/nginx/streams/streamID/put.json"
|
|
},
|
|
"delete": {
|
|
"$ref": "./paths/nginx/streams/streamID/delete.json"
|
|
}
|
|
},
|
|
"/nginx/streams/{streamID}/enable": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/streams/streamID/enable/post.json"
|
|
}
|
|
},
|
|
"/nginx/streams/{streamID}/disable": {
|
|
"post": {
|
|
"$ref": "./paths/nginx/streams/streamID/disable/post.json"
|
|
}
|
|
},
|
|
"/reports/hosts": {
|
|
"get": {
|
|
"$ref": "./paths/reports/hosts/get.json"
|
|
}
|
|
},
|
|
"/schema": {
|
|
"get": {
|
|
"$ref": "./paths/schema/get.json"
|
|
}
|
|
},
|
|
"/settings": {
|
|
"get": {
|
|
"$ref": "./paths/settings/get.json"
|
|
}
|
|
},
|
|
"/settings/{settingID}": {
|
|
"get": {
|
|
"$ref": "./paths/settings/settingID/get.json"
|
|
},
|
|
"put": {
|
|
"$ref": "./paths/settings/settingID/put.json"
|
|
}
|
|
},
|
|
"/tokens": {
|
|
"get": {
|
|
"$ref": "./paths/tokens/get.json"
|
|
},
|
|
"post": {
|
|
"$ref": "./paths/tokens/post.json"
|
|
}
|
|
},
|
|
"/tokens/2fa": {
|
|
"post": {
|
|
"$ref": "./paths/tokens/2fa/post.json"
|
|
}
|
|
},
|
|
"/upstreams/candidates": {
|
|
"get": {
|
|
"$ref": "./paths/upstreams/candidates/get.json"
|
|
}
|
|
},
|
|
"/upstreams/check": {
|
|
"post": {
|
|
"$ref": "./paths/upstreams/check/post.json"
|
|
}
|
|
},
|
|
"/upstreams/health": {
|
|
"get": {
|
|
"$ref": "./paths/upstreams/health/get.json"
|
|
}
|
|
},
|
|
"/version/check": {
|
|
"get": {
|
|
"$ref": "./paths/version/check/get.json"
|
|
}
|
|
},
|
|
"/users": {
|
|
"get": {
|
|
"$ref": "./paths/users/get.json"
|
|
},
|
|
"post": {
|
|
"$ref": "./paths/users/post.json"
|
|
}
|
|
},
|
|
"/users/{userID}": {
|
|
"get": {
|
|
"$ref": "./paths/users/userID/get.json"
|
|
},
|
|
"put": {
|
|
"$ref": "./paths/users/userID/put.json"
|
|
},
|
|
"delete": {
|
|
"$ref": "./paths/users/userID/delete.json"
|
|
}
|
|
},
|
|
"/users/{userID}/2fa": {
|
|
"post": {
|
|
"$ref": "./paths/users/userID/2fa/post.json"
|
|
},
|
|
"get": {
|
|
"$ref": "./paths/users/userID/2fa/get.json"
|
|
},
|
|
"delete": {
|
|
"$ref": "./paths/users/userID/2fa/delete.json"
|
|
}
|
|
},
|
|
"/users/{userID}/2fa/enable": {
|
|
"post": {
|
|
"$ref": "./paths/users/userID/2fa/enable/post.json"
|
|
}
|
|
},
|
|
"/users/{userID}/2fa/backup-codes": {
|
|
"post": {
|
|
"$ref": "./paths/users/userID/2fa/backup-codes/post.json"
|
|
}
|
|
},
|
|
"/users/{userID}/auth": {
|
|
"put": {
|
|
"$ref": "./paths/users/userID/auth/put.json"
|
|
}
|
|
},
|
|
"/users/{userID}/permissions": {
|
|
"put": {
|
|
"$ref": "./paths/users/userID/permissions/put.json"
|
|
}
|
|
},
|
|
"/users/{userID}/login": {
|
|
"post": {
|
|
"$ref": "./paths/users/userID/login/post.json"
|
|
}
|
|
}
|
|
}
|
|
}
|