Skip to content

oneNat Release r2026.09.07

Choose a tag to compare

@toddpan toddpan released this 07 Sep 11:37
· 17 commits to main since this release

oneNat Release r2026.09.07

自 r2026.09.01 以来的能力升级:应用管理 + AI 技能体系 + 实例级凭证。oneNat 仍是基于 ngrok 协议内核的内网穿透与受管隧道平台,本版让「端口背后的系统」成为平台一等公民——每个端口映射绑定一个应用,应用带技能文档与凭证,AI Agent 按规范安全使用。


🆕 新增功能

1. 🗂️ 应用管理 (App Management)

  • 应用 CRUD:新增 /apps 应用管理页与 /apps/:id 应用详情页,登记端口背后的真实系统(SSH / 数据库 / Web API…);
  • 凭证安全存储:应用凭证 AES-256-GCM 加密落盘,页面打码显示;明文 reveal 需显式授权且受限速与审计约束;
  • 技能文件管理:按应用上传/下载/在线编辑/删除技能文档(文件名消毒 + 扩展名白名单 + SHA256 校验 + 单应用容量限额);
  • 端口映射必选绑定应用:隧道详情页为每条映射选择应用,AI 资源列表随映射内嵌应用元数据与技能清单(技能 URL 自动烘入调用方 KEY);
  • 内置应用自动预置:全新安装自动创建「SSH Server」与「DSH」两个内置应用,并附带平台预制的完整使用技能。

2. 🤖 AI SKILL 体系升级

  • /skill/onenat.md 全面重写:新增快速开始、隧道↔应用绑定校验(防绑错技能)、tcp 隧道直接承载 HTTP 的地址换算法、公网端口动态变化提醒、凭证获取章节、行为约定;
  • /skill/index.md 平台总索引:全部应用 + 全部技能的 Markdown 目录,AI 一跳获取;
  • AI 只读接口:GET /api/v1/resources(隧道+映射+绑定应用实时清单)、GET /api/v1/apps、GET /api/v1/apps/:id/skills/:name/content,全部 API KEY 鉴权、只读、免协调。

3. 🔑 实例级凭证 —— 映射级凭证覆盖(本版核心)

同一应用部署在多台机器上(如两台机器各跑一个 DSH),每条映射指向不同实例、凭证各不相同:现在凭证跟实例走。

  • 映射上可设置独立凭证:支持 bearer / basic / header 三种认证类型;
  • 三态语义:修改映射时省略 auth = 保持现状;auth_type: "none" = 清除覆盖、回退应用默认;其余 = 设置/替换;
  • AI 取有效凭证:新端点 GET /api/v1/mappings/:id/credentials,返回「映射覆盖 ?? 应用默认」的有效凭证,resolved_from 字段标明来源(mapping / app);非本账号的映射一律 404,不泄露存在性;
  • 资源列表可感知:GET /api/v1/resources 的每个映射新增 id / auth_override / auth_type(按覆盖优先富化后的有效认证类型);
  • Web UI:映射表单新增「实例凭证」区,下拉切换「继承应用默认凭证 / 实例独立凭证」。

4. 🔐 API KEY「允许读取凭证」开关

  • 新端点 PATCH /api/keys/:id(body {"can_read_cred": bool})+ keys 页徽章开关,仅 owner/admin 可改,写入审计 key.update_perm;
  • 默认关闭:AI 凭证读取(应用级与映射级)统一走 CanReadCred 门禁,未授权返回 403 并审计 cred.read: denied;开启后仍限速 5 次/分、逐次审计;
  • 安全修复:修复 Mapping/MappingView 因内嵌密文类型 MarshalJSON 被提升而遮蔽视图字段的序列化缺陷——凭证密文绝不出现在任何 API 视图,且 auth_override/auth_type 派生标记可靠输出。

5. 👁 体验细节

  • 全站密码输入框新增「小眼睛」明文切换(含动态注入的应用凭证/实例凭证弹窗,MutationObserver 自动补挂)。

6. 🔧 修复与运维

  • fix(client):无 TTY 环境(systemd / 后台 / 无人值守)下 termbox 初始化失败被忽略,draw() 卡死导致 updates 广播分发器阻塞、客户端消息循环冻结(新隧道建立与 ConfigSync 全部失效)。现初始化失败自动回退纯日志模式;顺带修复 go1.26 vet non-constant format string;
  • feat(install):install.sh / install.ps1 渲染时内嵌 dl/ 客户端 MD5 清单——本地版本一致时跳过下载(幂等重装),下载后二次校验、不符拒绝落盘;重装已运行客户端时自动 restart 服务使新密钥生效;
  • fix(onenat):修复 AI 实测发现的资源入口一致性缺陷;onenat.md 明确隧道↔应用绑定与动态获取语义;
  • chore:-skillsDir 默认改为 <webData>/skills(不再相对 CWD);onenat.service 增加 -webAdminPass 保证重装后后台登录账号不变;
  • 运维工具 packaging/onenat-reissue.sh:服务端迁机/换公网 IP 后用既有 CA 重签证书并无缝切换,客户端二进制免重编免重装。

📦 发行包与客户端下载 (Assets)

文件名 平台 / 说明
oneNat-r2026.09.07.tar.gz 服务端完整安装包 (含 4 平台服务端 + 启动脚本 + 7 平台客户端分发)
onenat-client-linux-amd64.tar.gz Linux x86_64 独立客户端
onenat-client-linux-arm64.tar.gz Linux ARM64 独立客户端
onenat-client-linux-arm.tar.gz Linux ARM 独立客户端
onenat-client-darwin-arm64.tar.gz macOS Apple Silicon 独立客户端
onenat-client-darwin-amd64.tar.gz macOS Intel 独立客户端
onenat-client-windows-amd64.zip Windows x86_64 独立客户端
onenat-client-windows-arm64.zip Windows ARM64 独立客户端
checksums.txt SHA256 文件校验和

🚀 服务端快速启动

# 1. 解压
tar -xzf oneNat-r2026.09.07.tar.gz && cd oneNat-r2026.09.07

# 2. 启动 (默认端口: 隧道 4443 / 管理后台 18080)
DOMAIN=你的服务器IP WEB_ADMIN_PASS=你的管理员密码 bash start-onenat.sh

# 3. 浏览器打开 http://你的服务器IP:18080 (初始 admin 密码见启动输出)

⬆️ 从 r2026.09.01 升级

  • 数据文件 onenat-dashboard.json 向后兼容,直接替换二进制重启即可;存量映射未绑定应用仍可用(新增映射强制选应用);
  • 如需启用 AI 凭证读取,请在 后台 API KEY 页对目标 KEY 打开「允许读取凭证」;
  • 建议同步设置 ONENAT_SECRET_KEY(或保留 onenat-secret.key)——应用/映射凭证加密主密钥,丢失后已存凭证需重新录入。