opensecurity/nodejsscan Docker 镜像 - 轩辕镜像

nodejsscan

nodejsscan是一款基于libsast和semgrep的Node.js应用静态安全代码扫描器（SAST），专注于检测Node.js代码中的安全漏洞。

核心功能与特性

• 静态安全扫描：对Node.js应用代码进行静态分析，识别安全漏洞
• 多引擎支持：基于libsast和semgrep实现精准的代码模式匹配与漏洞检测
• 多接口访问：提供Web用户界面、命令行界面（CLI）和Python API
• 告警集成：支持Slack和Email告警，实时推送扫描结果
• CI/CD兼容：可集成至GitHub Action、GitLab CI/CD、Travis CI等流程
• 可视化报告：通过Web界面展示扫描结果、漏洞统计图表和详细分析

使用场景与适用范围

• Node.js应用的安全审计与漏洞评估
• 开发阶段的代码安全检查，提前发现潜在风险
• CI/CD流水线中的自动化安全扫描环节
• 安全团队对Node.js项目的批量代码安全检测

使用方法与配置说明

Docker快速部署

通过Docker直接运行nodejsscan：

bash
# 拉取镜像
docker pull opensecurity/nodejsscan:latest

# 启动容器（映射9090端口）
docker run -it -p 9090:9090 opensecurity/nodejsscan:latest

启动后，访问[***]即可使用Web界面。

本地部署（开发环境）

前置条件

• Python 3.7+
• PostgreSQL数据库

部署步骤

1. 克隆代码库并进入目录：

bash
git clone [***]
cd nodejsscan

2. 创建并激活虚拟环境：

bash
python3 -m venv venv
source venv/bin/activate  # Linux/macOS

3. 安装依赖：

bash
pip install -r requirements.txt

4. 配置数据库连接：

   • 修改nodejsscan/settings.py中的SQLALCHEMY_DATABASE_URI
   • 或设置环境变量：export SQLALCHEMY_DATABASE_URI="postgresql://user:password@host:port/dbname"

5. 初始化数据库：

bash
python3 manage.py recreate-db  # 首次运行创建数据库 schema

6. 启动服务：

bash
./run.sh

服务将运行在[***]。

命令行界面（CLI）与API

• CLI使用：参考njsscan CLI文档
• Python API：参考njsscan API文档

环境变量配置

集成配置

Slack告警

1. 创建Slack App获取Webhook URL
2. 通过环境变量或配置文件设置SLACK_WEBHOOK_URL

邮件告警

在nodejsscan/settings.py或环境变量中配置SMTP参数（SMTP服务器地址、端口、认证信息等）。

CI/CD集成

• GitHub Action：配置指南
• GitLab CI/CD：配置指南
• Travis CI：配置指南

构建Docker镜像（本地）

如需自定义构建Docker镜像：

bash
# 构建镜像
docker build -t nodejsscan .

# 运行本地镜像
docker run -it -p 9090:9090 nodejsscan