---
outline: deep
order: 1
heading: v2.x
sub-order: 1
---
::: info 版本提示
本板块文档仅供V2.x使用。
:::

# 使用指南

1. 较于v1.x，v2.x配置文件存在破坏性修改，请您重新配置。
2. v2.0版本为归档版本，不按照本说明配置，本说明支持v2.1往后的版本。

## 安装

1. 加载安装包，并按安装指引其安装至电脑中

2. 由于软件需要监听 Windows 安全日志中的登录事件，如首次使用需要通过弹出 UAC 窗口请求管理员权限，请点击 UAC 窗口中的`是`。

3. 软件本体无窗口界面，运行后静默驻留系统托盘。您可右键托盘中的“小鸽子”，点击`编辑配置`配置 SMTP 邮件参数、通知模板以及要监控的登录类型。

> [!TIP]
> 您可以参考[《配置文件说明》](/columba/v2/ini)自定义您的配置文件

4. 按要求编辑并保存配置之后，您可以右键托盘中的“小鸽子”，点击`测试邮件`来检查 SMTP 邮件参数是否正确，以便后续的通知。

5. 正确接收到测试邮件之后，软件即可正确运行。

::: danger 无法监控？
如果无法正常监控登录事件，您可以右键托盘中的“小鸽子”，点击`查看日志`或`查看失败登录记录`来排查问题。日志文件大小限制为2MB，超过后自动清空，防止磁盘空间被无限占用。
:::

## 登录失败每日汇总与防火墙黑名单

在该版本中，我们将原先每次失败都发送邮件，改为了每日凌晨12:00发送登录失败每日汇总，以避免短时间内爆破导致邮箱爆炸。

另外，您可以通过设置配置文件中的`ban_frequency`来自动添加黑名单，超过该数值则添加至防火墙黑名单（留空或为0则无加入黑名单，只记录）。Columba产生的黑名单策略名称为`Columba Block {ip_str}`，您可以打开Windows 防火墙来手动管理。

## 冷却机制

为避免登陆类型叠加，而导致同一次登陆成功发送多次邮件，本版本添加冷却机制。在本60s内，同一用户名同 IP 只发一封成功邮件，进而合并那些短时间内由不同登录类型（如交互式和远程交互式）触发的重复通知。

## 开机自启

您可以通过以下方式，将本软件开机自启：

### 用户级自启动

1. 按下 Win + R 打开“运行”窗口。

2. 输`shell:startup`，将需要开机启动的程序 快捷方式 拖入弹出的文件夹。

3. 重启电脑验证程序是否自动运行。

### 系统级自启动

1. 按下 Win + R 打开“运行”窗口。

2. 输`shell:common startup`，将需要开机启动的程序 快捷方式 拖入弹出的文件夹。

3. 重启电脑验证程序是否自动运行。