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 文档

轻量级、高性能、功能完整的内网穿透代理服务器。

当前版本:v1.1.47。本版本修复飞牛纯连接模式断线后不自动重连的问题,并将飞牛内嵌日志视图改为最新在前显示。旧 NPC、旧配置和业务 JSON 继续兼容,配置及业务数据无需手工迁移。

界面预览

管理仪表盘登录安全
管理仪表盘登录安全设置

文档口径

  • 当前正式源码版本以 lib/version/version.go 为准;本页写作时为 1.1.47。
  • nps.conf 字段以服务端配置文件参考为准; 部署安全与参数速查只说明安全边界和常用端口。
  • NPC 命令行与系统服务以客户端配置与启动为准;字段以 NPC 配置文件参考为准。
  • 新 API 集成只使用对外 API v1。API 鉴权说明 凭据兼容,历史 Web API只记录旧接口。
  • Web 导航统一写为「系统 → 全局参数」,再切换到「全局参数」「用户注册」 「服务端配置」「证书设置」或「安全」Tab;「系统 → 使用说明」是查看页,内容在 「系统 → 全局参数」的「全局参数」Tab 中维护。
  • 当前菜单名称统一采用界面原文:「客户端」「用户管理」「域名反代」 「审计与连接」「IP 登记」「账户管理」「使用说明」。
  • 带宽统一写为 KB/s,流量配额统一写为 MB,与 Web 面板一致并按 1024 进制换算:1 KB/s = 1024 B/s,1 MB = 1,048,576 B。

适用场景

  • 将内网 Web 服务通过域名暴露到公网。
  • 将 SSH、远程桌面、数据库等 TCP 服务映射到公网端口。
  • 通过 SOCKS5/HTTP 代理访问内网资源。
  • 为多个客户、团队或设备分配独立账号,并集中管理客户端。
  • 使用 Docker 快速部署服务端和客户端。

核心能力

  • 支持 TCP、UDP、HTTP(S) 反向代理、HTTP / SOCKS 混合代理、P2P、Secret、文件访问。混合代理在一个公网端口上按需开启 HTTP 和 SOCKS5,旧版独立 HTTP/SOCKS 记录继续兼容。
  • Web 管理面板支持客户端、隧道、域名反代、用户和全局配置等管理能力;管理员可在「系统 → 全局参数」的「服务端配置」Tab 中按功能分组维护 nps.conf,在「用户注册」Tab 集中配置注册入口、新用户默认配额、共享并发连接、上下行带宽和 SMTP。可选配置关闭后不会写入有效配置文件,敏感值脱敏,保存后支持确认重启。「全局参数」Tab 的“使用说明”支持远程 URL、conf 下的 HTML 文件或直接粘贴 HTML,修改后无需重新编译面板。仪表盘可进入按当前账号授权范围筛选的实时资源拓扑页,提供浅色/深色主题、中文/英文切换、响应式布局和键盘可访问交互。资源拓扑默认每 60 秒刷新,可在页面上自定义 5–3600 秒的刷新间隔,设置仅保存在当前浏览器;管理员和普通用户均可生成独立的只读大屏快捷地址。
  • 管理员可创建用户,并把多个客户端分配给同一个用户;普通用户也可在管理员设置的客户端配额内自助创建客户端。
  • 支持客户端级和用户级隧道数量限制,Host 域名规则也计入隧道配额;管理员分配与用户自建客户端共用用户客户端配额。
  • 用户与客户端分别支持到期时间:客户端到期不得晚于用户到期,客户端留空时跟随用户;用户未设置到期时,客户端可独立设置或永不过期。
  • 管理员可维护多个平台泛域名及其证书,用户可安全创建唯一子域名;证书外部续期后,新 TLS 连接自动使用有效的新文件。
  • 支持客户端到期、用户到期、IP 白名单/黑名单、验证码、带宽/流量/连接数限制。
  • 数据继续使用 JSON 文件持久化,便于轻量部署和备份。
  • Bridge 支持 TCP、KCP、WebSocket、WSS 和可选 QUIC;KCP、WS、WSS、QUIC 可通过独立端口启用。TLS Bridge 仍使用独立 TLS 端口。现有同端口复用只覆盖受支持的 Bridge、HTTP(S) 和管理面板协议路由。
  • 客户端支持压缩/加密传输选项、SOCKS5 出站代理、P2P/Secret 本地访问端和 GUI 快捷启动命令。

推荐阅读顺序

  1. 安装与部署
  2. 快速开始
  3. 运行命令速查
  4. 用户体系
  5. 使用说明页面配置
  6. 隧道模式
  7. 系统架构
  8. 服务端配置文件参考
  9. 客户端配置
  10. Docker 部署
  11. GUI 客户端
  12. 升级迁移
  13. 对外 API v1
  14. 1.1.47 升级说明
  15. 1.1.46 升级说明
  16. 1.1.45 升级说明
  17. 1.1.44 升级说明
  18. 1.1.43 升级说明
  19. 1.1.42 本地升级说明
  20. 1.1.41 本地升级说明
  21. 1.1.40 本地升级说明
  22. 1.1.39 本地升级说明
  23. 1.1.38 本地升级说明
  24. 1.1.37 本地升级说明
  25. 1.1.36 本地升级说明
  26. 1.1.35 本地升级说明
  27. 1.1.34 本地升级说明
  28. 1.1.33 本地升级说明
  29. 1.1.32 本地升级说明
  30. 1.1.31 本地升级说明
  31. 1.1.30 本地升级说明
  32. 功能与兼容矩阵

文档目录

快速上手

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

服务端

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

客户端

  • 客户端配置与启动
  • 配置文件参考
  • NPC Docker 部署
  • 客户端使用
  • 客户端增强功能
  • GUI 客户端
  • NPC SDK

扩展功能

  • 功能概览与能力边界
  • 域名代理与路由
  • 平台泛域名、证书热更新与规则诊断
  • 访问控制与配额
  • 运行说明与排查
  • 对外 API v1
  • API 鉴权与兼容
  • 历史 Web API

项目与社区

  • 用户体系
  • 系统架构
  • 升级迁移
  • 1.1.47 升级说明
  • 1.1.46 升级说明
  • 1.1.45 升级说明
  • 1.1.44 升级说明
  • 1.1.43 升级说明
  • 1.1.42 本地升级说明
  • 1.1.41 本地升级说明
  • 1.1.40 本地升级说明
  • 1.1.39 本地升级说明
  • 1.1.38 本地升级说明
  • 1.1.37 本地升级说明
  • 1.1.36 本地升级说明
  • 1.1.35 本地升级说明
  • 1.1.34 本地升级说明
  • 1.1.33 本地升级说明
  • 1.1.32 本地升级说明
  • 1.1.31 本地升级说明
  • 1.1.30 本地升级说明
  • 功能与兼容矩阵
  • 构建发布
  • 本项目更新日志
  • FAQ
  • 贡献
  • 交流
  • 捐助
  • 致谢

项目链接

  • GitHub
  • Docker Hub - nps
  • Docker Hub - npc
在 GitHub 上编辑此页
最后更新: 2026/11/16 23:39