v1.4.1

[1.4.1] - 2026-10-15

🚀 新特性 (Features)

• cli: 重构 CLI 命令体系并固化 npm 构建发布防呆与 Release 纯净化 (51f4ba5)

🧹 杂项维护 (Chore)

• release: Bump version to v1.4.1 (ebc5375)

v1.4.0

[1.4.0] - 2026-10-15

🐛 缺陷修复 (Bug Fixes)

• security: 解决双轴审查缺陷，补齐预建隧道与场景文档对齐 (#22) (98091fb)

📝 文档变动 (Documentation)

• domain: 补充 ADR-0017 与领域模型通用术语 (#22) (276f606)
• 全面重构 12-Factor 环境变量速查矩阵与 5 大场景矩阵 (#27) (259db10)

🚀 新特性 (Features)

• auth: 实现 SSE 模式强身份令牌与常数时间比对防时序攻击 (#23) (702df23)
• security: 目标主机白名单 (Target Allowlist) 与禁用动态建连 (#24) (520302b)
• server: 默认回环绑定、非回环强制熔断 (Fail-Closed) 与健康探针脱敏 (#25) (c95c6e7)
• security: CORS 跨域策略重塑与来源白名单 (Origin Whitelist) (#26) (a98139c)

🧹 杂项维护 (Chore)

• release: Bump version to v1.4.0 (051ffb9)

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🐳 官方多架构 Docker 镜像 (GHCR)

docker run -d -p 8000:8000 ghcr.io/atengk/mcp-server-ssh:latest

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🐳 GHCR Packages: https://github.com/atengk/mcp-server-ssh/pkgs/container/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

v1.3.0

[1.3.0] - 2026-10-14

🐛 缺陷修复 (Bug Fixes)

• ci: 纠正 Actions 官方主版本引用并允许非锁定依赖安装 (1d5884c)
• release: 移除 Job 级别 if 对 secrets 的非法引用并显式配置 cliff 路径 (8aa0407)

💼 其他变更 (Other)

• core: 实现工具体系收敛与四大杀手级架构能力扩展 (5984a5e)

📝 文档变动 (Documentation)

• readme: 全面焕新文档体系并增设大模型日常实战提示词章节 (8f36f60)
• contributing: 完善本地工程套件并纯化贡献者指南与领域模型 (531dfe3)

🚀 新特性 (Features)

• core: 实现受管脱机后台作业、无泄露提权、目录过滤与三位一体隧道 (8cbb642)
• cli: 实现零依赖命令行标志解析与四维全景自检套件 (ecbcf5e)
• audit: 实现安全审计轨迹系统与零泄密凭据脱敏架构 (a8a43ad)
• server: 支持多实例服务身份标识与系统引导指示 (ADR-0015) (44fe77f)
• build: 全面集成 oss-template 工业级开源工程基建并切换至 Apache-2.0 协议 (ADR-0016) (391cea6)

🚜 代码重构 (Refactor)

• config: 实施严格非宽松环境变量治理与单命名空间收敛 (af4b9ea)

🧹 杂项维护 (Chore)

• release: Bump version to v1.3.0 (3105854)

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🐳 官方多架构 Docker 镜像 (GHCR)

docker run -d -p 8000:8000 ghcr.io/atengk/mcp-server-ssh:latest

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🐳 GHCR Packages: https://github.com/atengk/mcp-server-ssh/pkgs/container/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

Release v1.2.5

[1.2.5] - 2026-10-04

🐛 缺陷修复 (Bug Fixes)

• ci: 对齐 oss-template 容器标签规则并启用制品纯净化治理发布 v1.2.5 (26c964d)

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🐳 官方多架构 Docker 镜像 (GHCR)

docker run -d -p 8000:8000 ghcr.io/atengk/mcp-server-ssh:latest

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🐳 GHCR Packages: https://github.com/atengk/mcp-server-ssh/pkgs/container/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

Release v1.2.4

[1.2.4] - 2026-10-04

🚀 新特性 (Features)

• docker: Docker-compose 默认采用 GHCR 预构建镜像并发布 v1.2.4 (20a400c)

🧹 杂项维护 (Chore)

• changelog: 全面废弃手动 CHANGELOG.md，改由 git-cliff 自动化提取驱动 (2536482)

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🐳 官方多架构 Docker 镜像 (GHCR)

docker run -d -p 8000:8000 ghcr.io/atengk/mcp-server-ssh:latest

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🐳 GHCR Packages: https://github.com/atengk/mcp-server-ssh/pkgs/container/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

Release v1.2.3

[v1.2.3] - 2026-10-04

优化 (Changed)

• 多架构 Docker 镜像极速构建优化：在 Dockerfile 构建阶段引入 --platform=$BUILDPLATFORM，使 TypeScript 依赖安装与 tsup 生产打包始终在宿主机原生 CPU 架构高速运行，规避 QEMU arm64 指令动态模拟导致的编译漫长停滞，将多架构镜像构建时长从数十分钟缩减至 30 秒以内。

---

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

Full Changelog: v1.2.2...v1.2.3

Release v1.2.2

[v1.2.2] - 2026-10-04

修复 (Fixed)

• 多架构 Docker 镜像构建适配：修复 Dockerfile 中 corepack 动态拉取最新 pnpm 导致的构建中断问题，将版本严格固定为与工程 lockfile 及 CI 环境一致的 pnpm@9，保障 linux/amd64 与 linux/arm64 双架构镜像顺利完成交叉编译并自动发布至 GHCR。

---

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

Full Changelog: v1.2.1...v1.2.2

Release v1.2.1

[v1.2.1] - 2026-10-04

新增 (Added)

• 开源工程化规范基座：集成 atengk/oss-template 最佳实践，引入 .editorconfig（统一跨 IDE 编码与缩进）与 .gitattributes（强制文本文件跨平台 LF 换行归一化，彻底消除 Windows CRLF 转换冲突）。
• 开源社区协作契约与模板矩阵：引入规范的 CONTRIBUTING.md（GitHub Flow 与 Conventional Commits 提交指引）、.github/PULL_REQUEST_TEMPLATE.md（PR 质量自检清单）以及 .github/ISSUE_TEMPLATE/（Bug 反馈与特性建议模板）。
• 日常持续集成流水线 (CI)：新增 .github/workflows/ci.yml，在代码 Push 到 main 分支或发起 PR 时自动执行 Semantic PR 标题规范校验、静态类型检查、单元与集成测试套件及产物完整性构建验证。
• GHCR 多架构 Docker 镜像自动发布：在发布流水线中接入 publish-docker Job，在打 Tag 发版时基于 QEMU + Buildx 自动构建 linux/amd64 与 linux/arm64 双架构镜像并推送至 GitHub Packages (ghcr.io/atengk/mcp-server-ssh)。
• 自动化变更日志配置：引入 .cliff.toml 支持基于 Conventional Commits 的变更日志自动提取与分类，与高质量人工复核的 CHANGELOG.md 协同。
• 架构决策记录：沉淀 ADR-0006: 开源工程化规范与全自动流水线基建。

---

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

Full Changelog: v1.2.0...v1.2.1

Release v1.2.0

[v1.2.0] - 2026-10-04

新增 (Added)

• 12-Factor App 标准环境变量解析中枢：引入统一规范前缀 MCP_SSH_* 环境变量矩阵，提供严格强类型解析与边界诊断，同时 100% 透明向下兼容遗留的 SSH_* 环境变量。
• 多形态私钥免挂载注入：支持本地文件路径（MCP_SSH_KEY_PATH）、PEM 多行文本自动换行还原（MCP_SSH_PRIVATE_KEY）及 Base64 编码字符串自动解码（MCP_SSH_PRIVATE_KEY_BASE64），彻底实现容器化零磁盘卷挂载启动。
• 双模通信传输引擎 (Stdio + HTTP SSE)：支持通过 MCP_SSH_TRANSPORT=sse 启动轻量原生 HTTP 服务（默认 8000 端口），暴露 /sse（长轮询事件流）、/message（JSON-RPC 交互）及 /health（服务就绪探针）端点，支持远程网络客户端无缝接入。
• 生产级轻量容器化编排：新增 Alpine 多阶段构建 Dockerfile（非 root 用户 node 运行，内置原生健康检查探针）与开箱即用的 docker-compose.yaml（docker compose up -d 常驻守护）。
• SSE 会话工厂并发隔离：在 SSE 服务层重构引入 serverFactory 机制，为每个接入的 HTTP 客户端动态生成专属 McpServer 实例，消除底层 SDK 单连接限制，实现多客户端并发接入与会话生命周期独立销毁。
• 结构化跳板机与高级连接参数贯通：ssh_connect 扩充 readyTimeout 与 keepaliveInterval 参数，proxyJump 升级支持结构化对象配置（可为跳板机独立指定端口、用户、密码及私钥凭据）。

优化 (Changed)

• 敏感凭证脱敏防护：日志输出与诊断信息全面实施全链路凭据掩码脱敏（***），严禁密码与私钥在任何日志中泄露。
• 多主机预连接体验：服务启动阶段支持依据规范环境变量自动初始化并建立默认连接（Default Connection），免除客户端手动调用建连指令。

---

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

Full Changelog: v1.1.0...v1.2.0

Release v1.1.0

[v1.1.0] - 2026-10-03

新增 (Added)

• 安全拦截受控逃生门：在 ssh_exec 中新增 dangerouslySkipSafetyCheck 参数，配合环境变量 SSH_ALLOW_DANGEROUS_COMMANDS=true 实现双重授权机制，允许运维工程师在必要时受控执行系统重启或维护命令。
• 建连错误诊断感知：ConnectionPool 记录最近一次建连失败原因 lastConnectionError，在 ssh_list_connections 中回显并在找不到连接时精准提示具体失败原因。
• 长任务超时语义化引导：在 ssh_exec 达到 60s 快速熔断时，抛出明确的参数调优引导与 ssh_session_* 交互终端模式指引。
• 供应链 Provenance 签名：GitHub Actions 发布流水线启用 npm publish --provenance，提供由 GitHub Actions OIDC 签发的不可篡改构建来源溯源证明。

优化 (Changed)

• 跨平台路径表达规范：全文档与所有配置示例统一采用跨平台通用的正斜杠（/）规范，彻底规避 JSON 反斜杠双重转义陷阱。
• 自动化发版流水线：重构 release.yml，在发布 GitHub Release 时自动提取 CHANGELOG.md 内容，并保底注入环境安装指引与安全溯源报告。

---

---

📦 快速免安装运行 (Quick Start)

在任何支持 MCP 的宿主（Claude Desktop, Cursor, Antigravity, Cline 等）中直接配置：

npx -y @atengk/mcp-server-ssh

🔗 相关资产与生态链接

• 📦 NPM Registry: https://www.npmjs.com/package/@atengk/mcp-server-ssh
• 🛡️ Provenance 验证: 本次构建由 GitHub Actions 原生 OIDC 签发不可篡改的 Provenance 来源凭据
• 📖 完整文档与示例: https://github.com/atengk/mcp-server-ssh#readme

Full Changelog: v1.0.0...v1.1.0