mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-11-19 19:45:02 +03:00
docs(nodes): note that updating an mTLS node needs a node-admin token (#6957)
A master that reaches a node over mTLS with no bearer token is treated as node-sync, which cannot call /server/updatePanel, so "Update panel" on such a node fails with HTTP 403. That is intended, but the multi-node guide said the API token is "not needed in mTLS mode" (#6953). The guide (en/fa/ru/zh) and the node form's mTLS hint (all 14 locales) now say that updating the node from the master still needs a token with the node-admin scope. No logic changes. The CI workflow's path filter does not cover internal/web/translation or docs, so only Docs CI ran on this head; the locale-dependent tests were run locally.
This commit is contained in:
@@ -23,7 +23,7 @@ Provide the node's connection details:
|
||||
| **Scheme** | `https` (default) or `http`. |
|
||||
| **Address / Port**| The node panel's host and port. |
|
||||
| **Base path** | The node's web base path. |
|
||||
| **API token** | A Bearer token created on the node (not needed in mTLS mode). |
|
||||
| **API token** | A Bearer token created on the node. Optional in mTLS mode, except for **Update panel** (needs `node-admin`). |
|
||||
| **TLS verify** | `verify` (default), `skip`, `pin` (pin a cert SHA-256), or `mtls`. |
|
||||
| **Inbound sync** | `all` inbounds, or `selected` by tag. |
|
||||
| **Outbound tag** | Optionally reach the node **through** a named outbound (egress bridge).|
|
||||
@@ -64,6 +64,14 @@ next restart.
|
||||
|
||||
Set the node's TLS verify mode to `mtls`. The master now presents a client
|
||||
certificate instead of an API token.
|
||||
|
||||
<Callout type="warn">
|
||||
A node reached over mTLS without a token only has the `node-sync` scope, which
|
||||
cannot run **Update panel** (the node answers HTTP 403, "this API token is not
|
||||
permitted to access this endpoint"). To update such a node from the master,
|
||||
create an API token with the `node-admin` scope on the node and paste it into
|
||||
the master's **API token** field for that node. Keep TLS verify on `mtls`.
|
||||
</Callout>
|
||||
</Step>
|
||||
|
||||
</Steps>
|
||||
|
||||
Reference in New Issue
Block a user