Loggia

常见问题

没找到答案？App 会直接告诉你哪里出了问题、点哪个按钮能修好，先打开服务或链路详情看看。

基本

Loggia 免费吗？

免费版免费，最多可以公开 2 个服务到互联网。Pro 取消这个限制，并加上访问保护，一次买断。详见价格。

需要准备什么？

一台 macOS 26 或更高版本的 Mac、一个 Cloudflare 账户，以及至少一个由 Cloudflare 托管的域名。

需要给 Cloudflare 付费吗？

公开服务用的是 Cloudflare Tunnel，它是免费的。访问保护需要账户开通 Zero Trust，免费套餐就够用。域名照常由注册商收费。

Mac 需要一直开着吗？

需要。服务一直运行在你的 Mac 上，Loggia 只是给它们一个公网地址。Mac 睡眠、关机或断网时，地址就访问不到。连接器会在登录时自动启动，Mac 恢复后服务也随之恢复。

访问流量会经过你们的服务器吗？

不会。访客经由 Cloudflare 直接连到你的 Mac。Loggia 没有自己的服务器，也不收集任何数据，详见隐私说明。

Cloudflare 与 API 令牌

API 令牌需要哪些权限？

在引导或「设置 › 账号」里点 在 Cloudflare 创建 Token，会打开一个已经勾好权限的模板，直接确认即可。模板包含：

Account › Cloudflare Tunnel › Edit必需
Zone › DNS › Edit必需。Zone Resources 可以只选要用的域名。
Account › Access: Apps and Policies › Edit可选，用于访问保护
Account › Access: Organizations, Identity Providers, and Groups › Edit可选，让 Loggia 自动设置邮箱验证码登录

如果想自己创建令牌，「设置 › 账号」里逐项列出了权限，并提供 复制权限清单。令牌只保存在 Mac 的钥匙串里。

刚在 Cloudflare 补了权限，Loggia 还是提示缺少权限。

Cloudflare 上的改动要一两分钟才生效。稍等片刻，再到「设置 › 账号」点 重新检查。

为什么开不了访问保护？
  • 访问保护是 Pro 功能。
  • 服务要先公开，才能开启访问保护。
  • 令牌需要带上面列出的两项 Access 权限。
  • Cloudflare 账户需要开通 Zero Trust，免费套餐就够用。开通后到「设置 › 账号」点 重新检查。
开启访问保护后，谁能打开我的服务？

只有你列出的邮箱；添加 @example.com 则允许该域名下的所有邮箱。访客会通过邮件收到一次性验证码。登录默认有效 24 小时，可以调整。

Loggia 会覆盖我正在使用的域名吗？

不会悄悄覆盖。如果域名已经指向别处，Loggia 会停下来，先征得你的同意再做改动。

Pro 与许可

一个授权码能用在几台 Mac 上？

两台。想换到另一台 Mac，先在已激活的其中一台上，到「设置 › 许可」点 取消激活。

Pro 需要联网吗？

激活时需要。之后 Loggia 每天验证一次授权；连不上授权服务器时，Pro 从上次验证成功起还能继续用 30 天，Mac 联网后会自动恢复。

包含哪些更新？

1.x 的全部版本。

可以退款吗？

可以，购买后 14 天内都可以申请。退款后授权码会停用，Loggia 回到免费版。

退款后，或者授权失效后会怎样？

Loggia 回到免费版，但不会下线任何东西：已经公开的服务继续运行，已经开启的访问保护继续生效，也可以修改允许的邮箱或关掉它。只是不能再公开超过 2 个服务，也不能给别的服务新开访问保护。

故障排查

服务显示不在线，从哪里开始查？

打开这个服务。Loggia 会显示链路的哪一段断了（本地服务、域名记录、Mac 上的连接器，还是 Cloudflare）、原因是什么，以及点哪个按钮能修好。新的域名记录可能要几分钟才生效。

开着代理软件时，状态不准或者连不上。

代理软件开启增强模式或 TUN 模式时，可能会接管到 Cloudflare 的连接。在代理软件里把 argotunnel.com 设为直连（或者把 Loggia 和 cloudflared 加入直连规则），再点 重试。

在哪里查看连接器的状态？

「设置 › 运行时」会显示 cloudflared 是否已安装、是否在运行、版本、上次退出码和日志。如果一直出错，可以在那里导出诊断信息。

更新与卸载

怎么更新 Loggia？

在「设置 › 关于」里点 检查更新。有新版本时，从下载页下载，拖到「应用程序」替换旧版即可，设置和服务都会保留。每个版本改了什么，见更新日志。

怎么彻底卸载 Loggia？
  1. 在「设置 › 账号」里点 彻底移除…，先清掉 Loggia 在 Cloudflare 上的域名记录、路由和访问保护。
  2. 退出 Loggia，把它从「应用程序」移到废纸篓。
  3. 在终端运行 launchctl bootout gui/$(id -u)/com.yangflow.loggia.cloudflared，然后删除 ~/Library/Application Support/Loggia 和 ~/Library/LaunchAgents/com.yangflow.loggia.cloudflared.plist。
  4. 在「钥匙串访问」里删除「Loggia」条目。