VibeTimes Dev Access 使用说明

这份说明用于首次配置 Dev Access：从团队 NAS 个人 home 的 dev 目录导入 dev-access-*.env，启动本机 proxy 和 Cloudflare Tunnel，然后打开 test.<你的 dev 域名> 验证 Cloudflare Zero Trust 第三方登录是否成功。

安装说明下载最新版 DMG Access Control Agent 指南

安全提醒：dev-access-*.env 里包含 tunnel token 和 Access AUD。只从管理员指定渠道获取，不要提交到 git，也不要发到群聊或工单截图里。

准备 dev-access-*.env

配置文件会放在团队 NAS 服务器上你个人 home 文件夹的 dev 目录下。macOS 挂载 NAS 后，通常可以在 /Volumes/home/dev/dev-access-*.env 找到它。

文件里至少需要包含 tunnel token、dev wildcard suffix、允许端口、Access team domain 和 Access AUD。

示例 dev wildcard suffix：alice-dev.vibetimes.ai。对应 test 页是 https://test.alice-dev.vibetimes.ai。

导入 .env

打开 VibeTimes Dev Access.app，进入左侧 Dev Access 页面。在 Configuration 区域点击 Import .env，从文件选择器进入 /Volumes/home/dev，选择对应你的 dev-access-*.env 文件。

导入后，普通配置会写入 app 设置；tunnel token 会保存到 macOS Keychain。

确认配置并启动

确认 Wildcard Suffix、Allowed Ports、Proxy Port 和 Access AUD 已填好，然后点击右上角 Start。

状态变成 Running 时，proxy 和 cloudflared tunnel 都已经启动。

打开 test 登录页

在浏览器打开 https://test.<Wildcard Suffix>。例如 suffix 是 alice-dev.vibetimes.ai，就打开 https://test.alice-dev.vibetimes.ai。

浏览器会先跳到 Cloudflare Access / 第三方登录。登录成功后，页面会显示 email、JWT claim 摘要和 Sign out 按钮。

看到这些就说明成功了

Dev Access 页面顶部状态是 Running。
test 页显示 Cloudflare Access login complete。
Identity 区域能看到你的邮箱，通常来自 Cf-Access-Authenticated-User-Email。
页面上有 Sign out 按钮，可以退出当前 Access session 后重新测试登录。
如果要验证自己的 Web 服务如何接入 Access、如何检查 /api/whoami 或角色权限，请看 Access Control Agent 指南。

软件升级

推荐使用内置更新：打开 app 左侧 Settings 页面，在 Software Update 区域点击 Check Now，按弹窗提示下载安装并重启 app。
如果 app 无法正常打开，或需要手动覆盖安装，请先退出 app，从最新版 DMG 重新下载，然后把 VibeTimes Dev Access.app 拖到 Applications 覆盖旧版本。
升级不会清空已导入的普通配置，也不会删除 macOS Keychain 里的 tunnel token。只有更换了团队分配的 dev-access-*.env 时，才需要重新导入配置。
升级前如果 Dev Access 正在 Running，建议先点击 Stop 或退出 app；升级完成后重新启动并确认 test 页仍能登录。