macOS 权限说明

Stellar 在 macOS 上需要少量系统权限才能正常工作。本页列出真正需要的权限、不需要但常被误开的权限，以及每一项的开启位置。

一句话总结

如果你在网上看到「给 Stellar 完全磁盘访问权限」之类的建议，不要照做。VPN 客户端用不到那个，给了反而是把你邮件、信息、Safari 历史等私人数据暴露给一个网络工具。

真正需要的权限

1. 后台运行（登录项）

用途： Stellar 的后台守护进程（helper）由系统的 SMAppService 注册启动，需要这个权限才能在你登录时自动运行。这是大部分「连不上」问题的真实原因。

开启位置：

系统设置 → 通用 → 登录项 → 「允许在后台运行」

在列表里找到 Stellar，确保右侧开关打开。

2. 网络扩展 / VPN 配置

用途： Stellar 创建一个 TUN 虚拟网卡来接管系统流量。安装时 macOS 会弹出对话框请求你授权，授权一次即可。

开启位置： 通常不需要手动开启，安装时弹窗里点「允许」就行。如果之前点了「拒绝」：

系统设置 → 隐私与安全性 → 拒绝列表 → 找到 Stellar 重新允许

3. 通知（可选）

用途： 连接状态变化时的桌面提示。不开也不影响连接，纯属可选。

开启位置：

系统设置 → 通知 → Stellar

❌ 不需要的权限

下面这些权限 Stellar 都不需要。如果之前误开过，建议关掉：

| 权限 | 为什么不需要 | |---|---| | 完全磁盘访问权限 | VPN 不读你的邮件、信息、Safari 数据。开了等于把这些都暴露给客户端。 | | 辅助功能（Accessibility） | Stellar 不模拟键鼠、不操作其他应用窗口。 | | 屏幕录制 | Stellar 不读屏幕内容。 | | 麦克风 / 摄像头 | 完全无关。 | | 文件与文件夹访问 | Stellar 只读它自己的配置文件，不需要额外的目录授权。 |

如果之前在 系统设置 → 隐私与安全性 → 完全磁盘访问权限 里开过 Stellar / Stellar Helper / sfltool，建议立即关掉。

出现 BTM 修复对话框怎么办

如果 App 启动后弹出「重新安装 Stellar 后台服务 / Repair macOS Background Task State」之类的对话框，那是 macOS 的 SMAppService 注册卡住了（俗称 BTM 损坏）。这跟磁盘访问权限完全无关。

正确的处理顺序：

1. 首选：点击「Install Helper (Legacy)」—— 走旧版 SMJobBless 安装路径，弹一次管理员密码，无需重启。绝大多数情况这一步就能解决。
2. 备选：点击「Fix macOS Background Task State」—— 跑 sudo sfltool resetbtm，需要重启电脑。
3. 不要做的事：不要去开「完全磁盘访问权限」、不要在终端手动执行命令（除非你确定你在做什么）。

还是连不上？

打开 设置 → 联系客服，附上：

1. 当前线路名称
2. 使用的模式（HTTP / 电脑模式 / TUN）
3. 截图或日志（日志位置：/Users/<你的用户名>/Library/Logs/Stellar/）

我们会基于实际信息排查，而不是猜测应该开哪些权限。