---
title: "安全与隐私：本地存储与安全凭据隔离规范 · Metrix.Bar"
description: "了解看板数据与凭据的存储、权限边界，以及如何关闭使用统计。"
canonical: "https://metrix.bar/zh/docs/privacy"
language: "zh-CN"
---

# 安全与隐私

> 本地数据、凭据保护、权限与使用统计控制。

## 本地数据与凭据

看板文件、输入设置与看板状态保存在你的设备上。Metrix.Bar 无需账号，不会把看板同步到云端数据库。看板直接连接你配置的数据服务。

secret 输入保存在操作系统凭据库中，与普通设置分开。本地 API 只返回 `is_set`，其 `value` 为 null。看板脚本可以读取已配置的凭据以连接服务，因此请只安装可信来源的看板，不要把凭据写进源码、日志或测试 fixture。

## 权限与连接

看板通过 `<permissions>` 声明网络来源与本地文件访问。公共 HTTP 请求必须使用 HTTPS；回环与局域网地址可使用明文 HTTP。直接 TCP/TLS 连接需要显式 socket 权限。扩展桌面能力需要对应的 `<script apis="...">` 声明，开发约定见[文件格式](/zh/docs/bar-format.md)。

文件对话框授权用户选中的路径。写入目标必须经过保存对话框确认；仅声明文件权限不会授予写权限。

本地 API 只监听 `127.0.0.1`。健康检查之外的请求需要 **Settings → Agent** 中的 Bearer token，带有 `Origin` 请求头的请求会被拒绝。请使用设置显示的地址，首选默认端口为 `6387`。

## 使用统计

Metrix.Bar 可以发送匿名使用事件、App 版本与操作系统信息。随机生成的安装标识用于归集事件，不是账号或硬件标识。使用事件不包含看板指标值与凭据。请求会到达远程服务，对方仍会收到来源 IP 等正常连接信息。

在 **Settings → Privacy** 关闭 **Share anonymous usage analytics** 后，不再发送新的使用事件。看板取数与更新检查不受此设置控制。