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 快捷启动命令。
推荐阅读顺序
- 安装与部署
- 快速开始
- 运行命令速查
- 用户体系
- 使用说明页面配置
- 隧道模式
- 系统架构
- 服务端配置文件参考
- 客户端配置
- Docker 部署
- GUI 客户端
- 升级迁移
- 对外 API v1
- 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 本地升级说明
- 功能与兼容矩阵
文档目录
快速上手
服务端
客户端
扩展功能
项目与社区
- 用户体系
- 系统架构
- 升级迁移
- 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
- 贡献
- 交流
- 捐助
- 致谢


