NPSNPS
首页
  • 安装与部署
  • 快速开始
  • 运行命令速查
  • 隧道模式
  • 使用示例
  • 使用说明
  • 配置文件
  • 增强功能
  • Docker 部署
  • 参数与安全速查
  • 使用说明
  • 增强功能
  • 配置与启动
  • 配置文件参考
  • 更新与远程升级
  • SDK
  • 功能概览
  • 域名代理与路由
  • 平台域名与证书诊断
  • 访问控制与配额
  • 运行说明
  • 配置示例
  • 对外 API v1
  • API 鉴权与兼容
  • 历史 Web API
  • 用户体系
  • FAQ
  • 升级迁移
  • 功能与兼容矩阵
  • 本项目更新日志
  • 上游更新日志
GitHub
首页
  • 安装与部署
  • 快速开始
  • 运行命令速查
  • 隧道模式
  • 使用示例
  • 使用说明
  • 配置文件
  • 增强功能
  • Docker 部署
  • 参数与安全速查
  • 使用说明
  • 增强功能
  • 配置与启动
  • 配置文件参考
  • 更新与远程升级
  • SDK
  • 功能概览
  • 域名代理与路由
  • 平台域名与证书诊断
  • 访问控制与配额
  • 运行说明
  • 配置示例
  • 对外 API v1
  • API 鉴权与兼容
  • 历史 Web API
  • 用户体系
  • FAQ
  • 升级迁移
  • 功能与兼容矩阵
  • 本项目更新日志
  • 上游更新日志
GitHub
  • 文档首页
  • 快速上手

    • 安装与部署
    • 快速开始
    • 运行命令速查
    • 完整部署参考
    • 隧道模式
    • 使用示例
  • 服务端

    • 服务端使用
    • 使用说明页面配置
    • 配置文件参考
    • 服务端增强功能
    • 服务端介绍
    • 部署安全与参数速查
    • Docker 部署
    • 宝塔面板部署
  • 客户端

    • 客户端使用
    • 客户端增强功能
    • NPC SDK
    • 客户端配置与启动
    • 配置文件参考
    • NPC Docker 部署
    • 飞牛 fnOS 原生包
    • NPC GUI 客户端
    • 客户端更新与远程升级
  • 扩展功能

    • 功能概览
    • 域名代理与路由
    • 平台域名与证书诊断
    • 访问控制与配额
    • 运行说明
    • 对外 API v1
    • API 鉴权与兼容
    • 历史 Web API
    • 使用示例
  • 项目与社区

    • 用户体系
    • 系统架构
    • 升级迁移
    • 功能与兼容矩阵
    • 构建发布
    • 本项目更新日志
    • 上游更新日志
    • FAQ
    • 贡献
    • 交流
    • 捐助
    • 致谢

NPS 1.1.30 升级说明

本文说明从 1.1.29 或更早版本升级到 1.1.30 时,NPC 网络配置的行为变化和兼容边界。

本版本变化

  • dns_server 现在会真正应用到 NPS/NPC 的域名解析和需要解析目标地址的路径;多个服务器以逗号分隔,按轮询顺序尝试,失败时切换到下一个。未配置时继续使用操作系统解析器。
  • proxy_url、-proxy 支持 HTTP/HTTPS CONNECT、SOCKS4、SOCKS4a、SOCKS5 和 SOCKS5H。未填写显式代理时,NPC 会读取 ALL_PROXY/all_proxy,并使用 NO_PROXY/no_proxy 绕过匹配地址。
  • local_ip 现在会绑定 NPC 对 NPS 的 TCP、KCP、QUIC、WS/WSS 出站连接;启用 local_ip_forward=true 后,还会绑定转发到公网 IP/域名目标的 TCP、UDP 和 SOCKS5 UDP 出口。私网目标保持原来的系统路由,避免误改变内网访问路径。
  • 显式设置本地地址时,QUIC/KCP 会使用独立 UDP socket,并在会话结束时回收;未设置时保持旧的默认拨号路径。

对旧部署的影响

  • 不新增服务端端口,不改变 nps.conf 的默认值,也不要求现有 NPC 立即升级。服务端仍按 1.1.28/1.1.29 兼容边界处理握手和控制消息。
  • 现有 npc.conf 中的 proxy_url、local_ip、local_ip_forward 和 dns_server 会自动被新客户端识别;不填写的字段不会改变旧行为。
  • local_ip_forward 默认关闭。只有明确开启后才会影响转发出口,且仅对公网 IP 或域名目标生效。
  • proxy_url 使用 HTTPS 代理时,NPC 会校验代理证书;自签名代理应通过系统信任链处理,不要通过关闭 TLS 校验规避问题。
  • 如果设备不允许服务端下发升级,可在直接启动参数中设置 -disable_remote_update=true;配置文件模式继续使用 [common] 下的同名字段。

配置示例

[common]
server_addr=nps.example.com:8024
vkey=replace-with-verify-key
conn_type=tcp

# 可选:多个 DNS 服务器,逗号分隔
dns_server=1.1.1.1,8.8.8.8

# 可选:NPC 对外连接使用的本地地址
local_ip=192.168.14.20

# 可选:将同一个地址用于公网目标的转发出口
local_ip_forward=true

# 可选:HTTP、HTTPS、SOCKS4/4a/5 代理
proxy_url=socks5h://user:password@127.0.0.1:1080

命令行模式等价参数:

./npc -server=nps.example.com:8024 -vkey=<VerifyKey> \
  -dns_server=1.1.1.1,8.8.8.8 \
  -local_ip=192.168.14.20 -local_ip_forward=true \
  -proxy=socks5h://user:password@127.0.0.1:1080

升级与回滚

  1. 先备份 NPS 的 conf/ 目录和 NPC 配置文件。
  2. 直接替换 NPC 二进制;服务端不需要因本版本变更而停机。
  3. 如使用系统服务,按原服务名重启 NPC,并检查日志中的 DNS、代理和本地出口配置提示。
  4. 如果新配置不适合当前网络,删除新增字段或设置 local_ip_forward=false,即可回到旧版默认路径;不需要恢复服务端 JSON 数据。

需要重新安装同版本正式包时,可执行 ./npc update-force;普通升级仍使用 ./npc update。

1.1.30 已正式发布。升级到 1.1.31 请参考 1.1.31 本地升级说明。

在 GitHub 上编辑此页
最后更新: 2026/10/26 00:03