部署文档
部署与上手
从环境检查到首条告警的完整操作路径。请严格按照支持范围准备环境,避免因系统或端口不匹配导致安装失败。
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 服务器,在包含安装包的目录执行以下命令。
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 页面应可正常访问。
回滚与卸载
如升级或安装后出现异常,可使用安装脚本提供的回滚能力;需要移除服务时执行卸载。
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
- 打开
chrome://extensions。 - 开启右上角“开发者模式”。
- 选择“加载已解压的扩展程序”。
- 选择
C:\Program Files\AiDLP\webext\chrome。
Edge
- 打开
edge://extensions。 - 开启“开发人员模式”。
- 选择“加载解压缩的扩展”。
- 选择
C:\Program Files\AiDLP\webext\edge。
05
Agent 接入
首版支持 WorkBuddy、Harness 两个桌面 Agent 入口。完成客户端安装后,在平台侧确认 Agent 接入状态,并通过测试内容验证告警链路。
- 确认目标 Agent 已安装并处于可用状态。
- 在平台侧查看 Agent 接入与告警结果。
06
首条告警
完成服务端、客户端与扩展 / Agent 接入后,通过测试内容验证链路。
- 打开 DeepSeek、Kimi、豆包或通义千问任一已支持应用。
- 提交一段测试文本。请勿使用真实敏感数据。
- 登录平台,查看告警列表;出现对应事件即表示链路成功。
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 服务。正式使用时应遵循企业数据分类分级与合规要求。