如何在Vercel Serverless Node.js应用中通过apt get安装软件包
Vercel Serverless Node.js 应用安装apt系统包的实操指南
直接在函数运行阶段跑apt-get是肯定走不通的——Vercel的Serverless运行容器是只读临时环境,没有root权限,所有系统层的安装动作必须前置到构建流程完成,具体的实操和避坑点整理如下。
先讲为什么直接跑apt不行
- Vercel运行Serverless函数的时候,用的是只读的临时root文件系统,连写临时目录之外的位置都受权限限制,更别说开放root权限让你跑apt安装了。就算侥幸在某次请求里把包装上了,等请求结束容器直接销毁,下一次冷启动换个全新容器,这个包又会消失,完全是无效操作。
- 真正能自由操作系统、跑apt的阶段只有构建环节:Vercel会分配一个带root权限的Debian环境,执行你的npm install、项目构建脚本,只有在这个环节装的包,才会被跟着项目一起打包到最终的函数部署产物里,运行的时候可以直接调用。
可直接落地的操作方法
方法1:在构建命令里嵌入apt安装流程
这是最贴近原生apt操作习惯的方案,适合安装轻量、没有冗余依赖的小工具:
- 找到项目根目录的
vercel.json,把原本的构建命令修改为“先执行apt装包,再跑原有构建流程”,同时一定要加清理逻辑减少安装体积:
{ "buildCommand": "apt-get update && apt-get install -y 你要装的包名 --no-install-recommends && rm -rf /var/lib/apt/lists/* && 你原本的构建命令(比如npm run build)" }
- 实际踩坑提醒:Vercel对单个Serverless函数的解压后体积有限制,超过250MB会直接部署失败。这个方法只适合安装单包体积在几十MB以内的场景,如果是带几百MB冗余依赖的大型软件,很容易触发体积上限。
方法2:优先用Node生态预编译包替代系统apt
90%的场景根本没必要折腾apt,直接用npm上带Linux预编译二进制的包就能实现同样功能,稳定性比自行安装系统包高很多:
- 比如要做图片压缩处理直接用
sharp,要做基础媒体转码用对应的带静态二进制的npm包即可——这类包在执行npm install阶段,就会把对应Linux x64架构的二进制文件放到node_modules目录里,跟着函数一起打包部署,全程不触碰系统层,不会出现跨环境兼容性问题。
方法3:手动引入静态编译二进制绕开apt流程
如果遇到必须使用特定版本软件、apt源里的版本不符合要求的场景,操作更简单:直接下载对应Linux x64架构的静态编译版二进制文件,放到项目的资源目录中。
- 写代码调用二进制时,直接指定项目内的绝对路径执行,完全不需要依赖系统层的apt安装,也不会占用系统目录空间,连构建阶段的apt步骤都可以省略。
绝对要避开的无效操作
- 别把apt安装逻辑写在接口的运行代码里(也就是用户请求触发后才执行的代码),只要涉及对只读根目录的写入操作,100%会因为权限不足报错。
- 执行apt安装时一定要加
--no-install-recommends参数,避免自动安装一堆用不上的推荐依赖;安装完成后必须删除/var/lib/apt/lists/*下的缓存文件,不然会平白增加几十MB的部署体积,压缩都无法抵消这部分占用。 - 别尝试自定义Docker镜像挂载到Vercel的Serverless运行时,官方没有开放这个自定义能力,折腾半天只会导致部署失败。
内容的提问来源于stack exchange,提问作者Dinesh Kumar
相关产品推荐
相关产品推荐

