Skip to content

Tunnelful 0.1.0

Choose a tag to compare

@github-actions github-actions released this 03 Sep 07:24
· 4 commits to main since this release

Tunnelful 0.1.0

Tunnelful 0.1.0 是首个使用正式版本号的公开版本,支持 Apple 芯片与 Intel Mac,最低系统版本为 macOS 14。

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

本次提供

  • 自动发现或手动选择官方 cloudflared,并展示版本与安装来源。
  • 首次设置与环境检查,覆盖 Homebrew、配置、Tunnel 凭据及账户连接状态。
  • 通过官方 cloudflared tunnel login 打开浏览器完成账户登录;应用不接触 Cloudflare 密码。
  • 导入、编辑、校验和安全保存本地 Tunnel YAML 配置。
  • 预览、复制 DNS 路由命令;关闭隐私遮罩核对目标并再次确认后,可调用官方 CLI 执行。
  • 启动、停止和重启由 Tunnelful 创建的 Tunnel 进程。
  • 分开呈现进程、Edge 与本地源站状态。
  • 实时日志、尽力脱敏与截图隐私模式。
  • 跟随系统、浅色与深色三档外观。
  • 设置、关于、环境检查与软件更新入口。
  • 打开窗口时显示完整 macOS 系统菜单;关闭全部窗口后隐藏 Dock 图标并继续常驻菜单栏。
  • 分别提供 Apple 芯片 arm64 与 Intel x86_64 单架构安装包。

安装前必读

  • 必须先自行安装官方 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.0-arm64.dmg.sha256
shasum -a 256 -c Tunnelful-0.1.0-x86_64.dmg.sha256

已知限制

  • 当前主要面向本地管理的命名 Tunnel。
  • DNS 路由不会自动执行或批量执行;命令显式传入 --overwrite-dns=false,每次远端变更都需要用户确认。
  • DNS 命令超时或执行中退出应用时,远端结果可能未知;应先在 Cloudflare DNS 核对记录再重试。
  • 软件更新功能负责检查 GitHub Release 并打开下载页,不会静默替换应用。
  • 暂不提供 Quick Tunnel、远程配置管理、Access、私网路由或多主机副本。
  • 日志脱敏属于防误操作保护;分享前仍需人工检查。
  • 构建与签名验证通过不等于真实 Cloudflare 账号联调或生产可用性验证通过。

完整边界与安全说明见仓库中的 README.mdSECURITY.md