注册设备并设置策略

代理程序运行并已向你的工作区注册后，设备即受到保护。已注册的设备会拉取你的策略，并将拦截事件发送到控制台。

1. 获取注册密钥和代理程序

以管理员身份打开 Enrollment 标签页。
选择“轮换注册密钥”。密钥以 csk_ 开头，只显示一次，请立即复制。轮换会替换之前的密钥。
选择“下载 Windows 代理程序”或“下载 Linux 代理程序”。macOS 代理程序可按需提供。

Windows 代理程序没有代码签名。请只从控制台下载安装。

2. 在 Windows 上安装并注册

在以管理员权限运行的 PowerShell 中，于存放下载文件的文件夹内运行以下命令。Enrollment 标签页会显示相同的命令，并已填入你的密钥。

$cs = "$env:ProgramFiles\ClearScreen\clearscreen.exe"
New-Item -ItemType Directory -Force (Split-Path $cs) | Out-Null
Copy-Item -Force .\clearscreen-windows-amd64.exe $cs
& $cs install
& $cs enroll "<enrollment key>"
& $cs start

3. 在 Linux 上安装并注册

在存放下载文件的文件夹内运行以下命令。它会安装一个 systemd 服务。

sudo install -m 0755 clearscreen-linux-amd64 /usr/local/bin/clearscreen && sudo clearscreen install && sudo clearscreen enroll "<enrollment key>" && sudo clearscreen start

4. 检查设备

打开 Devices 标签页。设备会连同计算机名称和平台一起显示。再次用相同的计算机名称注册，会替换该设备的密钥，而不是新增第二台设备。每个方案都有设备上限，超出上限的设备会被拒绝。

设备上的服务命令：

clearscreen status
clearscreen stop
clearscreen start
clearscreen uninstall

5. 设置策略

打开 Policy 标签页。管理员可以更改：

被拦截的类别，取自 UT1 列表。
允许列表和拦截列表，每行一个纯主机名。子域名会自动匹配。不要粘贴 https://、路径或通配符。允许列表优先于类别拦截。
自定义类别，即你自己的域名分组（Business 方案）。
拦截页面的标题、消息和徽标（PNG、JPEG、WebP 或 SVG，最大 256 KB）。

选择“保存策略和品牌设置”。已注册的设备会从控制台拉取新策略。

6. 测试拦截

在设备上打开一个属于被拦截类别的域名。该域名会解析到本地拦截页面，页面显示域名、类别和来源。在 Windows 上，桌面通知会显示原因。在 Linux 上，被拦截的 HTTPS 网站可能会显示浏览器证书警告，而不是拦截页面。

拦截页面上有“发送复核请求”按钮。该请求会出现在 Reviews 标签页。在那里将报告标记为允许，只会更改报告的状态。要允许该域名，请将其添加到 Policy 标签页的允许列表。

独立模式

代理程序也可以在没有账号的情况下运行，使用默认策略和公开的已签名数据包。独立模式从不上报拦截事件。

sudo clearscreen run --foreground