n8n-nodes-starter

克隆即写自定义 n8n 节点，快速接入任意 API

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署自动化工作流 🍴 复刻 688 🐛 待处理 19 👀 关注 19

GitHub ↗

GitHub 星标 ★ 1189

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源免费，需自行部署

项目预览

n8n-nodes-starter 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类自动化工作流

开发团队n8n-io

GitHubhttps://github.com/n8n-io/n8n-nodes-starter

定价模式🏷️完全免费

价格说明开源免费，需自行部署

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

GitHub 星标★ 1189

上线时间2019-10-03 00:00:00

代码更新2026-09-13

仓库体积591 KB

本站数据更新2026-11-04

维护状态维护中

收录时间2026-09-20

浏览次数2

项目介绍

n8n-nodes-starter 是 n8n 官方提供的自定义节点开发模板，面向希望扩展 n8n 自动化能力的开发者。n8n 本身是一个开源工作流自动化工具，内置节点有限，当需要对接私有 API、内部系统或小众服务时，就需要自行编写节点。本项目提供了一套开箱即用的 TypeScript 工程骨架，包含节点定义、凭证配置、构建脚本、测试与发布流程的标准结构，解决从零搭建节点项目繁琐、容易遗漏配置的问题。核心能力包括：标准化节点与凭证类结构、基于 TypeScript 的类型提示、可运行的示例节点、npm 打包与 n8n 社区节点发布所需的基础配置。开发者克隆后即可专注于业务逻辑，快速产出可安装到 n8n 的自定义节点，适合集成企业内网服务或第三方平台。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-20 · 当前星标 ★ 1189

使用教程

难度：进阶约 10 分钟部署方式：命令行工具 5 步

环境要求

Node.js 与 npm 环境（npm install / npm run 均依赖）
本地可运行的 n8n 环境，用于加载开发中的节点
了解 TypeScript 基础，便于读懂示例节点
发布到 npm 需准备 npm 账号与 GitHub 仓库

安装与启动步骤

1创建节点包

README 推荐的最快起步方式，用官方脚手架生成完整的节点包工程结构。
```
npm create @n8n/node
```
2安装依赖

在项目根目录执行，会安装全部依赖，包含 n8n 官方节点开发 CLI。
```
npm install
```
3启动开发调试

以开发模式启动 n8n 并加载你写的节点，开启热重载，改代码即时生效。
```
npm run dev
```
4阅读示例节点

参考 Example 节点的基础 execute 写法，以及 GithubIssues 的声明式低代码写法。
5配置 npm 发布

登录 npmjs.com 进入包设置，在 Publish access 的 Trusted Publishers 添加发布者。

关键配置

配置项	必填	说明	示例
`Repository owner`	是	Trusted Publisher 中填写的 GitHub 用户名或组织名	`your-github-name`
`Repository name`	是	Trusted Publisher 中填写的仓库名称	`your-repo-name`
`Workflow name`	是	Trusted Publisher 中填写的工作流文件名	`publish.yml`
`NPM_TOKEN`	否	不使用 OIDC 时，改为存放 npm 传统令牌的 Actions secret	`npm_xxxxxxxxxxxx`