# Web 配置何时生效

> 判断 Web 修改能否实时生效、是否会重启隧道，以及何时必须重启 NPS 或 NPC

---

LLMS 索引： [llms.txt](/llms.txt)

---

NPS 将 Web 管理数据与进程启动配置分开处理。客户端、HTTP(S) 隧道和普通隧道的大多数 Web 修改会直接更新运行时数据，不需要重启整个 NPS。

## 生效范围

| 操作                                             | 生效方式                     | 对现有连接的影响                         |
| ------------------------------------------------ | ---------------------------- | ---------------------------------------- |
| 修改 HTTP(S) 隧道的目标、Host、请求头或 URL 路径 | 保存后供后续请求读取         | 已进入转发的请求不变                     |
| 修改普通隧道                                     | NPS 停止并重新启动该隧道监听 | 新连接使用新配置；应按业务类型验证长连接 |
| 启用/停用隧道                                    | 打开或关闭对应监听           | 停用后不再接受新连接                     |
| 修改客户端限速、认证和访问名单                   | 保存后更新客户端运行数据     | 新请求/后续传输按相应功能执行            |
| 修改 NPC 配置文件创建的隧道                      | 修改 `npc.conf` 后重新连接   | Web 不是这类配置的持久化来源             |
| 修改 `nps.conf` / `npc.conf`                     | 重启对应进程                 | 取决于被重启的进程和隧道                 |

## 推荐操作

1. 修改前记录原值和隧道 ID。
2. 保存后从新的连接验证，不要只观察已有 SSH、WebSocket 或数据库长连接。
3. 涉及监听端口、协议或客户端连接参数时安排维护窗口。
4. 修改 `nps.conf` 后重启 NPS；修改 `npc.conf` 后重启或重连 NPC。

“热更新”不表示所有配置都无损切换。尤其是普通隧道编辑会重新创建监听，启动失败时应检查端口占用、[端口白名单](/extend/feature/port-allowlist.html)和 NPS 日志。

---

反链：

- [使用说明](/server/nps_use.html)