谛听 DITING

LLM 驱动的自主渗透测试工作台 · Go + Next.js + PostgreSQL

当前公开版本：2.5.0。本版提供 Windows amd64 安装包，以及应用与 PostgreSQL 的 Docker Desktop Linux amd64 离线镜像和部署包。首次安装为空白业务状态；界面截图中的合成记录不会导入安装。

下载发行版 · 界面截图 · 开始使用

基于 ARTEX 改造，保留资产图、任务探索、多代理协作、流量证据和人工审批，增加预算、证据关系、报告版本、完整导出与加密备份恢复。前端参考 Amicro，支持深浅主题与移动端。仅用于拥有或明确获得授权的目标。

首次使用为空白业务状态。 源码和发行包不包含演示数据库、任务、资产、漏洞、对话、模型配置、API Key 或管理员密码。首次启动需要自己的 PostgreSQL、登录密码和模型配置。内置 Agent、工具定义、提示词、拦截规则是功能默认项，会自动初始化。

以下截图中的模拟记录仅展示界面，不会随安装导入。发布源码不提供运行时演示数据或模拟登录。

浅色工作台	深色工作台

登录页	手机工作台

• 任务与多代理：规划、执行、对话、报告代理；模板、目标、约束、运行状态、模型配置链与纠偏入口。
• 预算与收尾：token/工具预算、保守预留、耗尽后的收尾、有限默认轮次与无进展保护。
• 资产与范围：企业/任务资产、范围与拦截、筛选、完整 CSV/JSON 导出、批量挂接、ScopeSentry 同步。
• 发现与证据：请求/响应绑定、重复关系、复测、报告重生成作业、证据版本和历史报告。
• 会话与流量：搜索与完整历史导出；流量录制、HAR/CSV 和原始报文包导出。
• 系统与恢复：LLM、MCP、技能、自定义工具、通知、加密备份、恢复预览、隔离恢复和迁移状态。

约束提供代理上下文；工具拦截规则独立执行。token 预算是本地用量账本，不是供应商金额账单。

1. 从 Releases 下载 Windows amd64 zip，解压到新的目录。

2. 准备 PostgreSQL 16 或更新版本。可连接自己的数据库，或仅用 Docker 创建空库：

   docker run -d --name diting-postgres -p 127.0.0.1:5433:5432 -e POSTGRES_USER=diting -e POSTGRES_PASSWORD=YOUR_DATABASE_PASSWORD -e POSTGRES_DB=diting -v diting-pgdata:/var/lib/postgresql/data postgres:16

   将 YOUR_DATABASE_PASSWORD 换成自己的强密码。

3. 2.4.0 起可直接运行 start.bat，在本机数据库向导填写连接信息。也可复制 config.example.json 为 config.json 手动配置；示例为 127.0.0.1:5433、用户/数据库 diting，密码必须自行填写。skill_dir 留空使用程序旁的 skills/。

4. 运行 start.bat，或在 PowerShell 中：

   .\start.bat -addr 127.0.0.1:8787 -proxy 127.0.0.1:8788

5. 打开 本地工作台。2.4.0 起数据库未配置或连接失败时显示本机向导；连接测试不创建数据库、不改动配置，保存成功后同一进程进入密码初始化。设置至少 8 位登录密码，随后完成环境检查和模型配置；模型保存不发起供应商请求。可稍后从「系统配置 → 初始化与环境检查」返回向导，再创建企业、资产、任务或对话。

数据库初始化向导（隔离验收实例，无业务数据或凭据）：

向导仅绑定回环地址，并检查本机来源、Host、Origin 和一次性启动令牌。文件配置修改保留原文件备份；已有配置 JSON 无效时拒绝覆盖。ARTEX_PG_DSN 已设置时，只允许重试该连接，不保存会被环境变量覆盖的文件配置。默认应用监听为 127.0.0.1:8787；需要其他监听地址时显式指定 -addr。

发行包内部可执行文件名保留 artex.exe，产品品牌为 DITING。启动脚本也支持源码构建的 diting.exe。原有 ARTEX_* 环境变量保留兼容名称，ARTEX_PG_DSN 优先于配置文件；如之前设置过，请确认它指向预期数据库。

本次首发提供 Windows amd64 包。其他平台可从源码编译；跨平台 CI 的结果以对应运行记录为准。

已在 Windows Docker Desktop 的 Linux amd64 引擎实际验证空卷安装、登录、持久化重建、升级、加密备份与隔离恢复；本版通过 GitHub Release 提供离线镜像，不提供容器镜像仓库地址；独立 Linux 宿主机、macOS 和其他架构未在本版实际验收。使用 Docker Desktop 的 Linux 引擎或 Linux Docker Engine，可从源码构建：

Copy-Item .env.example .env
# 编辑 .env，填写自己的 POSTGRES_PASSWORD；空密码会被拒绝。
docker compose -p diting build artex
docker compose -p diting up -d
docker compose -p diting ps

从 2.5.0 发行页 下载 Docker 部署 ZIP、应用镜像 TAR 和 PostgreSQL 镜像 TAR。将部署包解压，在含 docker-compose.yml 的目录运行；镜像路径按实际保存位置填写：

docker load -i DITING-2.5.0-linux-amd64-image.tar
docker load -i PostgreSQL-16.15-linux-amd64-image.tar
Copy-Item .env.example .env
# 编辑 .env，填写自己的 POSTGRES_PASSWORD。
docker compose -p diting --env-file .env up -d --no-build --wait
docker compose -p diting --env-file .env ps

此方式不需要构建或下载已提供的镜像；首次安装仍需用户自行设置密码。镜像不包含数据库、业务数据或模型凭据。Docker 部署包与两个镜像归档均需保留；备份工具的宿主机 Python 依赖需另行安装，不承诺该依赖安装过程离线可用。

打开 http://127.0.0.1:8787 初始化登录密码和模型。数据库自动创建空库；模型、任务、企业、资产、发现和对话均不预置。Compose 将 PostgreSQL 固定为 16.15，等待数据库健康后启动应用，应用健康检查也验证数据库连接。数据库不发布宿主端口；应用与录制代理仅映射本机 8787/8788，可通过 .env 更改端口。

应用使用 UID/GID 10001 运行。ARTEX_HOME=/var/lib/diting/runtime 保存配置、jwt.key 与 secrets.key；工作区在独立 /var/lib/diting/data 卷，避免密钥出现在可浏览工作区。技能及工具用户目录分别持久化，首次空技能卷从镜像初始化，重建后保留用户修改。ARTEX_HOME 必须使用绝对路径；Windows 未设置时保留原程序目录行为，ARTEX_CONFIG 仍可单独指定配置文件。

固定项目名 -p diting 保证重建继续使用同一批卷。docker compose -p diting down 保留卷；不要在升级时加 -v。容器中的更新入口只用于检查版本；应用升级应先停机完整备份，再构建或载入目标镜像并重建应用。回退旧版需要恢复升级前完整备份到新库和新卷。Docker 备份恢复操作说明介绍完整操作及限制。验收使用隔离测试数据，没有真实模型或目标调用。

遇到部署故障时，先查看服务状态和近期日志：

docker compose -p diting ps -a
docker compose -p diting logs --tail 100 postgres artex

• 构建依赖下载超时：检查宿主机及容器访问下载源的连接。需要宿主机代理时，在本次 docker build 中显式传入 HTTP_PROXY、HTTPS_PROXY，并添加 --add-host host.docker.internal=host-gateway；代理地址及凭据不要提交到源码。BuildKit 会缓存 npm 依赖，重新构建可以复用缓存。
• PostgreSQL 不健康：检查数据库服务日志、卷的可用空间和 .env 密码。已有数据库卷不会因为修改 POSTGRES_PASSWORD 自动修改数据库内的密码；需按 PostgreSQL 的密码变更流程同步修改，不能靠删除卷解决。
• 应用返回健康检查 503：数据库连接暂时不可用。先恢复数据库服务及连接，再检查应用健康状态；数据库健康后应用才会正常响应。
• 应用报告凭据密钥不匹配：恢复该数据库对应的 secrets.key。不要生成新密钥覆盖原文件，也不要把密钥放入工作区。
• Docker Desktop 在应用容器创建前提示 dockerInference 或 engine.sock 无法访问：这是 Docker Desktop 启动阶段的问题，Docker 问题库有同类报告。先退出 Desktop，按厂商说明恢复其运行目录；不要为此重置数据、注销 WSL 或删除业务卷。日志可能含敏感信息，分享前自行脱敏。

需要 Go 1.26.3 或更新版本、Node.js 22、npm 和 PostgreSQL。

git clone https://github.com/bluechips-zhao/DITING.git
cd DITING
.\build.bat
Copy-Item config.example.json config.json
# 编辑 config.json 后启动
.\start.bat -addr 127.0.0.1:8787 -proxy 127.0.0.1:8788

Windows 可分发 zip：

powershell -ExecutionPolicy Bypass -File scripts/package-release.ps1 -Version 2.5.0

打包脚本按固定文件清单组装，不复制配置、JWT 密钥、数据库、日志或工作区文件；输出到 dist/，拒绝覆盖已有同版本产物。

Linux/macOS 需要 Bash、rsync；打包还需 zip：

./build.sh --target linux/amd64
cp config.example.json config.json
# 编辑 config.json 后启动
./dist/artex-linux-amd64/artex -addr 127.0.0.1:8787 -proxy 127.0.0.1:8788

后端 go run ./cmd/artex；另一终端进入 web，执行 npm ci、npm run dev -- --port 5173。前端 API 默认反代后端 8787。未配置模型时没有预置模型，也不会自动调用供应商。开发指南 记录代码入口与配置优先级。

• 业务和模型凭据保存在自己的 PostgreSQL；工作区与录制文件在应用数据目录。JWT 签名密钥首次运行随机生成。
• 不提交或转发 config.json、.env、jwt.key、secrets.key、data/、日志、抓包和备份；源码忽略规则覆盖这些文件。
• 制作一致备份前停止任务、应用和代理；恢复使用新的空数据库与新的数据目录。
• 2.4.0 开发版将模型密钥、搜索密钥、代理地址、模型入口、通知配置及 MCP 参数/环境/入口加密存入数据库，独立密钥为程序目录中的 secrets.key（打包程序所在目录；go run 时为当前工作目录）。ARTEX_CONFIG 只决定配置 JSON 的位置，不改变密钥位置。已有明文凭据在启动时事务迁移；缺失、损坏或错误的密钥会中止启动，保留数据库和原文件。
• 加密密钥独立于 jwt.key；改密码不会更换凭据加密密钥。备份必须使用 -IncludeLocalCredentials -EncryptionKey .\secrets.key 一起封装原密钥，或用 -KeyStoredSeparately 明确声明已另行备份。包含密钥时工具会验证它能解密数据库凭据。恢复后将 local/secrets.key 放回程序目录，不能放入可浏览的工作区。
• 加密保护数据库静态凭据；应用运行时仍需解密使用。本地数据库连接配置和运行日志不属于上述数据库字段加密范围，仍需保管配置目录。
• 从 2.3.x 升级至 2.4.0 前，先用旧版本备份工具制作完整加密备份，并保留旧程序、数据库连接配置和 JWT 密钥。2.4.0 会加密旧数据库中的凭据；2.3.x 不能直接读取这些密文。因此退回 2.3.x 时，需要恢复升级前的数据库与工作区备份，不能只替换旧二进制。恢复使用新的空库和新目录，保留原数据库以便核对。
• 连接已有数据库会保留原有记录并执行幂等迁移。“首次为空白”指新建数据库，不会清空旧数据库。
• 下载包可与发行页 SHA256SUMS 对比：Get-FileHash .\artex-2.4.0-windows-amd64.zip -Algorithm SHA256。

遵守 AGPL-3.0，保留 ARTEX 源码来源及版权。修改后通过网络向其他用户提供服务时，按许可证提供对应源码。

字体和前端模板许可见 第三方说明。UI 参考 Amicro，产品布局与流程按 DITING 调整。

常规回归使用本机模拟供应商，不调用真实 LLM。每次运行创建新的隔离 PostgreSQL 数据库，设置 ARTEX_PG_DSN 后执行 go test -p 1 -count=1 ./... 和 go vet ./...；不得连接正在使用的业务数据库。共享数据库的各包顺序执行，避免启动迁移与夹具清理互相干扰。

前端在 web/ 执行 npm test、npx tsc --noEmit 和 npm run build:static。PR 工作流额外检查发行包的私有文件排除和嵌入前端的首次安装；Windows 作业验证守护启动脚本的升级、重启和回滚。工作流不发布版本。

打包后运行 python scripts/check-package.py <发行包.zip>。空库检查通过 DITING_FRESH_PG_DSN 明确指定全新隔离数据库，再执行 python scripts/run-fresh-install.py <程序路径> <版本号>；脚本复制程序到临时目录、移除继承的模型密钥，检查密码初始化、接口鉴权与空业务列表，然后停止测试程序。数据库向导回归另用全新本地测试库（名字须为 diting_setup_<唯一后缀>），设置 DITING_SETUP_PG_DSN，执行 python scripts/run-setup-install.py <程序路径>。它验证缺失配置、失败/成功连接测试、同进程启动、密码初始化、环境鉴权、空业务状态和模型保存/激活，使用不可用的本机模型入口，不发送模型测试请求。真实模型验收独立人工执行并设置预算。