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.32 升级说明

本文说明从 1.1.31 或更早版本升级到 1.1.32 时的兼容边界。1.1.32 只新增对外 API,不改变 NPS/NPC 通信协议、持久化格式或现有 Web 管理接口。

本版本变化

  • 新增统一对外 API /api/v1,覆盖概览、客户端、隧道、域名反代、用户、全局配置、Geo、登录保护、IP 登记、审计、状态与资源拓扑。
  • /api/v1 使用 status、code、msg、request_id 统一信封;失败响应额外包含 error_code。
  • 管理员继续使用 auth_key + timestamp 签名,也可以使用网页管理密钥;普通用户使用 Authorization: Bearer npsu_...。
  • 写接口支持 application/json,并继续兼容表单与查询参数。列表默认每页 20 条,最大 500 条,支持 offset/limit 和 page/page_size。
  • /api/v1 不接受浏览器 Session。普通用户 Token 仍按授权客户端过滤资源,用户管理、全局配置、审计等管理资源只允许管理员凭据。

完整端点和示例见对外 API v1。

兼容性

  • 无新增 nps.conf 字段,无配置迁移。
  • 无数据库或 JSON 数据格式变更;现有 clients.json、users.json、tasks.json、hosts.json 和 global.json 可直接使用。
  • NPS 与 NPC 的 Bridge 握手、控制消息和数据协议不变。NPS 与 NPC 不需要为了 /api/v1 同步升级,现有在线客户端不会断开或降级。
  • 旧 /auth/*、/client/*、/index/*、/user/*、/global/* 的路径、参数和返回格式保持不变,现有 Web 页面、NPC 与其他集成无需修改。
  • 开发期间短暂出现的 /v1/auth/* 没有进入任何正式 Release,已在 1.1.32 开发阶段移除。正式 1.1.31 不包含该路径,因此已发布用户没有迁移或兼容负担。

二进制部署

  1. 按既有流程备份 conf 目录。
  2. 停止 NPS,替换 nps 二进制后重新启动。
  3. 使用旧接口和新接口各执行一次只读请求,确认鉴权与资源范围符合预期。

无需修改现有配置文件。如果 NPC 当前连接稳定,不必仅为本次升级重启 NPC。

Docker 部署

docker pull wushuo98/nps:1.1.32
docker compose up -d
docker logs nps --tail=100

也可以继续使用 wushuo98/nps:latest,但生产环境建议固定版本号,升级时明确执行 docker pull 并重建容器。

验证与回滚

推荐验证:

curl -i http://127.0.0.1:8081/api/v1
curl -i http://127.0.0.1:8081/api/v1/time
curl -i -X POST http://127.0.0.1:8081/auth/gettime

预期 /api/v1 与 /api/v1/time 返回统一信封,旧 /auth/gettime 继续返回历史格式。验证普通用户 Token 时,只能访问该用户获授权的客户端、隧道、Host 和统计资源。

如需回滚,恢复 1.1.31 二进制和备份配置即可。1.1.32 没有修改持久化数据,旧版本不会因数据格式无法读取而受影响。

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