开篇：为什么我们需要一套企业内部开发者平台？

一、传统研发团队的共同痛点

绝大多数中大型企业研发团队都会遇到一模一样的协作难题：

1. 资产分散，查找成本极高
   微服务、中间件、文档、流水线、代码仓库散落在 GitLab、Jenkins、Confluence、监控平台等十余个系统。想了解一个服务的归属、负责人、CI流程、接口文档，需要跨系统多人询问，效率极低。
2. 项目创建流程无标准化
   新建业务服务时，每个人的初始化模板、分支规范、流水线配置、权限配置各不相同，架构混乱、维护成本高，新人上手学习曲线极长。
3. CI/CD、代码仓库割裂
   代码仓库与构建流水线完全分离，新建项目后需要手动在Jenkins新建任务、配置Git凭证、手动绑定Webhook，重复机械工作多，极易出现配置遗漏。
4. 研发信息不透明
   团队服务资产、系统依赖、责任人、生命周期无统一视图，线上故障排查、架构梳理、团队交接都缺乏统一信息入口。

在这样的背景下，IDP（Internal Developer Platform，内部开发者平台） 成为云原生时代企业DevOps的标准解决方案。而由Spotify开源、CNCF孵化的 Backstage，是目前生态最完善、插件化能力最强、落地案例最多的开源IDP平台。

二、什么是 Backstage？

引用官方定义：

An open platform for building developer portals（用于搭建开发者门户的开源平台）

Spotify 内部自研多年后于2020年开源，现已拥有超2300+企业落地实践，GitHub星标2.8w+。它不只是一个前端页面，而是一套完整、可高度定制、插件化的统一研发入口底座。

Backstage核心三大核心能力：

1. 软件目录（Software Catalog）：统一管理企业所有服务、组件、API、团队、人员资产，提供全局检索视图；
2. 软件模板（Scaffolder）：标准化项目初始化流程，一键创建GitLab/GitHub代码仓库并自动绑定流水线；
3. 插件生态系统：官方与社区提供GitLab、Jenkins、监控、文档、API网关等上百款插件，按需集成企业现有工具链。

三、本系列教程整体规划

整套教程分为五大核心章节，循序渐进，由浅入深，从理论到落地定制，贴合企业私有化部署真实场景：

第1篇：Backstage简单介绍｜背景、架构与生态

讲解项目开源背景、CNCF孵化历程、前后端三层架构（数据层/逻辑层/展示层）、插件市场、企业落地价值，建立整体认知。

第2篇：Backstage项目架构与目录详解

拆解项目完整目录树，说明核心配置文件app-config.yaml、模板目录examples/template、前后端packages、自定义插件存放目录的作用，看懂项目源码结构。

第3篇：从零搭建Backstage基础项目

保姆级本地搭建教程：环境依赖（NodeJS/Yarn）安装、脚手架创建项目、前后端单独启动、验证页面访问，完成基础环境跑通。

第4篇：Backstage深度集成GitLab

企业最核心集成场景：GitLab插件安装、全局仓库配置、自定义软件模板适配私有GitLab、一键创建仓库完整流程实操、页面功能验证。

第5篇：Backstage集成Jenkins & 自定义流水线创建脚手架

完整打通CI链路：Jenkins前后端插件接入、服务页面Jenkins Tab展示、自定义Scaffolder Action插件，创建项目时自动生成Jenkins Pipeline任务、自动绑定Git凭证。

四、阅读本教程前置要求

• 基础前端知识：React、TypeScript基础认知；
• DevOps基础：GitLab、Jenkins基本使用经验；
• 命令行基础：Node、Yarn包管理器操作；
• YAML配置文件读写基础。

五、你能从这套教程学到什么

1. 完整掌握 Backstage 核心设计思想与分层架构；
2. 独立完成本地私有化环境搭建、企业定制化改造；
3. 打通代码仓库+CI流水线，实现项目一键标准化创建；
4. 掌握Backstage自定义脚手架Action开发，实现业务自动化；
5. 具备企业级IDP平台二次开发、插件扩展能力，可落地内部统一研发门户。

六、写在最后

当下很多企业仍在使用零散的DevOps工具链，研发协作效率低下。Backstage凭借极致插件化、轻量化、开源免费的优势，成为中小企业落地IDP成本最低的方案。

本系列全部基于真实企业私有化部署场景编写，避开官方文档碎片化、示例简陋的问题，全部配套页面截图、完整可运行配置、业务逻辑讲解。
接下来，我们正式进入第一篇：Backstage基础介绍。