企业官网建设流程全解析

一、基础本地使用（无需独立部署服务，仅本地安装工具）

scanoss-py是 SCANOSS 官方 Python 客户端命令行工具，本质是本地 CLI 扫描工具，不是服务程序：

方案 1：官方源（优先，国内镜像可能同步延迟）

pip install scanoss -i https://pypi.org/simple/

方案 2：国内清华镜像源（网络慢时使用）

pip install scanoss -i https://pypi.tuna.tsinghua.edu.cn/simple --default-timeout=100

三、安装后验证（使用 scanoss-py 命令）

scanoss-py --version

输出版本号即代表安装成功，后续扫描命令和之前一致，仅安装包名修正。

1. 使用逻辑：
   • 直接本地调用scanoss命令扫描代码目录；
   • 扫描依赖两种模式： 1）在线扫描：调用 SCANOSS 公有云 API，无需自己部署后端； 2）离线本地引擎：下载轻量化扫描引擎到本地，完全断网扫描，依然不用部署服务。
2. 部署判定：不需要搭建、启动、运维后台服务，仅本地安装包，属于工具安装，不叫部署。

二、私有化全栈场景（需要部署 SCANOSS 服务端，scanoss-py 仅作客户端）

企业内网、隔离环境、私有合规要求时：

1. 需单独部署：scanoss-server（SCANOSS 后端服务、数据库、规则库），用 Docker 容器部署；
2. scanoss-py角色：只是客户端，安装在 CI / 构建机器、开发机，对接私有部署的scanoss-server；
3. 完整流程：部署后端服务 → 所有机器安装 scanoss-py → CLI 指定私有服务地址扫描。

三、CI / 流水线集成场景

Jenkins、GitLab CI、GitHub Action 中：

1. 流水线步骤里临时pip install scanoss-py，用完即销毁；
2. 无长期驻留程序、无端口监听、无后台进程；
3. 无部署动作，只是临时安装工具执行扫描。

总结一句话

1. 单纯代码扫描、使用公有云 / 本地离线引擎：scanoss-py 不用部署，pip 安装即用；
2. 企业私有化内网，自建 SCANOSS 后台：需要部署服务端，scanoss-py 仅客户端无需部署。

补充区分：部署 vs 安装

• 部署：启动长期运行的后台服务、监听端口、持久化运行（scanoss-server 属于部署）；
• 安装：本地命令行工具，单次执行、运行结束退出（scanoss-py 仅安装，无部署）。