Web 控制台

Web 控制台是 SIREN Server 的浏览器入口。它覆盖日常远程操作：Project 工作区、客户端列表、浏览器 Shell、Agentic IR、调查任务、文件管理、Artifacts 和 Dossier。需要在控制主机终端里直接操作时，可以改用 服务端 REPL。

启动与访问

启用 webui.enabled 时，Web 控制台会随 siren_server 启动。默认监听 0.0.0.0:8080：

./siren_server

启动后访问：

http://<SIREN Server IP>:8080

账号鉴权

Web 控制台使用 Session Cookie 鉴权。账号密码存储在 SQLite 数据库中，密码会先做 bcrypt 哈希，默认数据库路径是 data/users.db。

管理用户账号

./siren_server user add <username>

./siren_server user list

./siren_server user delete <username>

webui:
  userDBPath: /opt/siren/data/users.db

功能页面

Projects

Project 是应急响应工作区，用于把客户端、Artifacts 目录和操作目标放到同一个上下文中。每个 Project 创建时会固定一个服务端目录，例如 /opt/siren/my-project。

Projects 页面支持：

• 创建 Project，并可指定目录名。目录名只能是 basename，最终目录必须位于 webui.projectsBaseDir 下。
• 复制 Project 目录路径，便于在控制主机上查看或归档。
• 重命名 Project。重命名只修改显示名，不移动目录。
• 删除 Project。删除只移除元数据并解除客户端归属，目录和文件会保留。
• 在 Global 视图和 Project 视图之间切换。Project 视图只显示当前 Project 的客户端和取证目录。

客户端最多归属到一个 Project。未归属客户端只在 Global 视图中出现；进入 Project 视图后，Clients、Shells、Agentic IR、Files 和 Investigations 都只允许选择当前 Project 的客户端。

Clients

Clients 页面对应服务端 REPL 的 ls、note、allow、deploy 和 clean。每行展示一个在线客户端，支持：

• 按 ID、系统、地址、备注或 Project 筛选，并按主要字段排序。
• 多选客户端后批量分配 Project 或执行清理。
• 编辑备注。备注绑定到客户端稳定身份，客户端重连后会自动恢复。
• 分配 Project。Global 视图中可以把客户端分配到某个 Project，或移回未归属状态。
• 打开快捷入口。从客户端行可直接进入 Files 或 Process Analysis。
• 执行 SOAR 操作，包括 allow 放行、单机部署、批量部署。
• 查看近期部署任务。页面刷新后仍可恢复当前进度和最近结果，进行中的任务每 2 秒更新一次。
• 清理客户端。单个或批量清理都会要求输入确认短语后再执行 Clean & Terminate。

部署结果分为 success、partial 和 failed。只有所有目标均已连接且没有 warning 时才会清空输入；部分成功、失败或超时会保留原输入，便于核对和修正。近期列表最多显示 20 次部署，可以完全收起；终态记录最长保留 30 分钟。这些记录只存在于当前服务端进程，服务端重启后不会恢复。

Shells

Shells 页面提供浏览器内的交互式终端，每个客户端可以打开多个终端标签。切换到其他页面时，已打开的 Shell 会话仍会保持运行；回到 Shells 页后可以继续输入。

Project 视图下，Shell 只能连接当前 Project 的客户端。切换 Project 或切回 Global 时，Web 控制台会关闭不属于新视图的活动 Shell，避免继续操作错误项目中的主机。

Agentic IR

Agentic IR 页面在浏览器内嵌终端中运行 Claude Code、Codex 或 Qoder，用于完成 Agentic 应急响应。页面支持选择 Provider、新建会话，或恢复当前视图工作目录对应的历史会话。

新建会话可选以下入口模式：

• Manual，不带 SIREN 上下文的裸 CLI 终端，适合临时通用操作。
• Custom，选择客户端并输入应急响应指令。
• Event，选择客户端并输入阿里云 UID 和云安全中心告警 ID，由服务端拉取告警详情。

也可以切换到 Resume 模式，搜索并选择当前视图工作目录对应的历史会话，用原 session ID 在终端中继续该会话。

左侧的 Running 会显示任务、客户端、Provider、状态和启动时间；History 会显示首个任务、最近一条可见对话、分支和更新时间，便于在恢复前确认会话内容。

会话托管在服务端。刷新浏览器或切换页面后，可以重新接入并回放此前输出，进程不会因为页面离开而中断。除 Manual 外，会话会使用 SIREN MCP，因此需要启用 MCP 服务。Project 视图下的工作目录、历史恢复和 MCP 作用域规则见 Agentic 应急响应。

Investigations

Investigations 页面汇总需要等待结果的调查工具，目前包含 AccessKey 调查、客户端 Recon 和进程分析。

• AccessKey，输入阿里云 UID、AccessKey ID 和可选 Region，生成 Markdown 调查报告。Region 留空时默认 cn-hangzhou。AccessKey 调查不绑定客户端，报告写入 Global Artifacts。
• Recon，选择在线客户端并下发信息收集命令。页面展示服务端从客户端日志中解析出的阶段，例如 Recon.Basic、Recon.User、Recon.Process 和 Save report to Artifacts。
• Process Analysis，选择 Linux 客户端后，按 PID、监听端口或进程名查询进程详情。按名称匹配到多个进程时，页面会列出候选项，点击候选 PID 后继续分析。
• 报告入口，调查结束后会显示 Open Artifacts 按钮。Recon 报告跟随客户端 Project 归属保存；已归属客户端写入 Project 目录，未归属客户端写入 Global Artifacts。

Files

Files 页面用于浏览在线客户端的本机文件系统。可以从左侧导航进入后选择客户端，也可以在 Clients 列表中点击某个客户端行的 Files 快捷入口。Project 视图下只能选择当前 Project 的客户端。

常用操作：

• 选择客户端，或从 Clients 页面跳转后自动选中对应客户端。
• 打开路径。Linux/macOS 默认从 / 打开，Windows 默认从 C:\ 打开，也可以在 Path 输入框中输入指定路径。
• 预览文本文件。二进制文件会显示不可预览提示。
• 下载文件或目录。目录会打包为 tar.gz。
• 点击 Upload 选择一个或多个文件，或把多个文件拖到页面任意位置，上传到顶部 Target 显示的当前目标目录。文件会按顺序上传，单文件上限 100 MiB；目标文件已存在时会逐个要求覆盖或跳过。拖拽不支持上传目录。

Artifacts

Artifacts 页面管理服务端取证目录。Global 视图使用 siren_server 工作目录；Project 视图使用当前 Project 创建时固定的目录。常见场景是查看 Recon、AIR 和 AccessKey 调查生成的 Markdown 报告，或管理从客户端拉取到服务端的取证文件。

支持的操作：

• 预览文本文件。.md 和 .markdown 会渲染为 Markdown；包含多个标题时会显示目录。
• 预览 PNG、JPEG、GIF 和 WebP 图片。图片默认适应预览区，也可以切换到 100% 或在 25%-400% 范围内缩放查看细节。
• 下载文件或目录。目录会打包为 tar.gz，并自动排除点号开头的文件和子目录。
• 点击 Upload 选择一个或多个文件，或把多个文件拖到页面任意位置，上传到顶部 Target 显示的当前目标目录。文件会按顺序上传，单文件上限 100 MiB；目标文件已存在时会逐个要求覆盖或跳过。拖拽不支持上传目录。
• 新建目录、重命名和删除文件或目录。删除非空目录会递归删除其中内容。
• 从 .md 报告进入 Dossier 编辑。.markdown 可以预览，但不会显示 Dossier 编辑按钮。
• 保护隐藏路径。.env、.ssh 等点号开头的文件或目录不会列出，也不允许直接访问。

Dossier

Dossier 是独立的 Markdown 报告编辑器，有两种打开方式：

• 从左侧导航点击 Dossier，打开 webui.dossierDir/report.md。即使当前处于 Project 视图，也不会自动切换到 Project 目录下的 report.md。
• 在 Artifacts 中选中 .md 报告后，点击 Dossier 按钮编辑该报告。如果当前是 Project 视图，报告文件和粘贴资源会保留在 Project 目录内。

Dossier 未部署、路径配置错误或默认 report.md 缺失时，Web 控制台会显示错误提示，但不影响其他功能。

详细部署、配置、语法和编辑流程见 Dossier 文档。

配置

在 server_config.yaml 的 webui 段落配置：

webui:
  enabled: true                         # 是否启用 Web 控制台
  listen: 0.0.0.0                       # 共享 HTTP 监听地址
  port: 8080                            # 监听端口（与 MCP 共享）
  userDBPath: /opt/siren/data/users.db  # 可选：用户数据库绝对路径
  dossierDir: /opt/siren/dossier        # 可选：Dossier 编辑器文件目录
  projectsBaseDir: /opt/siren/projects  # 可选：Project 目录创建基准路径

mcp:
  enabled: true                         # 是否启用 MCP 服务

Web 控制台与 MCP 共用监听地址和端口，但启停开关相互独立。完整配置项见 配置文件。

生产部署建议

相关内容