开发工具运维【免费下载链接】distributionsNodeSource Node.js Binary Distributions项目地址https://gitcode.com/gh_mirrors/di/distributions点击查看免费下载本篇技术指南以 NodeSource 官方开源仓库distributions中的 scripts/rpm/script_generator/README.md 为骨架结合仓库内的 base_script.sh 与 generator.sh 源码系统讲解 RPM 系 Linux 发行版上 Node.js 一键安装脚本的设计思路、批量生成机制、底层仓库配置原理以及生成后的部署流程。读完本文你将掌握如何修改版本号、如何一键重新生成全套setup_XX.x脚本、如何理解.repo文件各字段含义以及如何用 AWS CLI 把脚本发布到 S3 存储桶。一、脚本体系概览一个模板、一套生成器、N 个版本脚本在仓库的scripts/rpm/目录下同时存放着两类文件模板与生成器scripts/rpm/script_generator/子目录base_script.sh所有版本脚本的公共模板版本号以占位符NODE_VERSIONXX.x形式存在和generator.sh批量生成脚本。生成产物scripts/rpm/目录顶层setup_16.x、setup_18.x、setup_20.x、setup_21.x、setup_22.x、setup_23.x、setup_24.x、setup_25.x以及两个特殊脚本setup_current.x当前版本与setup_lts.xLTS 长期支持版本。从源码确认当前generator.sh中维护的版本列表为(23 24 25)其中lts_version24、current_version25generator.sh。因此实际生成的setup_lts.x指向 24.x、setup_current.x指向 25.x这与 setup_lts.x 中的NODE_VERSION24.x、setup_current.x 中的NODE_VERSION25.x完全吻合。仓库中还保留了 16.x、21.x 等旧版本产物说明同一生成器曾经维护过更长的版本清单历史版本可参考 OLDER_DISTROS.md。注原 README 中描述“当前版本是 20.x、最新版本是 21.x”是文档编写时的快照仓库实际内容已演进到 24.x LTS / 25.x current本文以仓库源码为准。二、如何修改与运行版本脚本2.1 修改版本号每个版本脚本的核心区别只有一行NODE_VERSIONXX.x。以 setup_18.x 为例若想把它改成安装 Node.js 20.x只需把NODE_VERSION18.x改为NODE_VERSION20.x其余逻辑仓库地址拼接、架构校验、包管理器探测全部由模板驱动无需改动。2.2 运行脚本进入脚本所在目录后以 root 身份执行sudo bash setup_XX.x其中XX.x换成目标版本号例如sudo bash setup_18.x该脚本的作用是配置 NodeSource 的 RPM 软件源并刷新元数据而不是直接安装 Node.js。脚本执行完成后需要根据脚本探测到的包管理器执行对应的安装命令见下文第五节。三、生成器原理从模板批量产出版本脚本当模板base 脚本发生改动比如调整了日志格式、仓库 key 地址或新增了架构支持时你不需要手动同步十几个脚本只需重新运行生成器bash generator.sh其工作流程generator.sh如下检查./base_script.sh是否存在不存在则报错退出遍历版本列表versions(23 24 25)对每个版本调用create_scriptcreate_script用sed把模板中的占位符替换为真实版本号输出到../setup_XX.x随后chmod x赋予执行权限最后以lts_version24、current_version25生成setup_lts.x与setup_current.x两个别名脚本。核心替换命令为sed s/NODE_VERSION\XX.x\/NODE_VERSION\$version.x\/g $base_script $target_scriptsed把NODE_VERSIONXX.x精确替换为NODE_VERSION23.x等目标值其余内容原样复制。由于占位符XX.x在所有版本脚本中语义一致该方案天然支持“改一处、全量同步”的维护模式。从源码结构看create_script的第二个参数$script_name允许“版本号”与“脚本名”解耦——例如版本24可以生成名为lts的脚本这正是setup_lts.x、setup_current.x得以存在的机制。四、base 脚本逐段剖析RPM 源配置的完整原理理解生成产物的最佳方式是读懂模板 base_script.sh。它依次完成以下步骤4.1 系统判定必须是 RPM 系发行版if ! [ -f /etc/redhat-release ] ! grep -q Amazon Linux /etc/system-release 2/dev/null; then handle_error 1 This script is intended for RPM-based systems. Please run it on an RPM-based system. fi同时兼容两类判定路径存在/etc/redhat-releaseRHEL、CentOS、Fedora 等或/etc/system-release中出现 Amazon LinuxAmazon Linux 2 / 2023 不带 redhat-release 文件。4.2 清理旧源避免版本冲突rm -f /etc/yum.repos.d/nodesource*.repo在写入新源之前先删除所有历史遗留的nodesource*.repo文件防止多个版本仓库并存导致 dnf/yum 解析冲突。4.3 架构校验SYS_ARCH$(uname -m) case $SYS_ARCH in aarch64|x86_64) log Supported architecture: $SYS_ARCH info ;; *) handle_error 1 Unsupported architecture: $SYS_ARCH. Only aarch64 and x86_64 are supported. ;; esacRPM 仓库仅支持x86_64与aarch64arm64两种架构其他架构直接报错退出。这也与 DEV_README.md 中 RPM 可用架构清单x86_64、arm64一致。4.4 写入 Node.js 仓库文件NODEJS_REPO_CONTENT[nodesource-nodejs] nameNode.js Packages for Linux RPM based distros - $SYS_ARCH baseurlhttps://rpm.nodesource.com/pub_${NODE_VERSION}/nodistro/nodejs/$SYS_ARCH priority9 enabled1 gpgcheck1 gpgkeyhttps://rpm.nodesource.com/gpgkey/ns-operations-public.key module_hotfixes1 echo $NODEJS_REPO_CONTENT | tee /etc/yum.repos.d/nodesource-nodejs.repo /dev/null各字段含义如下字段值作用[nodesource-nodejs]repo iddnf/yum 引用该仓库的唯一标识name描述文本仓库显示名称附带当前架构便于识别baseurlhttps://rpm.nodesource.com/pub_${NODE_VERSION}/nodistro/nodejs/$SYS_ARCH仓库实际地址NODE_VERSION决定安装哪个 Node.js 大版本SYS_ARCH决定拉取哪个架构的 RPMpriority9数值越小优先级越高当多个仓库提供同一软件包时dnf 优先采用该仓库的版本enabled1布尔启用该仓库gpgcheck1布尔强制校验 RPM 包 GPG 签名gpgkey签名公钥地址NodeSource 使用 SHA256 签名见 DEV_README.md 中“RPM Package Signing Key”说明公钥从ns-operations-public.key获取module_hotfixes1布尔允许该仓库绕过模块流module stream限制避免与系统模块版本的 nodejs 冲突4.5 LTS 版本额外配置 N|Solid 仓库当NODE_VERSION属于 LTS 系列当前判断条件为20.x、22.x、24.x时脚本会追加写入第二个仓库文件NSOLID_REPO_CONTENT[nodesource-nsolid] nameN|Solid Packages for Linux RPM based distros - $SYS_ARCH baseurlhttps://rpm.nodesource.com/pub_${NODE_VERSION}/nodistro/nsolid/$SYS_ARCH priority9 enabled1 gpgcheck1 gpgkeyhttps://rpm.nodesource.com/gpgkey/ns-operations-public.key module_hotfixes1 echo $NSOLID_REPO_CONTENT | tee /etc/yum.repos.d/nodesource-nsolid.repo /dev/null log Added N|Solid repository for LTS version: $NODE_VERSION info这意味着只有 LTS 版本20.x/22.x/24.x才同时提供 N|Solid Runtime 软件源非 LTS 版本如 25.x只配置 Node.js 仓库。如果你打算在生产环境使用 N|Solid 做 Node.js 性能监控与运行时加固应选择 LTS 脚本。4.6 包管理器探测与元数据刷新脚本按优先级探测三种包管理器并只启用刚配置的仓库刷新缓存--disablerepo* --enablereponodesource-nodejs避免全量刷新引入无关仓库优先级包管理器元数据刷新命令最终安装命令1dnfdnf makecache --disablerepo* --enablereponodesource-nodejsdnf install nodejs -y2yumyum makecache ...yum install nodejs -y3microdnf容器场景microdnf makecache ...microdnf install nodejs -y无三者均不存在—报错退出若当前为 LTS 版本还会额外刷新nodesource-nsolid仓库并提示可安装 N|Soliddnf install nsolid -y对应 yum/microdnf 命令同理。这一点对应 README 中“检测 dnf/yum/microdnf 并用可用包管理器更新系统”的说明。4.7 公共基础函数模板头部定义了三个通用工具函数供上述流程复用log()按类型info/success/error输出带 ANSI 颜色和时间戳的日志其中成功为粗体绿色、错误为粗体红色handle_error()打印带退出码的错误信息并以指定码退出command_exists()基于command -v探测命令是否存在。五、运行脚本后的安装闭环base 脚本只负责“配置源 刷新元数据”。以 24.x LTS 为例完整安装流程为# 1. 配置仓库并刷新输出会提示下一步命令 sudo bash setup_24.x # 2. 安装 Node.js sudo dnf install nodejs -y # Fedora / RHEL 9 / Amazon Linux 2023 # 或 sudo yum install nodejs -y # 使用 yum 的系统 # 或 sudo microdnf install nodejs -y # 精简容器环境 # 3. 验证 node -v对于 LTS 版本若需要 N|Solid RuntimeNode.js 的监控/加固运行时改为sudo dnf install nsolid -y nsolid -v六、生成与部署从本地脚本到 CDN 分发6.1 重新生成全套脚本修改模板后运行bash generator.sh输出形如Creating script for Node.js version 23.x Script created successfully: ../setup_23.x Execute permissions set for: ../setup_23.x ...所有顶层脚本将被覆盖更新且均带可执行权限。6.2 部署到 S3生成器位于scripts/rpm/script_generator/而脚本产物在scripts/rpm/顶层。官方推荐用 AWS CLI 同步到 NodeSource 的 RPM 分发桶aws s3 sync scripts/rpm/ s3://rpm.nodesource.com/ --exclude */**命令要点sync只上传有变化的文件适合频繁重建脚本后的增量发布--exclude */**排除所有子目录即只同步scripts/rpm/顶层的setup_XX.x文件不会把script_generator/内部的模板和生成器上传实际使用时把s3://rpm.nodesource.com/替换为你自己的存储桶路径。部署完成后用户即可通过https://rpm.nodesource.com/setup_XX.x拉取脚本——这也是 DEV_README.md 中 RPM 安装指引curl -fsSL https://rpm.nodesource.com/setup_XX.x -o nodesource_setup.sh所对应的发布链路。6.3 全流程关系图base_script.sh模板NODE_VERSIONXX.x │ generator.shsed 替换占位符 ▼ setup_23.x setup_24.x setup_25.x setup_lts.x setup_current.x │ aws s3 sync scripts/rpm/ s3://rpm.nodesource.com/ --exclude */** ▼ s3://rpm.nodesource.com/RPM 分发桶 │ curl -fsSL https://rpm.nodesource.com/setup_XX.x ▼ 最终用户在 RPM 系机器上执行 → 配置 yum.repos.d 源 → dnf/yum/microdnf 安装 nodejs七、版本维护建议与注意事项改版本先改生成器不要手工逐个改setup_XX.x应修改 generator.sh 中的versions数组以及必要时调整lts_version/current_version然后重新生成保证模板与产物一致。LTS 判断是硬编码列表当前base_script.sh用20.x、22.x、24.x三个字符串判断 LTS新增 LTS 版本时需同步更新该条件否则新 LTS 版本不会生成 N|Solid 仓库。架构受限RPM 源仅支持x86_64与aarch64在 i386/ppc64le 等架构上脚本会直接拒绝执行。签名校验默认开启gpgcheck1保证从 NodeSource 拉取的包都经过 GPG 签名验证不要在生产环境随意关闭。部署用 sync 而非 cpaws s3 sync配合--exclude */**既能增量发布又能避免误传生成器源码更换存储桶时务必替换为自有路径。八、延伸阅读生成器与模板源码generator.sh、base_script.sh已生成脚本示例setup_24.x、setup_lts.x、setup_current.xDEB 系Debian/Ubuntu对应实现scripts/deb/script_generator/README.md、scripts/deb/script_generator/base_script.sh完整安装/卸载指引与发行版支持矩阵DEV_README.md旧版按发行版捆绑安装器文档OLD_README.md、OLDER_DISTROS.md仓库许可LICENSE.md赞分享开发工具运维【免费下载链接】distributionsNodeSource Node.js Binary Distributions项目地址https://gitcode.com/gh_mirrors/di/distributions点击查看免费下载相关推荐10分钟掌握NodeSource安装脚本生成器从原理到实战10分钟掌握NodeSource安装脚本生成器从原理到实战 作为Node.js开发者你是否曾困惑于不同Linux发行版 Node.js 安装脚本的差异是否开发工具运维Fleet 批量建队与安装包生成实战解读 team-builder 脚本的工作原理Fleet 批量建队与安装包生成实战解读 team builder 脚本的工作原理 导读 tools/team builder 是 Fleet 仓库中一个用于后端前端企业应用运维网络安全KVzap-linear-Qwen3-8B终极指南革命性KV缓存剪枝技术如何加速LLM推理KVzap linear Qwen3 8B终极指南革命性KV缓存剪枝技术如何加速LLM推理 KVzap linear Qwen3 8B是由NVIDIA开发的革创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考