Tunnelful 0.1.2

Tunnelful 0.1.2

Tunnelful 0.1.2 继续支持 Apple 芯片与 Intel Mac，最低系统版本为 macOS 14。

Tunnelful 是官方 cloudflared 的原生 macOS 控制面。应用不捆绑、不替换 cloudflared，也不重新实现 Cloudflare Tunnel 协议。

本次变化

• 软件更新改为 Sparkle：在应用内检查、下载并安装，不再打开单独的 GitHub 下载页。安装完成后会重新打开 Tunnelful。
• 设置中可开关自动检查更新；菜单栏和系统菜单仍提供“检查更新…”。
• 若 cloudflared 连不上 Cloudflare Edge（例如 QUIC/UDP 7844 超时、HTTP/2 TLS 握手失败），概览会显示“无法连接”和原因，而不是一直停在“正在连接”。
• 设置中可选择 Edge 传输协议。QUIC 被拦截时可跳过等待，改用 HTTP/2 重试。

下载 Tunnelful 0.1.2

• Apple Silicon 版（M 系列芯片）
• Intel 版（x86_64）

两个安装包都需要 macOS 14 或更高版本。不确定芯片类型时，可在苹果菜单的「关于本机」中查看“芯片”或“处理器”。

安装前必读

• 必须先自行安装官方 cloudflared，也可在应用内按照引导完成安装准备。
• Apple 芯片 Mac 下载 arm64 安装包，Intel Mac 下载 x86_64 安装包；请勿混用。
• 此安装包采用 ad-hoc 签名，没有 Apple Developer ID 签名，也没有经过 Apple 公证。
• 请只从本仓库的 GitHub Release 下载，并使用随附的 .sha256 文件核对完整性。
• 首次打开可在访达中按住 Control 点按应用，再选择“打开”。不要运行来源不明的命令绕过 macOS 安全检查。

校验下载文件：

shasum -a 256 -c Tunnelful-0.1.2-arm64.dmg.sha256
shasum -a 256 -c Tunnelful-0.1.2-x86_64.dmg.sha256

分发方式与首次打开

两个 DMG 均采用 ad-hoc 代码签名（没有开发者身份），不是 Developer ID 签名，且未经 Apple 公证。因此 macOS 无法验证开发者或确认安装包已经过 Apple 恶意软件检查，首次打开通常会触发 Gatekeeper。

1. 打开 DMG，把 Tunnelful 拖进「应用程序」，然后双击 Tunnelful 尝试打开一次。
2. 若 macOS 阻止运行，打开「系统设置 → 隐私与安全」，滚动到“安全性”，点击「仍要打开」。
3. 在再次出现的警告中点击「打开」；系统可能要求密码或 Touch ID。以后可正常双击打开。

仅在确认安装包来自本仓库的 GitHub Releases 时放行。详细背景见 Apple 的安全打开说明。

已知限制

• 当前主要面向本地管理的命名 Tunnel。
• DNS 路由不会自动执行或批量执行；命令显式传入 --overwrite-dns=false，每次远端变更都需要用户确认。
• 0.1.1 仍通过打开下载页提示更新；从 0.1.2 起，后续版本可在应用内安装。
• 暂不提供 Quick Tunnel、远程配置管理、Access、私网路由或多主机副本。
• 日志脱敏属于防误操作保护；分享前仍需人工检查。
• 构建与签名验证通过不等于真实 Cloudflare 账号联调或生产可用性验证通过。