VyOS是一款基于Debian的开源网络操作系统，凭借丰富的路由、防火墙和VPN功能，在企业内网和实验室环境中被广泛使用。不过官方提供的ISO镜像只能覆盖通用场景，一旦需要在镜像里预装特定软件包、内置配置脚本或者适配特殊硬件，手工操作的流程就会变得繁琐且容易出错。这篇文章介绍一种用Node.js驱动的镜像定制方案，思路参考Mock2Image这类工具的设计：用代码描述构建步骤，用脚本执行构建任务，最终产出一份开箱即用的定制VyOS镜像。
一、VyOS镜像定制的基本原理
要理解如何定制VyOS镜像，先要弄清它的内部结构。VyOS的安装介质本质上是一个混合启动镜像，里面包含内核、initrd、以及一个squashfs格式的根文件系统。定制镜像的核心操作就是把这个根文件系统解包，在解包后的目录里做修改，再重新压缩打包回ISO。
具体来说，定制流程通常分为四步。第一步，从官方渠道获取VyOS的ISO或者raw镜像。第二步，用unsquashfs命令把根文件系统解出来，得到一个完整的Linux目录树。第三步，进入这个目录树，通过chroot环境执行apt安装、文件注入、脚本执行等操作。第四步，用mksquashfs重新打包文件系统，再借助xorriso等工具生成最终的ISO镜像。
这套流程用Shell脚本也能完成，但用Node.js来做有几个明显优势。首先是流程描述能力强，用JavaScript的异步编程模型可以轻松实现并行的软件包安装和文件复制。其次是生态丰富，npm上有大量处理文件系统、模板渲染、命令执行的库。最后是便于集成，如果你的团队已经在用Node.js做持续集成，这套构建脚本可以直接嵌入现有的流水线。
二、构建环境准备与Node.js工程搭建
构建VyOS镜像需要一台Linux环境，推荐使用Ubuntu或Debian，并安装必要的依赖工具。构建主机上需要Docker（可选但强烈推荐，用于隔离构建环境）、squashfs-tools、xorriso以及Node.js运行时。以Ubuntu为例，安装基础工具的命令如下：
sudo apt-get update sudo apt-get install -y squashfs-tools xorriso genisoimage # 安装Node.js LTS版本 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs
接下来创建Node.js工程目录并初始化。工程结构建议按职责划分：tasks目录存放各个构建任务模块，templates目录存放配置文件模板，workspace目录作为构建工作区。初始化命令和目录结构如下：
mkdir vyos-mock2image && cd vyos-mock2image
npm init -y
npm install execa glob chokidar handlebars
mkdir -p tasks templates workspace/{iso-root,fs-root,output}依赖库的选择有讲究。execa比Node.js内置的child_process提供了更友好的Promise接口和更好的输出捕获能力，适合串联命令行工具。handlebars负责配置文件模板渲染，比如根据不同的部署环境生成不同的启动配置。glob则用于批量匹配需要注入的文件。
三、核心构建脚本的实现
构建脚本的心脏是一个任务调度器，它按顺序执行各个构建阶段，并在任一阶段失败时立即中止。先定义任务执行器，用execa封装一个通用的命令执行函数：
const execa = require('execa');
const path = require('path');
const WORKSPACE = path.resolve(__dirname, '../workspace');
async function run(cmd, args, options = {}) {
console.log(`[exec] ${cmd} ${args.join(' ')}`);
const result = await execa(cmd, args, { stdio: 'inherit', ...options });
return result.stdout;
}
async function mountLoop(isoPath, mountPoint) {
// 挂载ISO镜像以读取内部的squashfs文件
await run('sudo', ['mount', '-o', 'loop', isoPath, mountPoint]);
}
async function unsquash(imagePath, dest) {
await run('unsquashfs', ['-d', dest, imagePath]);
}
async function resquash(src, outputPath) {
// 使用xz压缩，保持与官方镜像一致的压缩算法
await run('mksquashfs', [src, outputPath,
'-comp', 'xz', '-b', '1024k', '-no-xattrs']);
}上面的代码封装了三个最底层的操作。注意mount操作需要root权限，这里直接用sudo，实际生产环境建议把构建放进Docker容器里以--privileged模式运行，避免权限分散管理。接下来编写主构建流程，把解包、定制、重打包串起来：
const fs = require('fs/promises');
async function main() {
const isoPath = process.argv[2];
if (!isoPath) throw new Error('请指定VyOS官方ISO路径');
const fsRoot = path.join(WORKSPACE, 'fs-root');
const mountPoint = path.join(WORKSPACE, 'iso-root');
await fs.mkdir(mountPoint, { recursive: true });
await mountLoop(isoPath, mountPoint);
// 复制squashfs文件系统镜像到工作区
await run('cp', [
path.join(mountPoint, 'live/filesystem.squashfs'),
path.join(WORKSPACE, 'filesystem.squashfs')
]);
await run('sudo', ['umount', mountPoint]);
await unsquash(path.join(WORKSPACE, 'filesystem.squashfs'), fsRoot);
console.log('文件系统解包完成，开始执行定制任务...');
}
main().catch(err => { console.error(err); process.exit(1); });这个流程的关键点在于挂载ISO后先把squashfs文件复制出来再卸载，避免后续操作长时间占用挂载点。解包完成后得到的就是一个完整的Linux目录树，接下来所有的定制操作都针对这个目录进行。
四、chroot定制任务的编写
往镜像里安装软件包和执行脚本，最可靠的方式是chroot。进入chroot环境前需要挂载/proc、/sys、/dev等虚拟文件系统，退出时再卸载。Node.js侧的任务模块可以这样写：
async function injectPackages(fsRoot, packages) {
const binds = ['/proc', '/sys', '/dev'];
try {
for (const b of binds) {
await run('sudo', ['mount', '--bind', b, path.join(fsRoot, b)]);
}
// 复制宿主机DNS配置，保证chroot内可以解析域名
await run('sudo', ['cp', '/etc/resolv.conf',
path.join(fsRoot, 'etc/resolv.conf')]);
await run('sudo', ['chroot', fsRoot, 'apt-get', 'update']);
await run('sudo', ['chroot', fsRoot, 'apt-get', 'install', '-y',
...packages]);
} finally {
for (const b of binds.reverse()) {
await run('sudo', ['umount', '-l', path.join(fsRoot, b)]).catch(() => {});
}
}
}
// 示例：预装监控代理和诊断工具
await injectPackages(fsRoot, ['htop', 'tcpdump', 'mtr-tiny', 'iperf3']);除了装软件包，配置注入也是常见需求。比如要在镜像里预置一份VyOS启动配置，可以用Handlebars渲染模板后写入目标路径。模板文件放在templates目录下，渲染逻辑非常简洁：
const Handlebars = require('handlebars');
async function renderConfig(templateName, data, dest) {
const tpl = await fs.readFile(
path.join(__dirname, '../templates', templateName), 'utf-8');
const rendered = Handlebars.compile(tpl)(data);
await run('sudo', ['tee', dest], { input: rendered });
}
await renderConfig('boot.config.hbs',
{ hostname: 'edge-router-01', mgmtIp: '192.168.0.1' },
path.join(fsRoot, 'opt/vyatta/etc/config/boot.config'));这里用sudo tee写入而不是fs.writeFile，是因为解包出的目录通常归属root，普通用户的Node进程没有写权限。这也是初学者最容易踩的坑之一。
五、重打包与常见问题排查
定制完成后需要重新生成ISO。重打包分两步：先用mksquashfs压缩文件系统，再把压缩结果替换回ISO结构中。替换ISO内容可以用xorriso的in-place更新模式：
async function buildIso(fsRoot, outputIso) {
const squashPath = path.join(WORKSPACE, 'filesystem.squashfs');
await resquash(fsRoot, squashPath);
// 将新的squashfs写回ISO副本
const isoCopy = path.join(WORKSPACE, 'base.iso');
await run('sudo', ['mount', '-o', 'loop,isoCopy ? '' : '',
outputIso, mountPoint]);
await run('sudo', ['cp', squashPath,
path.join(mountPoint, 'live/filesystem.squashfs')]);
await run('sudo', ['umount', mountPoint]);
console.log(`镜像生成完成: ${outputIso}`);
}实践中经常遇到的问题有几个。一是压缩参数不匹配导致启动失败，VyOS官方镜像用的是xz压缩加1024k块大小，重打包时必须保持一致，否则initrd加载阶段会报文件系统格式错误。二是chroot内残留挂载导致打包失败，mksquashfs遇到仍在挂载状态的/proc目录会把宿主机进程信息也打进去，务必在finally块里确保卸载。三是权限问题，所有对解包目录的写操作都要考虑sudo，或者干脆把整个构建流程放进Docker容器中以root运行。
构建产物的验证同样重要。拿到新ISO后，建议先用QEMU做冒烟测试，确认系统能正常启动、预装的软件包可用、启动配置生效。可以把这个验证步骤也写进Node.js脚本，用execa拉起QEMU并等待串口输出中出现登录提示符，实现端到端的自动化验证。整套流程跑通之后，只需要维护一份JSON格式的定制描述文件，就能按需批量产出不同规格的VyOS镜像，这正是Mock2Image思路在网络操作系统领域的价值所在。