AI Security Tool 是一款免费的开源 AI 安全终端与漏洞扫描器（支持 CVE、SBOM 分析），内置多协议终端（SSH、SFTP、RDP、VNC 等）和 12+ 个自主 AI Agent。本文带你用 3 步完成AI Security Tool Web 版部署：从一键脚本启动，到浏览器访问 5577 端口，全程无需手动配置复杂环境。

一、认识 AI Security Tool：为什么选择 Web 版部署

AI Security Tool 定位于"安全运维 + 渗透测试 + CTF + DevSecOps"一体化的 AI 原生平台，核心能力包括：

Web 版的最大优势是部署快：官方提供一行命令安装脚本，自动装好 Go、Python、Node.js 等全部依赖并解压启动，适合快速在个人电脑或测试服务器上体验完整功能。

二、第 1 步：获取项目并一键运行启动脚本

1.1 克隆仓库

先把项目代码拉到本地：

git clone https://gitcode.com/gh_mirrors/ai/ai-security-tool cd ai-security-tool

1.2 Linux / macOS：一行命令启动

bash scripts/one-line-web.sh

对应脚本见 scripts/one-line-web.sh。

1.3 Windows：以管理员身份运行

打开 PowerShell 或 CMD（管理员），执行：

scripts\one-line-web.bat

脚本内部会依次完成以下工作（详见 scripts/one-line-web.bat）：

1. ✅ 通过 WinGet 自动安装Go、Python 3.12、Node.js LTS
2. ✅ 下载项目运行所需的压缩包
3. ✅ 自动解压到桌面目录并执行安装

💡 你不需要提前手动安装任何依赖，脚本会全部代办，这就是"一键脚本"的含义。

三、第 2 步：等待脚本自动完成环境与启动

脚本运行期间保持终端窗口不要关闭，它会依次输出安装进度。整个过程大致包括：

• 安装依赖：Go / Python / Node.js（已安装则自动跳过）
• 下载并解压：拉取 Web 运行包并解压到本地目录
• 启动服务：解压完成后自动拉起 Web 服务进程

当终端不再滚动新的安装日志、服务进程常驻运行时，说明 Web 服务已就绪。

⏱️ 首次运行需要下载依赖，耗时取决于网络环境，耐心等待即可。

四、第 3 步：浏览器访问 5577 端口

服务启动成功后，打开浏览器，在地址栏输入：

http://127.0.0.1:5577

看到这个页面，说明AI Security Tool Web 版部署成功🎉。进入后你可以直接使用多协议终端、查看 AI Agent 状态、发起 CVE/SBOM 扫描。

常见问题快速排查

五、进阶：部署到服务器时的安全配置

如果要把 Web 界面暴露到外网或公网服务器，强烈建议先配置.env环境变量再启动，避免无密码访问风险：

ENABLE_AUTH=1 # 启用密码认证 DISABLE_LOCAL_TERMINAL=1 # 禁用对本机终端的直接访问 SERVER_SECRET=your_server_secret_key SERVER_PASS=your_strong_password

配置完成后，执行启动脚本即可：

./run-ai-security-tool-web.sh

⚠️安全提示：AI Security Tool 的 AI Agent 具备执行系统命令的能力。对外暴露 Web 界面时，务必开启认证（ENABLE_AUTH=1）、禁用本地终端（DISABLE_LOCAL_TERMINAL=1），并遵循最小权限原则运行。合法使用范围仅限你拥有授权的系统。

六、写在最后

回顾一下这 3 步：克隆仓库 → 一键运行启动脚本 → 浏览器访问http://127.0.0.1:5577。整个过程不需要手动配置运行环境，脚本自动完成依赖安装与解压，普通用户也能在几分钟内跑起 AI 安全终端与漏洞扫描的 Web 界面。

更多项目介绍、模块列表与更新记录，可参考仓库中的 README.md，以及 downloads/ 与 modules/ 目录下的离线页面。