部署文档

部署与上手

从环境检查到首条告警的完整操作路径。请严格按照支持范围准备环境,避免因系统或端口不匹配导致安装失败。

服务端 v1.11.0 Windows 客户端 1.0.6 通常可在 1 个工作日内完成部署,具体以实际环境与安排为准

01

部署前检查

开始安装前,请逐项确认服务器、端口与网络连通性。任一项不满足时,请先调整环境。

  • 服务器为 Ubuntu 26.04 LTS x86_64,具备 root 或 sudo 权限。
  • 80、8787、8790 端口可用;80 用于 Nginx,8787 为平台服务,8790 为本机预筛。
  • 服务器可被客户端访问;客户端可访问服务器 80 / 8787 端口。
  • 客户端为 Windows 10 / 11,浏览器为 Edge 或 Chrome 111+。

02

服务端部署

将服务端安装包上传至 Ubuntu 服务器,在包含安装包的目录执行以下命令。

Ubuntu 26.04 LTS x86_64安装与健康检查
tar xzf aidlp-server-v1.11.0-ubuntu26.04-x86_64.tar.gz
cd aidlp-server-v1.11.0-ubuntu26.04-x86_64
sudo bash install.sh
curl -fsS http://127.0.0.1:8787/healthz

安装完成后,默认由 Nginx 将 80 端口反向代理至 8787;/notice、/privacy 页面应可正常访问。

回滚与卸载

如升级或安装后出现异常,可使用安装脚本提供的回滚能力;需要移除服务时执行卸载。

install.sh回滚 / 卸载
sudo bash install.sh --rollback
sudo bash install.sh --uninstall

03

客户端安装

在 Windows 10 / 11 终端上运行客户端安装包,按向导完成安装。

  • 运行 AiDLP-Setup-1.0.6.exe。
  • 默认安装到 C:\Program Files\AiDLP。
  • 安装完成后,预筛监听 127.0.0.1:8790。
  • 如出现 SmartScreen 提示,请先核对 SHA256 与文件来源,再决定是否继续。

04

扩展加载

浏览器扩展随 Windows 客户端安装,需手动加载已解压的扩展目录。

Chrome

  1. 打开 chrome://extensions。
  2. 开启右上角“开发者模式”。
  3. 选择“加载已解压的扩展程序”。
  4. 选择 C:\Program Files\AiDLP\webext\chrome。

Edge

  1. 打开 edge://extensions。
  2. 开启“开发人员模式”。
  3. 选择“加载解压缩的扩展”。
  4. 选择 C:\Program Files\AiDLP\webext\edge。

05

Agent 接入

首版支持 WorkBuddy、Harness 两个桌面 Agent 入口。完成客户端安装后,在平台侧确认 Agent 接入状态,并通过测试内容验证告警链路。

  • 确认目标 Agent 已安装并处于可用状态。
  • 在平台侧查看 Agent 接入与告警结果。

06

首条告警

完成服务端、客户端与扩展 / Agent 接入后,通过测试内容验证链路。

  1. 打开 DeepSeek、Kimi、豆包或通义千问任一已支持应用。
  2. 提交一段测试文本。请勿使用真实敏感数据。
  3. 登录平台,查看告警列表;出现对应事件即表示链路成功。

07

FAQ

为什么服务端只能装 Ubuntu 26.04?

首版安装脚本、依赖与运行环境按 Ubuntu 26.04 LTS x86_64 验证和交付,其他系统未纳入支持范围。为避免不可预期的问题,请勿在非支持系统上部署。

安装后不出告警?

依次检查:服务端健康检查是否通过、客户端是否在线、扩展是否已同意告知并启用、预筛 8790 是否可访问、测试内容是否命中现有规则。

预筛 8790 不通?

确认 Windows 客户端已安装并正在运行,检查本机 127.0.0.1:8790 是否被安全软件拦截。该端口仅用于本机回环通信,不需要对外开放。

扩展加载后无效?

确认加载的是已解压目录而非压缩包,扩展已在扩展管理页启用,并已完成首次告知同意。必要时重新加载扩展或重启浏览器。

试用到期怎么办?

到期后平台进入只读降级;数据保留期限与删除策略以实际部署配置及我方确认为准。联系我方获取 .lic 授权文件,在“授权控制策略”页导入并经系统验证生效后完成续期。

导入授权报错怎么办?

核对授权文件是否与当前实例匹配、是否在有效期内、文件内容是否完整。仍无法解决时,请将报错信息发送至 hhxd@hhxd-sec.cn。

支持哪些 AI 应用?

Web AI:DeepSeek、Kimi、豆包、通义千问;Agent:WorkBuddy、Harness。首版不覆盖其他 AI / Agent。

能否用真实数据测试?

不建议。请使用构造的测试文本完成首轮验证,避免将真实敏感数据提交至外部 AI 服务。正式使用时应遵循企业数据分类分级与合规要求。

准备好开始部署了吗?

下载试用安装包,或联系我方了解续期。