Skip to content

Releases: hajidishu/nekopass

Nekopass v0.19.2

Choose a tag to compare

@github-actions github-actions released this 24 Oct 07:07

降低面板内存峰值,修复临时对象及空闲连接保留问题。

  • 列表接口改为逐行编码输出,避免同时保留完整查询结果和大块 JSON 缓冲;客户端断开后及时停止读取并释放数据库结果。
  • 页面定时刷新不再叠加慢请求,手动刷新会合并后顺序执行,页面离开后停止调度。
  • 节点组配置生成减少规则深拷贝,并释放临时候选规则及底层数组引用。
  • 使用私有 ACME 根证书时,证书任务结束后主动关闭其 HTTP Transport 的空闲连接,避免失败重试积累连接。
  • 节点配置超过现有 16 MiB 限制时,在序列化前提前拒绝,减少重复重连时的超大缓冲分配。

已通过 Linux 完整竞态测试、权限与计费回归、页面刷新及批量规则操作测试,并完成大列表内存对照测试。

本次没有数据库结构变更,更新主控及随包前端即可应用这些修复。

Nekopass v0.19.1

Choose a tag to compare

@github-actions github-actions released this 23 Oct 18:53

新增余额自动续费与节点流量倍率。

  • 用户可在个人中心开启自动续费,选择周期并确认金额;套餐到期后从余额扣款,同套餐续费保留个人限制并重置流量。
  • 余额不足每 5 分钟重试;涨价超过确认金额、停售或达到购买上限时不扣款,自动续费订单单独标注。
  • 自动续费与手动购买共用事务保护,防止并发重复扣款;失败回滚余额、订单和套餐变更,单个账户异常不影响其他账户续费。
  • 节点可分别设置入口与出口流量倍率,默认入口 1 倍、出口 0 倍。消耗额度 = 双向实际业务流量 ×(入口倍率 + 实际出口倍率);直转仅计算入口倍率,节点组按实际选中的出口计算。
  • 合计 0 倍的线路不消耗额度,额度耗尽后仍可使用;账号停用或套餐到期仍会停止。支持最多四位小数,独立展示实际传输流量与消耗额度。
  • 更新个人中心、用户管理、出口选择提示、节点配置、文档和 OpenAPI,补充计费、迁移、并发续费与界面测试。
  • 升级前端与文档站的 Vite 构建依赖及 Go 1.26.10 编译环境,修复新披露的安全问题。

升级时请先更新主控,再更新入口节点。主控会自动迁移数据库并保留原有余额和用量;旧节点仅支持合计 1 倍的线路。

Nekopass v0.19.0

Choose a tag to compare

@github-actions github-actions released this 19 Oct 12:55

新增出口节点组,单条转发规则可在多个出口之间调度,并支持容灾备用。

  • 出口选择框统一列出单个节点与节点组,以绿色节点图标和蓝色节点组图标区分;创建、批量编辑和导入均可使用。
  • 节点组支持加权轮询、加权最少连接和加权随机;成员可分别配置正常出口、容灾备用、不参与出口转发及权重,同一节点在不同组中的职责独立。
  • 入口通过实际隧道进行认证探测,支持配置探测间隔、连续失败与恢复次数;正常出口不可用时启用备用,恢复后新连接自动切回。
  • TCP 连接和 UDP 会话固定使用建立时的出口;兼容 SNI 共享入站、不同中转协议及安全性配置,保持原有入口限速和业务流量计费。
  • 组内候选严格校验节点权限、入口关联、协议与节点能力,保留现有单出口和直转规则;调度设置更新可保留已有会话。
  • 完善连接超时和共享健康判定,避免慢目标、单条规则授权未同步或过期探测结果影响其他正常规则。
  • 更新节点组、转发规则文档和 OpenAPI,补充真实主备故障切换、SNI、TCP/UDP、计费与并发回归测试。

升级时请同时更新主控、入口和参与节点组转发的出口节点。主控升级会自动迁移至 schema 29;旧节点可继续使用原有转发功能,参与出口组需支持节点协议 24。

Nekopass v0.18.5

Choose a tag to compare

@github-actions github-actions released this 19 Oct 08:59

新增 raw(tcp)+TLS 隧道 Padding,并优化节点设置和节点删除流程。

  • Padding 策略支持 AnyTLS 行格式,配置由主控统一下发到入口和出口,填充不计入用户业务流量。
  • FIN 结束帧携带独立随机填充,保留半关闭行为,并预留结束预算;不再固定单独发送 24 字节结束记录。
  • 节点编辑的“编辑传输协议”和“安全性设置”独立成窗口,分别管理协议参数与 TLS、证书、uTLS、SNI、Padding、Fallback;最终由主窗口统一保存。
  • 修复已离线、已卸载节点永远等待停用配置同步而无法删除的问题,补全入口和出口规则引用检查。
  • 有用量记录的节点可经二次确认强制删除,节点和密钥被移除,历史流量和未归还额度归档保留;迁移规则的累计流量与清空流量基线保持正确。
  • 补充协议、配置和节点删除文档,以及计费守恒、并发删除、事务回滚和浏览器验证。

升级说明:通过面板或 CLI 的正常更新流程升级主控时,数据库会迁移至 schema 28。入口与出口均需更新至本版后才能使用新的 Padding 帧格式,普通转发和其他传输组合沿用原有行为。Padding 策略格式不变。

Nekopass v0.18.4

Choose a tag to compare

@github-actions github-actions released this 16 Oct 13:38

新增转发规则批量编辑,普通用户及管理员代管用户规则时均可使用。

  • 勾选规则后可统一修改入口、出口、负载均衡和 Proxy Protocol 开关;未填写的字段保持原值,直转选项 0 和关闭选项均可明确保存。
  • 弹窗支持批量暂停和恢复。限速、IP 和连接数限制继续跟随用户个人设置。
  • 更换普通规则入口时重新分配监听端口,选择原入口保留端口;共享 TLS 规则可批量修改出口、负载均衡和发送 Proxy Protocol,入口迁移及接收设置沿用原有管理方式。
  • 每次最多处理 500 条规则,逐条校验所属用户、节点权限和协议兼容性,任一规则失败时整批回滚。
  • 弹窗保留打开时选中的规则,定时刷新不会改变操作范围;重新打开时清空待修改字段。
  • 删除重复的“批量切换”按钮及右侧“切换”快捷入口,入口切换统一使用批量编辑,保留分组操作。
  • 补充用户文档、OpenAPI、权限与原子性回归测试,以及用户端和管理员代管页的浏览器测试。

本次无需更改节点配置或数据库结构。

Nekopass v0.18.3

Choose a tag to compare

@github-actions github-actions released this 12 Oct 18:51

TLS 入站改为纯 SNI 分流:多个用户的 TCP 规则共享一个监听端口,客户端直接与最终目标建立 TLS 连接。

  • 节点只读取 ClientHello 中的 SNI,完整握手和密文原样透传;支持分片 ClientHello,保留客户端与目标的证书验证、TLS 版本和 ALPN 协商。
  • 移除共享入站的证书、自签名/ACME 配置、最低 TLS 版本,以及共享规则的入站 ALPN 和回源 TLS 设置。入口到出口的隧道加密仍独立配置。
  • 保留各用户和规则的流量统计、资源限制、暂停/恢复及 PROXY Protocol 功能;透传流量统计包含目标 TLS 握手与记录开销,不含节点间隧道额外封装。
  • 读取 ClientHello 设有并发、大小和超时限制;暂停或不可用规则的 SNI 不会转入其他用户的默认规则。
  • 升级迁移保留共享端口、SNI、规则启停状态、历史用量、余额及出口隧道证书,清理旧入站证书和对应 ACME 凭据。
  • 控制台、文档站和 OpenAPI 说明同步更新;新增端到端 TLS、分片重放和数据库迁移回归测试。

请同时更新面板和使用共享 TLS 入站的入口节点。旧节点的共享规则会停用并显示需要升级;普通 TCP 直转不受此次 SNI 行为调整影响。目标须提供 TLS 服务,其证书由客户端验证。

Nekopass v0.18.2

Choose a tag to compare

@github-actions github-actions released this 12 Oct 13:37

安装与重装

  • 面板安装只以 control.env 判断已有安装;配置不存在时允许重新执行,复用属于该服务的同名数据库并保留管理员账号和密码。
  • 新增 --reinstall:忽略已有安装,清空所选 PostgreSQL 实例中的该服务面板数据库,重新创建管理员并生成密码。
  • 清空前显示范围并要求输入服务名确认;--reinstall --yes 可无人值守执行。--dry-run 和参数校验失败均不会清空数据库。
  • 下载文件、证书和安装参数先验证,再停止同名面板与处理数据库;同机节点端配置和状态保留。
  • 安装测试覆盖全新安装、env-only 重跑、保留数据、取消清空确认、显式数据库重置及管理员登录。

文档与 API

  • 使用 Luna 子代理检查并复核文档与现有实现。
  • 修正规则 PROXY 信任网段描述:请求字段不生效,信任来源由管理员系统设置提供。
  • 修正规则资源限制描述:实际采用用户个人设置,套餐提供初始值,管理员可单独调整。
  • 补充 TLS 入站 PROXY 接收条件、重装用法、清空数据范围和 --yes 行为。
  • README、文档站与 API 版本同步更新;文档内部链接、类型检查和构建通过。

完整 Linux 竞态及数据库回归、实际原生安装/重装、安全和依赖检查、前端/文档构建以及 GitHub 发布流程均已通过。提供全部 Linux amd64 / arm64 面板、节点和安装管理文件。

Nekopass v0.18.1

Choose a tag to compare

@github-actions github-actions released this 12 Oct 12:30

安装修复

  • 修复全新面板安装时因验证码、邀请返利等设置缺少默认值而中断的问题。
  • 安装初始化先读取默认或已有配置,仅覆盖安装器负责的站点与连接字段,保留注册、邮件、返利和安全设置;非法参数不会写入数据库。
  • PostgreSQL 工具从可访问目录执行,消除从 /root 启动时的工作目录权限提示。
  • 增加部分安装参数初始化回归,以及完整全新安装测试,验证随机管理员密码、登录、网页、systemd 自启与重启。
  • 发布流程必须通过完整全新安装测试后才能发布,防止再次遗漏该路径。

测试机实际全新安装、Linux 完整竞态及数据库回归、静态检查、依赖漏洞检查、安装更新脚本和 GitHub CI 均已通过。已提供 Linux amd64 / arm64 面板、节点及安装管理文件。

首次安装请重新下载最新安装脚本。

Nekopass v0.18.0

Choose a tag to compare

@github-actions github-actions released this 12 Oct 11:32

TLS 入站

  • 新增共享 TLS 入站,不同用户的 TCP 转发规则共用端口,按 SNI 分流。
  • 节点编辑新增 TLS 入站子窗口,支持端口、证书、SNI 允许范围、最低 TLS 版本、并发握手上限和超时配置。
  • 支持自签名、手动导入、ACME DNS / HTTP 自动申请及续期,并提供公开证书复制。
  • 支持入站 ALPN 和可选回源 TLS,入口加密、隧道加密与回源加密分别配置。
  • 各规则独立计量、限速和启停,TLS 握手不计入业务流量;暂停一条规则不影响其他规则已有连接。
  • SNI 唯一占用,暂停后仍保留域名;未知或空 SNI 可拒绝或交给管理员默认规则。
  • 共享入口 PROXY 接收及信任来源由管理员管理,可设置节点 TCP 规则仅允许 TLS 入站。
  • 入口、出口证书使用独立 ACME 账户,HTTP 验证支持多个监听端口。
  • TLS 入站与回源设置支持 Nekopass 完整备份,补充文档站和 API 说明。

完整测试、竞态检测、数据库与权限回归、安装更新脚本、依赖漏洞检查、前端及文档构建均已通过。已提供 Linux amd64 / arm64 面板、节点及安装管理文件。

使用 TLS 入站前请同时升级面板与入口节点。

Nekopass v0.17.6

Choose a tag to compare

@github-actions github-actions released this 11 Oct 17:00

新增独立自动换 IP

  • 节点每 5 秒 ping 配置的国内公网 IPv4;成功时清零失败计数,连续失败达到设定次数后请求小助理 API 更换 IP。
  • 独立开关,支持 EC2、Lightsail,以及小助理认证 Token 或分享组 Token;不会启用小助理自带的 GFW 检测。
  • 默认连续失败 6 次触发、冷却 300 秒,均可在「节点管理 → 自动换 IP」设置。
  • 后台显示 ping 结果、连续失败次数、请求进度、冷却时间和新旧 IP;状态刷新保留未保存的输入。
  • 请求处理中不重复提交;任务状态与冷却时间持久化,节点重启后先查询原任务结果。
  • 请求结果不明时继续核对 IP;管理员可在确认云端任务结束后重置等待状态。
  • 确认 IP 变化后立即检查 DDNS,沿用现有 Telegram IP / DDNS 通知。

修复与文档

  • 修复原有隧道关闭回调读取可变连接变量的竞态。
  • 补充自动换 IP 使用文档及管理员 API 定义。
  • CI 初始化 ICMP socket 权限,保留真实 Linux ping 和完整竞争检测。

升级

请同时升级主控与节点。新版安装脚本会配置 ICMP 权限;旧节点如提示 ping 权限不足,重新运行新版安装命令即可刷新服务配置。

完整测试、竞争检测、静态检查、依赖漏洞检查和前端/文档构建已通过。已提供 Linux amd64 / arm64 主控、节点文件及安装管理脚本。