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
    • 贡献
    • 交流
    • 捐助
    • 致谢

更新日志

v1.1.47 (2026-11-17)

  • 修复飞牛纯连接模式(仅 [common]、无本地隧道规则)断线后不自动重连:子进程改为按 auto_reconnection 退出交由管理进程按 5 秒重建,或保持等待配置变更。
  • 飞牛内嵌设置页日志视图改为最新在前显示。

v1.1.46 (2026-11-17)

  • 新增飞牛 fnOS 原生 NPC 客户端 FPK 包(NPC-Pro):不监听网络端口、不暴露公网 Web,设置页通过飞牛统一网关挂载,后端仅监听本地 Unix Socket 并复用飞牛登录态。
  • 内嵌设置页支持连接列表、快捷指令/手动配置二选一、直接编辑 npc.conf 并校验后原子写入、查看并清空最近最多 500 条日志;保存后运行中 NPC 自动热重载。
  • 支持同一台飞牛连接多个不同 VKey,每条连接独立 npc.conf 并由独立子进程运行;首次安装释放完整配置模板,升级 FPK 保留设备 etc 中的配置与注释。
  • 服务端配置保存支持部分运行时参数即时生效(允许端口、注册/登录/VKey 开关、验证码、限速/配额开关、连接历史保留数、流量落盘间隔、审计/连接日志路径等),其余监听端口、TLS、日志适配器等仍需重启。
  • 面板版本检查改为服务端每 6 小时统一查询并缓存;删除最后一个客户端/隧道/Host 后回收持久化 ID;新增流量计数器重置并同步清理速率基线。
  • 飞牛 FPK 与 Docker 客户端不接受服务端远程自更新;旧 NPC、Bridge 和业务 JSON 无需迁移,见 1.1.46 升级说明。

v1.1.45 (2026-11-16)

  • 独立账号兼容用户名与绑定邮箱登录;修复 VKey 登录开关和“用户名 + VKey”登录,VKey 会话仍只管理对应客户端。
  • 开放注册时提供邮件找回密码,复用 SMTP 并增加独立验证码、限频和异步发送;重置成功撤销旧网页会话及免登凭证,不影响 API Token 或 NPC。
  • 修复审计首次加载卡住;页面只查询当前文件最近 2000 条,管理员可按保留天数手动清理,既有历史查询 API 范围不变。
  • 修复用户用量趋势范围标识和旧历史兼容;启动及采样时自动清理过期历史,回收已删除资源的空记录,保留仍配置的离线资源累计量并串行写盘。
  • 使用说明嵌入窗口铺满可用内容区;修复改密码时丢失邮箱、连接数和带宽设置。旧 NPC、Bridge 和业务 JSON 无需迁移,见 1.1.45 升级说明。

v1.1.44 (2026-11-10)

  • 完善登录请求大小、PoW、图片验证码、请求过期、限频、密码及 TOTP 失败审计,记录免登签发/恢复和退出,注册前置验证失败也统一落盘。
  • 新增请求 ID、无查询串路径、方法、浏览器、直连地址、来源 IP 识别依据、认证方式、校验阶段及错误代码;普通用户只能查看已验证身份归属的记录,匿名失败仅管理员可见。
  • 审计与连接页铺满内容区,表头固定,动作/资源显示中英文名称,提供诊断列、日志状态及原始 JSON 复制;保留历史 JSONL 与 API 动作代码,旧 NPC 无需升级。
  • Docker 日志挂载、文件权限及归档说明见 1.1.44 升级说明。

v1.1.43 (2026-11-10)

  • 手机登录、注册和 IP 登记改为紧凑品牌条与单列表单,修复页脚挤压、验证码换行和 IPv6 省略;适配横屏、安全区、明暗主题和中英文,保留桌面磨砂参数及邮箱、TOTP、PoW、免登录功能。
  • 隧道、域名规则的客户端选择框统一展示备注、ID、所属用户及在线气泡;支持键盘与必填校验,加载失败不丢失编辑页的原客户端绑定。
  • 客户端累计入口/出口流量合为上下两行一列,实时带宽使用相同样式,表头补齐方向、单位和入口排序提示;客户端名称可编辑但数字 ID、VKey 和连接保持不变。
  • 浏览器端优先 ip258 中文省市区,GeoJS 备用,支持 IPv4/IPv6、4 秒超时、最多四个并发查询、去重与缓存;内网不外查,国家旗帜随程序本地打包。
  • 一并发布账户管理页面布局优化,以及 NPC CLI、GUI、系统服务跨平台升级替换、权限保持、重启恢复、失败回滚和服务端上线确认修复。
  • 旧 NPC 与既有配置、业务 JSON、快捷命令和 API 兼容;客户端若需要使用新的升级恢复逻辑,应升级相应 NPC,旧更新器失败时需手动更新一次。详见 1.1.43 升级说明。

v1.1.42 (2026-11-06)

  • 新增 3 天免登设备登记,服务端在 conf/web_sessions.json 保存设备、浏览器、系统、IP、创建/最近活动/到期时间和会话代次。账号可在「账户管理」查看并单独撤销设备,或“退出所有设备”。
  • 管理员可在「账户管理」直接绑定、替换或关闭 TOTP。操作需要登录密码和认证器动态验证码,保存后立即生效,并使旧管理员网页会话失效。
  • 「全局参数」新增「安全」Tab,集中维护登录 PoW 开关和难度;登录页补充 Web Worker、Web Crypto、非 HTTPS 环境提示。
  • 「API 接入」统一更名为「账户管理」,同页提供用户 Token、管理员密钥、TOTP、登录设备和免登凭证。
  • 修复默认不限连接数的 TCP 隧道未累加运行时连接数、列表和资源拓扑始终显示“当前连接 0”的问题;现在始终统计活动连接,只有配置上限后才拒绝超额连接。
  • 修复固定顶栏额外内边距、页面标题与顶栏重叠、全局参数五页签换行;所有页面标题、状态和说明统一进入固定顶栏,页面操作按钮保留在内容区一次。
  • 修复登录、注册、验证码、PoW、请求大小、限频和邮件验证错误提示的中英文一致性;登录、注册和 IP 登记页面统一网络背景及明暗主题。
  • Bridge 握手、NPC 版本、快捷命令、JSON 业务数据和既有 /api/v1 字段保持不变,旧 NPC 无需同步升级。

v1.1.41 (2026-11-06)

  • 同一 VKey 支持多个 NPC 在线实例,客户端详情展示实例 ID、主机名、系统、架构、局域网地址、Bridge 协议和连接时间,并可单独断开;新增 /api/v1/clients/{id}/instances 接口。
  • 新增分钟/五分钟历史用量采集、conf/usage_history.json 持久化、仪表盘 24 小时/7 天/30 天趋势图和 GET /api/v1/status/history。管理员可查授权范围内的全局、用户、客户端、隧道和域名规则,普通用户只能查询自身资源;P2P 不计入。
  • HTTP(S) 域名代理完整维护 X-Forwarded-Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto、X-Real-Proto 和 X-Forwarded-Port,并支持覆盖、保留追加和可信代理策略。
  • 增加客户端上传/响应总时长与停滞超时、后端连接/TLS/响应头/上传/读取超时,以及可选的安全隔离后端连接池;SSE、gRPC、WebSocket 和 multipart 流式响应豁免正文总时长。
  • Bridge TLS 证书在文件替换或页面保存后自动热加载,无效的新文件继续使用最近有效证书;已有 TLS 连接不会被主动断开。
  • 修复大屏快捷地址复用、打开按钮文字和 NPC 更新/系统服务路径;Windows 更新后服务不再继续启动旧桌面二进制。
  • 旧版 NPC、历史快捷命令、JSON 数据和既有 /api/v1 字段继续兼容;新增实例信息和局域网地址需要 NPC 1.1.41 及以上。

v1.1.40 (2026-11-02)

  • NPC 配置创建的运行时客户端、隧道和域名反代改用独立临时 ID,不再消耗持久化 JSON 的自增序列;同一客户端的多个运行时 Host/隧道可并行存在。
  • 客户端、隧道、域名反代和用户列表增加实时上行/下行带宽与连接指标排序,排序前使用统一快照,避免比较过程中重复读取实时状态。
  • 所有列表分页统一为 20、50、100、200 条,并保留用户的分页选择;Host 列表现在完整传递服务端排序参数。
  • 保持 Bridge 协议、快捷命令、JSON 持久化格式和 /api/v1 既有字段不变,旧 NPC 与现有配置无需迁移。

v1.1.39 (2026-10-30)

  • 用户管理和客户端列表改为用户名主行、备注次行显示,客户端备注和出口地址采用单行省略并保留完整悬浮提示,客户端备注与所属用户内容统一居中;管理员用户/客户端筛选统一使用「备注(账号)」和「客户端备注(ID)」,隧道与域名规则列表支持用户到客户端的联动筛选,同时保留单独筛选。
  • 客户端列表默认显示入口、出口流量,表头拆分显示公网到内网、内网到公网方向;域名反代自定义域名增加独立来源标签,入口按钮改为保留外链图标的“HTTP / HTTPS”;客户端列按“客户端备注 · ID”“所属用户备注 · ID”两行展示,超长内容自动省略并可悬浮查看全文。
  • 隧道列表的目标地址按 IP/端口分行展示,只有端口时仅显示端口;访问地址不再整行跳转,提供复制和 TCP HTTP 尝试按钮;TCP 当前连接列默认收起,仍可通过列表列设置和展开详情查看。

v1.1.38 (2026-10-29)

  • 完善审计与连接页面:客户端连接日志记录 Bridge 主连接、子通道、早期握手/版本/连接类型失败、隧道和域名代理会话的详细来源与服务端地址,并尽可能展示客户端版本、公网/内网地址、内网地址来源、用户与客户端状态、到期时间和失败阶段;管理操作审计和连接日志的展开详情统一为紧凑的终端式原始 JSON 视图。认证失败不会伪造本次内网地址,只显示可确认的历史上报值及其来源。
  • 统一所有列表页工具栏:资源操作保留在左侧,右侧固定按“搜索、筛选、列、刷新”从左到右排列;登录封禁和 IP 登记迁移到公共表格组件,域名反代补充列显示菜单,并修复窄桌面宽度下刷新按钮换行。
  • 登录封禁列表新增关键词搜索、封禁类型和状态筛选及分页;服务端配置分类保存只校验当前页面负责的字段,修复证书、用户注册等专项配置阻塞通用页保存的问题。
  • 服务端配置可视化页的字段卡片改为 3/4 列响应式网格,密码查看按钮保持单行。不改变 Bridge 协议、nps.conf 语义、JSON 持久化格式或 /api/v1 既有字段,NPS 与 NPC 无需同步升级。

v1.1.37 (2026-10-29)

  • 新增 TCP、TCP + TLS、KCP、WS、WSS、QUIC 和 HTTP/3 共用入口的多 Bridge 命令展示,并引入兼容历史 v1 的 v2 快捷命令;NPC CLI、GUI 和系统服务完整支持协议、Path、ALPN、SNI 与证书指纹。
  • 新增「证书设置」页面,集中维护 Bridge 证书、平台泛域名、HTTPS/ACME、管理面板 HTTPS 和 IP 登记 HTTPS,并显示配置证书与运行证书状态。
  • 自定义域名的证书录入收敛为“上传”和“粘贴”;历史路径证书只读兼容并继续生效,平台泛域名与 Bridge 证书仍由管理员使用路径、上传或粘贴维护。
  • 自定义证书必须先校验有效性、私钥匹配和域名覆盖才能保存,保存后持续显示证书来源、文件名、有效期、SAN、主题、颁发者和指纹等详情。
  • 新增用户级最大并发连接数、共享上行带宽和共享下行带宽;同一用户全部客户端使用一组额度,0 表示不限,P2P 直连不计入。
  • 「全局参数」新增「用户注册」Tab,集中维护注册入口、新账号默认权益、注册限频、邮箱验证和 SMTP;新注册默认值全部为不限制/永久有效。
  • 管理员 POST /api/v1/users/register 支持显式覆盖 max_conn、upload_limit、download_limit,省略时读取对应注册默认值。
  • 修复用户连接额度达到上限后仍继续放行的问题;并发额度按用户原子共享。
  • 彻底移除旧版 IP 授权页面、代理链路、客户端模型字段和 /auth/ipwhiteauth、/api/v1/ipwhiteauth 接口,只保留新版“仅允许已登记 IP”机制。
  • 新增公开接口 POST /api/v1/ip-register;登记密钥只从 JSON 或表单请求体读取,访问 IP 由服务端按可信代理配置识别,客户端不能自行提交 IP。
  • 修复域名反代新增和编辑页上传、粘贴证书时前端提交字段与后端读取字段不一致的问题;现可正常写入 conf/certs/host_<ID>.pem/.key。平台泛域名页面也会明确提示:未被主机引用时可更名或删除,已被引用时仅锁定名称,证书仍可更新。
  • /api/v1/hosts 的新增、修改接口与 Web 表单统一证书规则:自定义域名只接受上传或粘贴,拒绝新服务器路径;历史路径仅可原样保留,查询不返回证书和私钥路径。
  • 修复同一 VKey 的不同协议会话互相覆盖、HTTP/3 错误复用浏览器证书、无效 HTTP/3 入口仍生成命令以及退出活动连接计数等问题。

v1.1.36 (2026-10-29)

  • 自助注册改为创建独立用户并写入 users.json,支持后台配置默认客户端数、默认隧道数和默认有效天数;0 继续表示不限制,有效期 0 表示永久。
  • 注册支持图片验证码、独立提交限频、单 IP 成功注册上限,以及可选的 SMTP 邮箱一次性验证码。
  • 新增管理员 API POST /api/v1/users/register,可显式指定配额、expire_days 或绝对 expire_time;JSON 请求与查询参数中的管理员签名可同时使用。
  • 用户邮箱不区分大小写且全局唯一;用户名、邮箱唯一性校验与写入已纳入同一互斥事务,避免并发注册产生重复账号。
  • 注册页默认配额按实际配置值展示,仅在客户端或隧道配额为 0 时标注“不限”,避免非零配额被误解。
  • 重构服务端配置页,增加配置摘要、字段搜索、分组展开和完整源码视图;修复私钥路径被误隐藏及 auth_crypt_key、ZeroSSL API 密钥等敏感项未使用密码控件的问题。源码保存支持语法校验、关键配置关系校验和并发修订冲突检测。
  • 普通用户可打开「IP 登记」菜单,并管理自己客户端下的登记;管理员继续管理全部客户端和公共登记桶,后端按实时归属执行隔离。
  • 新增可配置的「使用说明」页面:支持远程 URL、conf 下的 HTML 文件或直接粘贴 HTML;粘贴内容自动写入 conf/qa.html,文件缺失时页面仍可正常打开。
  • 全局参数页按功能重新分组,服务端配置 Tab 补充图标;IP 登记、帮助文件读取和普通用户越权操作均增加回归测试。
  • GeoIP/Geosite 路径留空时默认加载运行目录 conf 下的数据文件,文件出现或更新后自动重新加载。
  • 不改变 Bridge 协议、现有 Web 接口或 /api/v1 调用;现有 users.json 无需迁移,NPS 与 NPC 无需同步升级。

v1.1.35 (2026-10-28)

  • 修复普通用户访问 /user/api 时页面白屏的问题。普通用户现在可以打开 API 接入页并管理个人 Token,包括再次查看和撤销;用户管理、全局参数和管理员 API 密钥接口仍仅限管理员访问。
  • 新增普通用户页面访问与动作白名单回归测试,避免后续权限调整再次导致 API 接入页不可用或越权开放管理页面。
  • README 中英文首页新增登录页、IP 登记页、客户端编辑页和域名反代编辑页截图。
  • 不改变 JSON 持久化格式、nps.conf、Bridge 协议或 /api/v1;管理员行为保持不变,NPS 与 NPC 无需同步升级。

v1.1.34 (2026-10-26)

  • 域名反代列表去掉「认证」列,改在访问入口前显示 Basic 认证锁图标(规则级或客户端级配置即点亮);列表接口只返回认证状态,不回传用户名密码。
  • 域名反代与 TCP 隧道的展开详情统一为紧凑卡片布局,IP 名单以标签展示,长目标与 Header 使用代码块,Basic 密码只显示「已设置/未设置」。
  • 全局参数「平台泛域名」输入区改为单列排版并限制输入宽度,证书路径、证书状态与到期信息不再拥挤。
  • 修复域名反代新增/编辑页健康检查目标为空时保存被浏览器表单校验拦截的问题;未启用健康检查时相关字段自动禁用并填充默认值。

v1.1.33 (2026-10-26)

  • 管理面板删除客户端时,NPS 会在断开前向在线的 NPC 下发「注册已删除」指令;新版 NPC 收到后关闭该客户端的控制连接与数据通道并停止重连,不再每 5 秒空转重试。旧版 NPC 忽略该指令,保持原有重连行为,兼容不变。
  • 停用、到期和用户禁用仍使用普通断开方式,NPC 在状态恢复后可继续自动重连。
  • NPC 以系统服务运行时收到删除指令,只停止被删除的那条连接;当该服务进程内的最后一条连接也因删除而结束时,才会自动停止本机 NPC 服务,但保留服务注册(Windows、Linux systemd/sysv/upstart、macOS launchd 等均处理),之后仍可用 npc 命令手动启动或停止。同一进程同时连接多个服务端时,删除其一不会影响其他连接。停止是尽力而为的后台动作,失败也不会阻塞 Web 端删除。
  • 修复 NPC 数据通道(MUX)关闭时因查询 socket 缓冲大小把连接切到阻塞模式,导致连接迟迟无法真正断开、文件描述符泄漏的问题;现在删除客户端后数据通道会立即完整释放。
  • NPS/NPC Docker 镜像补齐 CA 证书,修复 Geo 数据在线更新与版本检测报 x509: certificate signed by unknown authority 的问题。
  • 「API 接入」页面的文档链接改为官方文档站 https://zidunet.github.io/nps/api.html,并修复管理员生成密钥按钮请求错误路径的问题。
  • 登录页、管理面板主布局和错误页统一显示浏览器标签页图标(favicon)。

v1.1.32 (2026-10-26)

  • 新增统一对外 API /api/v1:覆盖客户端、隧道、域名反代、用户、全局参数、Geo、登录保护、IP 登记、审计、状态与拓扑,全部返回 status/code/msg/error_code/request_id 信封。
  • /api/v1 只接受 API 凭据(管理员 auth_key+timestamp 或普通用户 Bearer npsu_...),不依赖浏览器 Session;普通用户资源继续按授权客户端过滤。
  • 新增公开的 /api/v1/time、/api/v1/authkey、/api/v1/ipwhiteauth 与发现接口 /api/v1;旧 /api/v1/ipwhiteauth 已在后续版本删除,现使用 /api/v1/ip-register。
  • 认证辅助接口统一收口到 /api/v1;未进入正式发布的 /v1/auth/* 已移除,旧 /auth/* 保持不变。
  • 对外 API 支持 application/json 请求体,默认分页 limit=20、最大 500,支持 page/page_size。
  • 旧 /client/*、/index/*、/user/*、/global/*、/auth/* 路径和返回格式保持不变,现有 NPC 与页面无需调整。

v1.1.31 (2026-10-26)

  • 移除管理面板的全局同源/Origin 校验:反代、混合 HTTP/HTTPS 和多端口部署不再出现「invalid request origin」误拦,POST 仅校验请求方法与登录/API 凭据。
  • GetClient、GetOneTunnel、GetHost 单个查询接口同时返回旧 code/data 与标准 status/msg 字段;新增/复制隧道成功响应直接携带 AccessHost、AccessAddr、AccessURL 等访问地址,无需再回查列表。
  • addhost 失败提示补齐标点,错误信息直接说明域名前缀冲突原因。
  • Secret/P2P 的 target_type(tcp、udp、all)升级为真实转发能力;UDP 使用数据报帧协议保留报文边界,旧记录与旧客户端继续按 TCP 兼容。
  • NPC 访客新增 -fallback_secret(默认开启),P2P 直连失败后自动回退 Secret 中继。
  • 普通隧道新增隧道级最大连接数和总流量配额,0 表示不限,支持 Web 表单与 API。
  • 域名反代证书统一支持路径、上传、粘贴三种录入方式并提供有效性校验,平台泛域名与自定义域名行为一致。
  • 新增「系统 → API 接入」页面:Token 可再次查看和撤销;管理员拥有 nps.conf 密钥与网页密钥两套等价凭据,查看原文需验证登录密码。
  • 全局参数支持查看 Geo 数据状态并在线更新,默认使用 conf/geoip.dat 和 conf/geosite.dat。
  • 仪表盘补齐 Bridge 各入口端口、P2P 地址、IPv4/IPv6 出口地址、已登记 IP 数和最小安全握手版本等配置信息,并按卡片分组。
  • 普通用户可设置自己名下客户端的独立到期时间,仍受所属用户有效期约束。
  • 客户端版本号改为可点击入口,弹窗检测最新版本并下发远程升级。
  • 管理面板移除 ZUI 并全面迁移 Bootstrap 5.3.3;表单按业务分组、高级项收起、字段联动,列表详情紧凑多列展示,工具栏与操作交互统一,减少整页刷新。
  • 公共 vkey 注册生成 16 字符验证密钥,修复配置文件模式注册卡死;quic-go 升级至 v0.64.1,修复 Go 1.26 下 P2P 直连 QUIC 握手 panic。

v1.1.30 (2026-10-25)

  • NPS/NPC 配置文件和命令行支持自定义 DNS;多个 DNS 服务器会轮询并在失败时切换,未配置时保持系统解析器。
  • NPC 出站 Bridge 代理支持 HTTP/HTTPS CONNECT、SOCKS4/4a、SOCKS5/SOCKS5H,以及 ALL_PROXY/NO_PROXY 环境变量。
  • local_ip 与 local_ip_forward 现在实际作用于 TCP、UDP、SOCKS5 UDP、KCP、QUIC 和 P2P 相关出站连接;私网目标仍保持默认路由。
  • 补齐 NPC Docker/配置文件说明,并继续兼容旧客户端与旧配置。
  • NPC 命令行支持同时连接多个 NPS 服务端,配置文件模式支持多份配置并行运行;管理员可查看、解封和清理登录保护记录。
  • 直接启动的 NPC 可用 -disable_remote_update=true 忽略服务端升级指令,并新增 npc update-force 重新安装同版本正式包。
  • SOCKS5 UDP ASSOCIATE 使用共享 UDP 端口和会话注册,支持多来源绑定、队列保护、空闲/断线回收、目标 ACL 与大报文转发。
  • 隧道列表把配置、监听、客户端状态合并为一组紧凑状态标记,表头支持悬浮显示完整名称,窄屏使用卡片布局避免横向滚动。

v1.1.29 (2026-10-24)

  • HTTP 正向代理与 SOCKS5 在 Web 面板统一为混合代理;旧 HTTP/SOCKS 规则继续兼容,编辑时可迁移为混合代理。
  • 新增按功能分组的服务端配置页,可维护 nps.conf、脱敏敏感字段、关闭可选键并在保存后提示重启。
  • 补齐 WebSocket/WSS、QUIC、IP 登记和日志轮转配置;升级不会重新添加已关闭的可选配置。
  • 新增 Web 隧道与域名规则的后端健康检查配置,支持 HTTP 200/TCP、超时、失败次数、检查间隔和 HTTP 路径。
  • 服务端按客户端下发健康检查配置;仅兼容新控制消息的 NPC 会接收,旧版 NPC 保持原有协议和本地 [health_*] 配置不变。
  • 新增健康配置的原子校验、持久化、资源启停/迁移后的实时刷新,以及多资源重复目标去重。
  • TCP/Host 接口继续返回访问地址和端口信息;编辑页面补齐健康检查字段,配置文件模式兼容旧字段。
  • 普通隧道和 Host 规则支持独立的 upload_limit / download_limit,列表和 API 返回当前方向速率;旧数据缺少字段时按不限速处理。
  • NPC 配置模板和迁移文档补充规则级限速字段,升级不会覆盖既有配置值。

v1.1.28 (2026-10-22)

  • 客户端列表展开详情安全显示 Basic 认证用户名和旧版客户端用户名;密码只显示是否已设置,不返回明文。
  • 域名解析新增“跨域与兼容”开关说明,明确自动 CORS、兼容模式、OPTIONS 预检和 WebSocket 的实际行为。
  • 域名解析新增和编辑页面统一展示两个开关的独立说明。

v1.1.27 (2026-10-22)

  • 修复 NPC 系统服务日志权限过严导致普通用户无法读取的问题;日志文件与轮转文件统一为 0644,并改进旧日志权限错误提示。
  • 修复 GUI-NPC 收到服务端升级指令时没有升级处理器的问题,补齐下载校验、替换和自动重启流程。
  • NPC 手动更新与远程更新增加互斥,复用 Release 元数据请求,减少 GitHub API 限流风险。
  • 客户端列表升级按钮放入常驻操作列;同步补齐 NPC 日志、批量重启与更新文档。

v1.1.26 (2026-10-22)

  • 恢复 v1.1.24 的产品功能基线,并保留客户端远程升级、连接日志分类和普通用户删除自有客户端等能力。
  • 恢复 v1.1.23 发布流水线:master 推送触发 CI、文档和 Docker 测试构建;正式标签触发跨平台 Release 和版本号镜像构建。

v1.1.25 (2026-10-22)

  • 日常推送不再自动触发流水线;正式版本标签统一触发 CI、文档部署和 Release。
  • 正式 Release 的 Docker 多架构构建同时推送版本号标签和 latest,不再需要额外的镜像晋升任务。
  • Release 页面正文自动提取当前版本记录,并保留 GitHub 自动生成的变更摘要。

v1.1.24 (2026-10-21)

  • 普通用户可从客户端列表删除自己名下的客户端。
  • 删除操作会同步清理该客户端的隧道、Host 域名规则和在线连接,并在归属变更竞态下再次校验所有权。
  • 旧版按客户端登录的会话不能获得自助删除权限;管理员仍可删除任意客户端。
  • master Docker 构建只发布 sha-<短提交号> 测试标签;正式 Release 同时发布版本号标签和 latest 稳定标签。

v1.1.23 (2026-10-21)

  • 管理员可从客户端列表向在线且支持升级的 NPC 下发远程升级指令。
  • NPC 在后台下载并校验 GitHub Release 后替换自身并自动重启;Windows 服务使用临时更新器处理运行中可执行文件占用。
  • 升级过程遵循 NPC 服务账户权限,不尝试提权;安装目录不可写或校验失败时保持当前客户端运行。

v1.1.22 (2026-10-15)

  • 修复 Bridge 连接、代理认证和更新包校验等兼容性问题。

v1.1.21 (2026-10-12)

  • 修复 Web 面板配置 web_base_url 后验证码仍请求根路径的问题,适配反向代理子路径。
  • 修复系统服务启动时 Web 面板相对证书路径按错误工作目录解析的问题。
  • 修复 SOCKS5 UDP BND.ADDR 优先返回错误外网地址的问题,增加校验过的 HTTPS 外网 IP 备用探测。
  • 服务端更新成功后,若已安装系统服务则自动重启使新版本生效。

v1.1.20 (2026-09-22)

  • 资源拓扑大屏密钥改为服务端加密持久化,授权账号刷新后仍可查看密钥、复制快捷地址并打开大屏;重新生成和撤销仍会立即失效旧地址。
  • 管理员用户列表把 API Token 的生成、重新生成和撤销按钮放入 Token 状态列,操作列只保留启用/停用、编辑和删除。
  • 用户列表客户端数、隧道数列宽收窄到适合三位数字的宽度。

v1.1.19 (2026-09-22)

  • 普通用户可在账号区域自助生成、重新生成和撤销 API Token,管理员用户列表增加 Token 状态和撤销操作。
  • 新增管理员/普通用户隔离的只读资源拓扑大屏快捷地址,支持自定义密钥和随时撤销。
  • 补齐 Web API 与大屏快捷地址文档。

v1.1.18 (2026-09-21)

  • 资源拓扑大屏默认每 60 秒刷新,管理员和普通用户页面均可自定义 5–3600 秒刷新间隔;设置保存在当前浏览器,不影响服务端转发。

v1.1.17 (2026-09-21)

  • 增加 Linux GUI 发布依赖下载和 Wails 构建重试,避免网络抖动导致 Release 被跳过。
  • 统一 GUI 安装包元数据版本到 1.1.17。

v1.1.16 (2026-09-21)

  • 新增管理员操作审计日志:记录登录、用户、客户端、隧道、Host 和全局配置变更,日志使用本地 JSONL 文件保存,不记录密码、API 令牌、证书私钥或代理请求体。
  • 新增按用户授权范围生效的 API 令牌,支持 Authorization: Bearer,令牌仅在生成时显示一次,用户停用或到期后立即失效。
  • Host 域名代理新增路径重写、响应头修改、重定向、自动 CORS 和兼容模式;原始 HTTP 路径保护响应分帧头,避免改写导致分块响应截断。
  • 管理面板新增管理员操作审计页面,并补齐相关配置与 API 文档。

v1.1.15 (2026-09-20)

  • 修复 MUX 收到对端关闭帧时立即释放接收队列的问题。HTTP/1.0 无 Content-Length 响应、分块响应和 TCP 流在关闭前会完整排空已缓冲的尾部数据。
  • 对未被本地调用方读取的已关闭流增加 30 秒兜底回收;正常读取完成后立即释放,不影响现有 NPC 兼容性。

v1.1.14 (2026-09-20)

  • 资源拓扑大屏改为直接基于用户提供的原型布局:保留顶栏、账号摘要、客户端与规则节点、连线、图例和右侧详情抽屉。
  • 移除原型中的用户切换器,仅展示当前登录账号的授权资源;仪表盘入口改为在新标签页打开,继续使用全局登录鉴权与 Logo。

v1.1.13 (2026-09-20)

  • 新增独立的资源拓扑大屏:按当前登录账号的授权范围展示客户端、隧道和域名规则,支持筛选、展开和资源详情查看。
  • 页面每 5 秒从服务端内存读取实时状态、连接数、流量和速率,不持久化监控快照,也不会干扰转发链路。
  • 仪表盘增加资源拓扑入口;直接访问页面沿用全局登录鉴权,接口不返回密钥、证书路径或认证配置。

v1.1.12 (2026-09-19)

  • 修正 TCP、UDP、Host HTTP/HTTPS 与 WebSocket 的入口/出口流量统计:入口统一为公网到内网,出口统一为内网到公网;流量配额按真实双向总量计算。
  • 控制台隧道列表明确区分配置状态、监听状态和客户端状态,显示 TCP 当前连接数;监听启动失败时保留错误原因并在仪表盘汇总。
  • 实时请求调试器向拥有该资源权限的管理用户展示完整请求/响应头,不再对敏感头脱敏;仍只在订阅期间保留有界内存事件,不写入磁盘且不会阻塞转发。
  • 文档补充流量方向、客户端共享带宽限制、配额语义和隧道状态说明。

v1.1.11 (2026-09-19)

  • 新增隧道和域名规则的实时请求调试器,支持来源、监听、实际后端目标、请求/响应头、状态、耗时和流量信息。
  • 对 NPS 可见明文的 HTTP(S) 域名代理,实时展示文本请求体和响应体;文件、二进制和敏感头自动忽略或脱敏。
  • 调试事件只保留在有界内存队列中,浏览器处理慢时丢弃调试事件,不阻塞隧道转发。

v1.1.10 (2026-09-10)

  • 修复 Linux NPC 注册 systemd/SysV 系统服务时引用临时解压路径的问题。
  • 防止从 /usr/bin/npc 重复安装时自覆盖二进制。

v1.1.9 (2026-09-09)

Host 反向代理稳定性

  • 修复客户端请求使用 Connection: close 时,Host 反向代理未等待后端响应完成就关闭连接,导致分块或压缩响应被截断。
  • 增加分块响应终止块和客户端半关闭连接的回归测试,保留有限响应与 SSE 的原有清理行为。

v1.1.8 (2026-09-04)

用户资源与有效期

  • 管理员可设置用户最大客户端数量,普通用户可在配额内自助创建客户端,用户所有客户端共享用户隧道配额。
  • 客户端到期时间不得晚于用户到期时间;客户端留空时跟随用户,用户未设置到期时可独立设置或永不过期。
  • 客户端新增和编辑支持 Basic 认证、压缩、加密及访问控制,服务端统一执行配额和到期边界校验。

控制台与品牌

  • 表单统一到期控件、配额提示和自动填充策略,透明 NPS Logo 已接入登录页、控制台和文档站。
  • 后台顶栏显示当前服务端版本,并在检测到更高的正式 Release 时提示更新。

v1.1.7 (2026-09-03)

稳定性修复

  • 控制台菜单导航采用最新请求生效策略,快速点击或浏览器前进后退不会再出现地址与内容不一致。
  • 新增、编辑隧道在任何数据写入和服务重启前验证代理模式,未知模式会被拒绝。
  • 通用新增隧道页面的返回列表链接会随所选模式同步更新。

v1.1.6 (2026-09-02)

发布整理

  • 同步控制台 UI、平台泛域名与证书热更新改进,统一 NPS、NPC 和 GUI 发布元数据,准备 GitHub Release 与 Docker 版本标签发布。
  • 控制台运行时移除 Bootstrap、Bootstrap Table、Popper 和 DataTables 静态资源,表格改用 ZUI 主题下的原生 NPS 表格适配器,保留原有服务端分页、排序与筛选接口。

v1.1.5 (2026-09-02)

仪表盘与流式代理

  • 仪表盘按管理员/普通用户权限隔离客户端、隧道、Host、流量和配额,增加客户端/隧道运行状态、NPS 代理入/出站速率、配额与健康告警、最后更新时间和 15 秒局部刷新。
  • 修正当前代理连接、内存百分比和资源状态图表,并修复菜单切换和全屏加载闪烁。
  • Host SSE、长连接与 WebSocket 双向转发增加持续输出、客户端中断和资源释放回归保护。

控制台表单与平台域名

  • 新增/编辑页统一为清新蓝色 ZUI 响应式表单,桌面端双列、移动端单列,长字段全宽并消除横向滚动。
  • 平台泛域名证书和私钥允许同时留空,留空时仅支持 HTTP;编辑隧道和 Host 显示客户端名称与 ID 且客户端 ID 只读,后端不会接受篡改的归属。

v1.1.4 (2026-09-02)

域名代理与证书

  • 全局参数新增平台泛域名池,可维护多个 *.example.com、证书与私钥路径;配置保存在 conf/global.json,被引用的域名不能删除或改名。
  • Host 新增自定义域名和平台域名两种模式。平台子域名默认生成可修改的 8 位前缀,后端强制校验唯一性并锁定平台证书。
  • 证书续期脚本以临时文件原子替换后,新 TLS 连接自动加载有效的新证书;文件损坏、缺失或不匹配时继续使用最近有效证书,不重启服务也不打断已有连接。

管理与文档

  • 域名列表按协议展示 HTTP/HTTPS 链接,新增规则诊断,可确认 Host、路径和协议的路由命中与目标选择。
  • 新增平台泛域名、证书热更新与规则诊断,并更新域名代理、全局参数、配置持久化和功能索引说明。
  • NPS/NPC/GUI 版本统一升级到 1.1.4。

v1.1.3 (2026-09-02)

发布与更新

  • 正式 Release 改为在所有平台构建完成后统一上传,并附带 SHA-256 校验文件。
  • CLI 与 GUI 更新器按规范语义版本下载并校验平台资产和 SHA-256,避免安装非正式构建。
  • 补齐 Linux ARM 通用包和 Windows ARM64 CLI 包,macOS GUI 更新改为替换完整 .app 包。

Bridge 协议与兼容性

  • 增加 Bridge 握手超时保护、HTTP CONNECT 代理鉴权、SOCKS5 认证协商和更新包安全校验。
  • 恢复服务端请求客户端局域网地址、客户端断线重连和心跳退出处理。
  • 兼容客户端配置别名 server/server_addr、tp/conn_type。

Web 管理面板

  • 默认语言为简体中文,登录页和管理页支持中英文切换。
  • 修复 Bootstrap 下拉菜单缺少 Popper.js 导致语言菜单无法打开的问题。
  • 管理面板升级为基于 ZUI 3 的运维控制台:统一导航、面板、表格、表单说明、状态与空数据反馈,支持浅色/深色主题、响应式布局和键盘可访问交互。
  • 补齐加载、空数据、错误和表单反馈状态,动态详情内容统一转义。

运行时可靠性与安全

  • 客户端连接数配额使用原子预留,流量统计提供一致快照;HTTP、UDP、WebSocket 代理加强并发关闭和资源回收。
  • 发布模板不再携带固定弱凭据;首次启动会轮换已知占位值,配置和日志文件权限按最小权限创建。
  • 随机凭据使用系统 CSPRNG,IP 白名单授权接口限制为同源访问,日志不再输出授权密码或客户端密钥。
  • 当整个 users.json 在升级时缺失,会从仍保留旧凭据的历史客户端恢复对应用户;已存在文件中的删除、停用或到期状态仍严格生效。

v1.1.2 (2026-06-23)

隧道表单

  • 修复新增和编辑隧道时不同类型字段显示不稳定的问题。
  • 隧道表单按 TCP/UDP、HTTP 代理/SOCKS5、私密代理/P2P 和文件访问类型展示相应目标、监听、密钥及目录字段。
  • Web 模板启动时会从嵌入资源同步覆盖,避免部署后继续读取旧模板。

Docker 构建

  • 新增 .dockerignore,显著减少构建上下文。
  • Dockerfile 使用 Go module 缓存和 BuildKit cache mount。
  • GitHub Actions Docker 镜像构建启用 GHA 缓存,并通过 Go 交叉编译减少 QEMU 模拟构建耗时。

v1.1.1 (2026-06-15)

用户体系

  • 新增独立 User 模型,用户数据保存到 conf/users.json。
  • 管理员可创建普通用户,并将多个客户端分配给同一个用户。
  • 普通用户登录后可查看和管理自己名下多个客户端。
  • 普通用户权限按客户端归属过滤,不能访问用户管理和全局设置。

配额和到期

  • 新增用户级最大隧道数限制。
  • 普通隧道和 Host 域名规则统一计入客户端级和用户级配额。
  • 用户到期后自动停用,并断开/清理名下客户端运行资源。

兼容迁移

  • 启动时自动将旧客户端 WebUserName / WebPassword 迁移为普通用户。
  • 同名同密码合并;同名不同密码自动生成 用户名_客户端ID。
  • 保留旧客户端登录兼容,降低升级风险。

CI/CD

  • 修复 GUI 前端 package.json BOM 导致的 Yarn 安装失败。
  • GUI 构建统一使用 Yarn 1.22.22。

v1.1.0 (2026-06-10)

Web UI

  • 重写 Web 管理面板视觉样式。
  • 支持明暗主题切换。
  • 优化仪表盘、列表、表单、按钮和图表展示。

修复

  • 修复 HTTP/HTTPS/SOCKS5/P2P 等代理连接资源释放问题。
  • 修复 mux 连接池 goroutine 和内存泄漏问题。
  • 修复登录验证码绕过问题。
  • 修复客户端列表网速和连接数显示问题。
  • 修复限速零值导致永久阻塞的问题。

功能

  • 支持客户端到期时间。
  • NPC 菜单新增更新客户端。
  • NPS/NPC 菜单显示当前版本号。

v1.0.0 (2026-05)

  • 基于原版 nps 0.26.10 的二次开发基线。
  • 修复流量统计。
  • 重设计 Web UI。
  • 新增 Docker Compose。

v0.26.10

  • 基于原版 NPS 原始基线,当前项目仓库:ZiDuNet/nps。
在 GitHub 上编辑此页
最后更新: 2026/11/16 23:39
Prev
构建发布
Next
上游更新日志