nps

module
v0.28.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 14, 2025 License: GPL-3.0

README

NPS 内网穿透 (全修)

GitHub Stars GitHub Forks Release GitHub All Releases

由于 GitHub 限制浏览器语言为中文(Accept-Language=zh-CN) 访问 *.githubusercontent.com ,图标可能无法正常显示。


简介

NPS 是一款轻量高效的内网穿透代理服务器,支持多种协议(TCP、UDP、HTTP、HTTPS、SOCKS5 等)转发。它提供直观的 Web 管理界面,使得内网资源能安全、便捷地在外网访问,同时满足多种复杂场景的需求。

由于NPS停更已久,本仓库基于 nps 0.26 整合社区更新二次开发而来。


主要特性

  • 多协议支持
    TCP/UDP 转发、HTTP/HTTPS 转发、HTTP/SOCKS5 代理、P2P 模式、Proxy Protocol支持等,满足各种内网访问场景。

  • 跨平台部署
    支持 Linux、Windows 等主流平台,可轻松安装为系统服务。

  • Web 管理界面
    实时监控流量、连接情况以及客户端状态,操作简单直观。

  • 安全与扩展
    内置加密传输、流量限制、到期限制、证书管理等多重功能,保障数据安全。


安装与使用

更多详细配置请参考 文档(部分内容可能未更新)。

Android | OpenWrt
Docker 部署

DockerHubNPS NPC

GHCRNPS NPC

有真实IP获取需求可配合 mmproxy 使用。例如:SSH

NPS 服务端
docker pull duan2001/nps
docker run -d --restart=always --name nps --net=host -v $(pwd)/conf:/conf -v /etc/localtime:/etc/localtime:ro duan2001/nps
NPC 客户端
docker pull duan2001/npc
docker run -d --restart=always --name npc --net=host duan2001/npc -server=xxx:123,yyy:456 -vkey=key1,key2 -type=tls,tcp -log=off
服务端安装
Linux
# 安装(默认配置路径:/etc/nps/;二进制文件路径:/usr/bin/)
./nps install
nps start|stop|restart|uninstall

# 更新
nps stop
nps-update update
nps start
Windows

Windows 7 用户请使用 old 结尾版本 64 / 32 (需要手动更新)

.\nps.exe install
.\nps.exe start|stop|restart|uninstall

# 更新
.\nps.exe stop
.\nps-update.exe update
.\nps.exe start
客户端安装
Linux
./npc install
/usr/bin/npc install -server=xxx:123,yyy:456 -vkey=xxx,yyy -type=tls -log=off
npc start|stop|restart|uninstall

# 更新
npc stop
/usr/bin/npc-update update
npc start
Windows

Windows 7 用户请使用 old 结尾版本 64 / 32 (需要手动更新)

.\npc.exe install -server="xxx:123,yyy:456" -vkey="xxx,yyy" -type="tls,tcp" -log="off"
.\npc.exe start|stop|restart|uninstall

# 更新
.\npc.exe stop
.\npc-update.exe update
.\npc.exe start

提示: 客户端支持同时连接多个服务器,示例:
npc -server=xxx:123,yyy:456,zzz:789 -vkey=key1,key2,key3 -type=tcp,tls
这里 xxx:123 使用 tcp, yyy:456zzz:789 使用tls


更新日志

DEV
  • Main
    • 待定,优先修BUG,新功能随缘更新
Stable
  • v0.28.0 (2025-05-15)

    • TLS、WSS 默认校验证书 (支持自签名证书)
    • 防重放攻击、中间人攻击等 (建议使用TLS、WSS)
    • 优化域名解析速度
  • v0.27.0 (2025-05-14)

    • 启用隧道添加端口检查 #74
    • NPS添加secure_mode选项,开启后不再支持旧版客户端
    • NPC添加proto_version选项,如需连接旧版服务器需要配置-proto_version=0
    • 重写客户端连接协议,防止探测、重放攻击等 (系统时间需要配置正确,依赖系统时间)
    • 更换哈希算法
    • 增加记录客户端本地IP地址
    • 修复最快IP解析
    • HTTP正向代理使用相对路径 #75
    • 新增WS、WSS方式连接服务端 #71
    • 客户端服务器双向认证
    • 允许独立配置连接协议
    • 网页添加命令行提示
  • v0.26.56 (2025-05-07)

    • 日志相对路径使用配置路径
    • 日志添加log_color选项
    • 调整关闭日志优先级
    • 减少登录错误弹窗等待时间
  • v0.26.55 (2025-05-05)

    • 文档添加自动翻译
    • 重写日志输出模块
    • 修复日志轮换功能
    • 修复日志权限问题 #70
    • 更新上游依赖
  • v0.26.54 (2025-05-02)

    • 更新文档说明
    • 添加弹窗翻译
    • 优化浏览器语言检测
    • 优化操作逻辑减少操作步骤 #69
  • v0.26.53 (2025-04-25)

    • P2P同时转发TCP和UDP端口
  • v0.26.52 (2025-04-23)

    • 优化服务器域名解析逻辑
    • 修复同时启用TCP和KCP时客户端不同步问题
  • v0.26.51 (2025-04-22)

    • 优化P2P打洞算法
    • 使用迭代法解析服务器域名
    • 优选最快IP连接服务器
    • 允许同时监听KCP端口
  • v0.26.50 (2025-04-19)

    • 优化P2P探测和连接速度
    • 隧道编辑页面支持保存为新配置 #8
    • 调整页面显示,添加排序支持
  • v0.26.49 (2025-04-18)

    • vkey添加点击复制
    • 重写透明代理逻辑 #59
    • 修复linux、darwin、freebsd的透明代理
  • v0.26.48 (2025-04-17)

    • 添加点击自动复制命令行 #62
    • 密码认证配置内容忽略空行
    • 修复NPS的IPv6自动识别
    • 修复管理页面显示
    • 隧道列表支持端口号排序
    • 重写客户端TLS功能,支持使用type传入tls (已弃用tls_enable)
    • 重写服务端TLS功能,支持TLS端口复用 (已弃用tls_enable)
    • 客户端支持连接多个服务器 #9
    • 更新证书随机生成
  • v0.26.47 (2025-04-14)

    • 优化P2P处理逻辑
    • 服务端支持配置p2p_ip=0.0.0.0来自动识别IP地址(IPv4/IPv6由dns_server配置决定)
    • 服务端支持配置p2p_ip=::来强制自动识别使用IPv6地址
    • 修复P2P的IPv6支持
    • NPC自动选择IPv4/IPv6进行P2P连接
    • 新增 支持单条隧道独立配置密码认证
  • v0.26.46 (2025-04-14)

    • 调整日志输出等级
    • 优化写入性能
    • 修复端口复用时连接泄露和并发冲突
    • 清理代码更新相关依赖
    • 新增OpenWRT仓库 djylb/nps-openwrt
    • 修复拼写错误
    • 自动更新AndroidOpenWrt仓库
    • 自动识别服务器IP #59
    • P2P支持IPv6(需要纯IPv6网络环境)
  • v0.26.45 (2025-04-09)

    • 搜索功能匹配不限制大小写
    • 修复HTTP代理认证头 #55
    • 添加编译架构 #53
    • 增加自定义DNS支持非标准系统
    • 新增安卓客户端 #53 djylb/npsclient
    • 美化下拉框样式,使用标准JSON保存数据 #51 (感谢yhl452493373)
  • v0.26.44 (2025-03-26)

    • 修复客户端超过1000不显示问题
    • 增强 隧道添加支持搜索客户端
  • v0.26.43 (2025-03-24)

    • 修复客户端隧道编辑按钮缺失
    • 隧道列表隐藏无用信息
    • 新增 域名转发隧道支持暂停
    • 增强 域名转发防止扫描探测
  • v0.26.42 (2025-03-23)

    • 修复管理页面表单Id标签重复
    • 修复隧道页面不显示
    • 整理nps.conf文件
  • v0.26.41 (2025-03-22)

    • Docker自动创建NPS默认配置 (一定要记得改配置)
    • 固定管理页面左侧菜单、顶部标题、底部footer #49
    • 优化运行速度,减少资源占用
    • 修复单条隧道流量统计 #30
    • 增强流量统计颗粒度 (注意:客户端流量是隧道流量出入总和的两倍)
    • 修复文件模式访问
    • 调整管理页面文件模式显示
    • 新增 管理页面表单选项持久化储存
    • 新增 表单添加显示全部选项
    • 新增 单条隧道支持限制流量和时间
    • 调整隧道页面显示
    • 修复NPC客户端NAT检测
  • v0.26.40 (2025-03-21)

    • 前端页面美化 #47
    • 增加docker支持架构,添加shell支持
    • 向NPS的docker镜像添加tzdata软件包支持时区配置 #45
    • 私密代理支持通过TLS连接 #37
    • docker添加主线分支发布
    • 修复连接数统计问题 #48
  • v0.26.39 (2025-03-16)

    • 切换包至本仓库
    • 更新说明文档至当前版本
    • 更新管理页面帮助
    • 优化 nps.conf 配置文件
    • 更新 SDK 组件
  • v0.26.38 (2025-03-14)

    • 域名转发支持HTTP/2
    • 当配置请求域名修时同时修改Origin头避免后端监测
    • 调整域名编辑页面逻辑
    • 更新相关依赖,修复CVE-2025-22870
    • 使用 XTLS/go-win7 编译旧版代码支持Win7
    • 整理仓库代码
    • 优化域名查找算法

更多历史更新记录请参阅项目 Releases

Directories

Path Synopsis
cmd
npc command
nps command
lib
pmux
Package pmux This module is used for port reuse Distinguish client, web manager , HTTP and HTTPS according to the difference of protocol
Package pmux This module is used for port reuse Distinguish client, web manager , HTTP and HTTPS according to the difference of protocol
web

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL