fix：增加不适用的节点部署的情况

2026-06-01 16:23:18 +08:00 · 2026-01-09 02:53:57 +00:00
parent 345a2b0206
commit 9bb74cbd36
5 changed files with 30 additions and 29 deletions
--- a/docs/en/guide/oneclickvirt/oneclickvirt_install.md
+++ b/docs/en/guide/oneclickvirt/oneclickvirt_install.md
@@ -14,6 +14,10 @@ If possible, always use the scripts to install the corresponding environment. Ot

 The controlled end only requires the virtualization environment to be installed. There is no need to install an additional agent for control. Simply ensure SSH login is possible (the SSH login address can be public or internal network, as long as connectivity is unimpeded).

+:::warning
+Managed nodes require the host machine's network interface to be directly bound to a public IP address. Host machines accessing the public network via methods such as port mapping (e.g., Alibaba Cloud VPC) or NAT forwarding are not supported. Host machines providing public network access through full-port NAT or port forwarding cannot serve as node machines.
+:::
+
 ## Panel Side

 Hardware requirements include at least 1G of free memory and 2G of free disk space. Installation can be completed through any of the following methods.
--- a/docs/en/guide/oneclickvirt/oneclickvirt_precheck.md
+++ b/docs/en/guide/oneclickvirt/oneclickvirt_precheck.md
@@ -24,6 +24,10 @@ This control panel has no special environmental dependency requirements. For one

 Frontend static files are deployed through ```nginx``` or ```caddy``` or ```OpenResty```. For non-source code deployment and non-Docker deployment, API path reverse proxy to the backend port is required.

+:::warning
+Managed nodes require the host machine's network interface to be directly bound to a public IP address. Host machines accessing the public network via methods such as port mapping (e.g., Alibaba Cloud VPC) or NAT forwarding are not supported. Host machines providing public network access through full-port NAT or port forwarding cannot serve as node machines.
+:::
+
 ## Platform Features

 - Language internationalization: Frontend supports bilingual display in Chinese and English, defaults to Chinese display, with switchable default system language
--- a/docs/guide/oneclickvirt/oneclickvirt_install.md
+++ b/docs/guide/oneclickvirt/oneclickvirt_install.md
@@ -14,6 +14,10 @@ outline: deep

 受控端只需要安装好虚拟化环境即可，不必额外安装agent进行控制，只要确保SSH能登录即可(SSH登录地址可公网可内网，连通性无问题即可)。

+:::warning
+纳管的节点要求宿主机网卡直接绑定公网 IP。不支持通过类似阿里云 VPC 的端口映射、NAT 转发等方式访问公网的宿主机。使用全端口 NAT 或端口转发方式提供公网访问的宿主机，无法作为节点机器。
+:::
+
 ## 面板端

 硬件上需要至少1G空闲内存和2G空闲硬盘，通过下面任一方式安装完成即可。
--- a/docs/guide/oneclickvirt/oneclickvirt_precheck.md
+++ b/docs/guide/oneclickvirt/oneclickvirt_precheck.md
@@ -9,7 +9,7 @@ outline: deep
 欢迎给项目一个```Star```进行免费的支持-->[https://github.com/oneclickvirt/oneclickvirt](https://github.com/oneclickvirt/oneclickvirt)

 :::warning
-这是一个处于早期开发的项目，可能有各种BUG和不稳定之处，若使用则自行斟酌风险，更新会比较频繁
+这是一个处于早期开发的项目，可能有各种BUG和不稳定之处，若使用则自行斟酌风险，更新会比较频繁，如若使用不了不要强行使用。
 :::

 ## 环境需求
@@ -24,6 +24,10 @@ outline: deep

 前端静态文件通过```nginx```或```caddy```或```OpenResty```之一部署，非源码部署且非Docker部署的需要进行API路径反代到后端端口。

+:::warning
+纳管的节点要求宿主机网卡直接绑定公网 IP。不支持通过类似阿里云 VPC 的端口映射、NAT 转发等方式访问公网的宿主机。使用全端口 NAT 或端口转发方式提供公网访问的宿主机，无法作为节点机器。
+:::
+
 ## 平台特点

 - 语言国际化，前端支持中英双语切换显示，默认使用中文显示，可切换默认的系统语言
--- a/package-lock.json
+++ b/package-lock.json
@@ -158,6 +158,7 @@
      "integrity": "sha512-9rUYcMIBOrCtYiLX49djyzxqdK9Dya/6Z/8sebPn94BekT+KLOpaZCuc6s0Fpfq7nx5J6YY5LIVFQrtioK9u0g==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "@algolia/client-common": "5.25.0",
        "@algolia/requester-browser-xhr": "5.25.0",
@@ -1483,6 +1484,7 @@
      "integrity": "sha512-n73BVorL4HIwKlfJKb4SEzAYkR3Buwfwbh+MYxg2mloFph2fFGV58E90QTzdbfzWrLn4HE5Czx/WTjI8fcHaMg==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "@algolia/client-abtesting": "5.25.0",
        "@algolia/client-analytics": "5.25.0",
@@ -1681,6 +1683,7 @@
      "integrity": "sha512-xx560wGBk7seZ6y933idtjJQc1l+ck+pI3sKvhKozdBV1dRZoKhkW5xoCaFv9tQiX5RH1xfSxjuNu6g+lmN/gw==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "tabbable": "^6.2.0"
      }
@@ -2217,8 +2220,7 @@
      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz",
      "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==",
      "dev": true,
-      "optional": true,
-      "peer": true
+      "optional": true
    },
    "node_modules/unist-util-is": {
      "version": "6.0.0",
@@ -2364,17 +2366,6 @@
        }
      }
    },
-    "node_modules/vitepress/node_modules/@types/node": {
-      "version": "25.0.3",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.3.tgz",
-      "integrity": "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA==",
-      "dev": true,
-      "optional": true,
-      "peer": true,
-      "dependencies": {
-        "undici-types": "~7.16.0"
-      }
-    },
    "node_modules/vitepress/node_modules/@vitejs/plugin-vue": {
      "version": "5.2.4",
      "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-5.2.4.tgz",
@@ -2395,6 +2386,7 @@
      "integrity": "sha512-qO3aKv3HoQC8QKiNSTuUM1l9o/XX3+c+VTgLHbJWHZGeTPVAg2XwazI9UWzoxjIJCGCV2zU60uqMzjeLZuULqA==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "esbuild": "^0.21.3",
        "postcss": "^8.4.43",
@@ -2455,6 +2447,7 @@
      "integrity": "sha512-LbOm50/vZFG6Mhy6KscQYXZMQ0LMCC/y40HDJPPvGFQ+i/lUH+PJHR6C3assgOQiXdl6tAfsXHbXYVBZZu65ew==",
      "dev": true,
      "license": "MIT",
+      "peer": true,
      "dependencies": {
        "@vue/compiler-dom": "3.5.14",
        "@vue/compiler-sfc": "3.5.14",
@@ -2590,6 +2583,7 @@
      "resolved": "https://registry.npmjs.org/@algolia/client-search/-/client-search-5.25.0.tgz",
      "integrity": "sha512-9rUYcMIBOrCtYiLX49djyzxqdK9Dya/6Z/8sebPn94BekT+KLOpaZCuc6s0Fpfq7nx5J6YY5LIVFQrtioK9u0g==",
      "dev": true,
+      "peer": true,
      "requires": {
        "@algolia/client-common": "5.25.0",
        "@algolia/requester-browser-xhr": "5.25.0",
@@ -3372,6 +3366,7 @@
      "resolved": "https://registry.npmjs.org/algoliasearch/-/algoliasearch-5.25.0.tgz",
      "integrity": "sha512-n73BVorL4HIwKlfJKb4SEzAYkR3Buwfwbh+MYxg2mloFph2fFGV58E90QTzdbfzWrLn4HE5Czx/WTjI8fcHaMg==",
      "dev": true,
+      "peer": true,
      "requires": {
        "@algolia/client-abtesting": "5.25.0",
        "@algolia/client-analytics": "5.25.0",
@@ -3508,6 +3503,7 @@
      "resolved": "https://registry.npmjs.org/focus-trap/-/focus-trap-7.6.4.tgz",
      "integrity": "sha512-xx560wGBk7seZ6y933idtjJQc1l+ck+pI3sKvhKozdBV1dRZoKhkW5xoCaFv9tQiX5RH1xfSxjuNu6g+lmN/gw==",
      "dev": true,
+      "peer": true,
      "requires": {
        "tabbable": "^6.2.0"
      }
@@ -3851,12 +3847,10 @@
      "dev": true
    },
    "undici-types": {
-      "version": "7.16.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz",
+      "version": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz",
      "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==",
      "dev": true,
-      "optional": true,
-      "peer": true
+      "optional": true
    },
    "unist-util-is": {
      "version": "6.0.0",
@@ -3952,17 +3946,6 @@
        "vue": "^3.5.13"
      },
      "dependencies": {
-        "@types/node": {
-          "version": "25.0.3",
-          "resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.3.tgz",
-          "integrity": "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA==",
-          "dev": true,
-          "optional": true,
-          "peer": true,
-          "requires": {
-            "undici-types": "~7.16.0"
-          }
-        },
        "@vitejs/plugin-vue": {
          "version": "5.2.4",
          "resolved": "https://registry.npmjs.org/@vitejs/plugin-vue/-/plugin-vue-5.2.4.tgz",
@@ -3975,6 +3958,7 @@
          "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.19.tgz",
          "integrity": "sha512-qO3aKv3HoQC8QKiNSTuUM1l9o/XX3+c+VTgLHbJWHZGeTPVAg2XwazI9UWzoxjIJCGCV2zU60uqMzjeLZuULqA==",
          "dev": true,
+          "peer": true,
          "requires": {
            "esbuild": "^0.21.3",
            "fsevents": "~2.3.3",
@@ -3989,6 +3973,7 @@
      "resolved": "https://registry.npmjs.org/vue/-/vue-3.5.14.tgz",
      "integrity": "sha512-LbOm50/vZFG6Mhy6KscQYXZMQ0LMCC/y40HDJPPvGFQ+i/lUH+PJHR6C3assgOQiXdl6tAfsXHbXYVBZZu65ew==",
      "dev": true,
+      "peer": true,
      "requires": {
        "@vue/compiler-dom": "3.5.14",
        "@vue/compiler-sfc": "3.5.14",