Vercel 终于支持 Dockerfile 了！部署方式迎来大变革

大家期盼已久的功能终于来了！Vercel 正式官宣支持通过 Dockerfile 进行项目部署。对于习惯了用 Docker 打包应用的开发者来说，这绝对是个重磅利好。这意味着我们不再受限于 Vercel 原生构建器的那些条条框框，自由度大大提升。

为什么这个更新很重要？

在此之前，如果你想用 Vercel 部署应用，通常得乖乖使用它支持的那些框架（Next.js、Nuxt、Create React App 等）或者特定的 Runtime。一旦你的项目依赖比较奇葩，或者需要特定的系统级库，构建过程往往会让人头大，不得不硬塞进 package.json 的 script 里或者求助于 Function Overrides，操作起来非常反人类。

现在，直接扔给它一个 Dockerfile，剩下的自己定。这就是标准化的威力。

新旧部署方式对比

传统的 Build Output 模式

• 限制多：必须遵循 Vercel 的目录结构和构建规范，某些非 Node.js 语言支持并不完美。
• 黑盒构建：虽然能覆盖大部分场景，但遇到底层依赖问题时很难排查，因为构建环境是锁定的。
• 配置繁琐：需要配置 vercel.json 以及各种框架特定的隐藏文件。

全新的 Dockerfile 模式

• 高度自定义：你拥有完全的 Linux 环境控制权，装什么依赖、跑什么服务，全看你 Dockerfile 怎么写。
• 环境一致性：本地能跑起来， Docker 构建能过，Vercel 上就没问题。解决了“在我电脑上是好的”这类玄学问题。
• 多语言/栈友好：Go、Rust、Python 复杂环境甚至 Java 应用，只要有 Docker 镜像，理论上都能跑。

实战教程：如何用 Dockerfile 部署到 Vercel

既然是用 Docker，那流程就非常丝滑了。下面以一个简单的 Node.js 应用为例，演示整个迁移过程。

标准的 Node.js Dockerfile 示例，注意端口必须暴露 3000

第一步：准备 Dockerfile

在你的项目根目录下创建一个名为 Dockerfile 的文件。

这里要注意一点，Vercel 期望你的容器是一个 Web 服务，并且必须监听 3000 端口（这是硬性要求，不支持自定义其他端口）。如果你的 Dockerfile 之前暴露的是 8080 或其他端口，记得改过来。

一个标准的 Node.js Dockerfile 示例：

# 使用官方 Node.js 镜像作为基础镜像
FROM node:18-alpine

# 设置工作目录
WORKDIR /app

![Vercel 项目设置中的 Build & Development Settings 界面](/media-load/019f1cc9-5e6f-799e-a1a6-fc1542bd0971)

*Vercel 项目设置界面，确保 Build Command 等配置正确*

# 将依赖文件复制到容器中
COPY package*.json ./

# 安装依赖
RUN npm install

# 将项目其余文件复制到容器中
COPY . .

# 构建应用（如果需要）
RUN npm run build

# 暴露端口（必须是 3000）
EXPOSE 3000

# 启动应用
CMD ["npm", "start"]

第二步：配置 Vercel

你不需要改太多配置，Vercel 很智能，它会自动检测根目录下是否有 Dockerfile。一旦检测到，它会默认忽略 package.json 里的 build 命令，转而去执行 Docker 的构建流程。

不过，为了保险起见，建议你检查一下项目设置中的 Build & Development Settings：

1. 确保 Build Command 留空或者设置为与 Docker 构建相关的指令（通常留空即可，因为它会读取 Dockerfile 内部的指令）。
2. Output Directory 也可以留空。
3. Install Command 通常也忽略，因为包安装都在 Dockerfile 里通过 RUN 完成了。

第三步：推送并部署

接下来的操作就和我们平时用 Vercel 一样了。把代码推送到 GitHub，或者通过 Vercel CLI 直接上传。

Vercel 会拉取代码，识别到 Dockerfile，然后启动一个 Docker Build 构建任务。你会看到日志里出现了熟悉的 Docker 构建输出。

⚠️ 常见坑与解决方案

Q: 构建时报错 “Port 3000 not exposed” 或者部署后 502？ A: 检查你的 Dockerfile，确保有 EXPOSE 3000，且你的应用启动命令确实在监听 0.0.0.0:3000。很多框架默认监听 localhost，这在容器化环境会连不上，需要改为监听所有网卡。

Q: 构建太慢或者超时怎么办？ A: Vercel 对 Docker 构建有时间限制（通常在十几分钟内）。尽量优化你的 Dockerfile，比如利用缓存层，先复制依赖文件再安装依赖，最后才复制源代码。使用更小的基础镜像（如 alpine 版）也能显著提速。

Q: 能用 Docker Compose 吗？ A: 暂时不行。Vercel 目前只支持单个 Dockerfile 的构建。如果你有数据库等依赖，建议连用 Vercel 的 Postgres/Storage 或者连接外部托管数据库，而不是试图在同一个容器里塞满所有服务。

适用场景分析

虽然有了 Dockerfile 很爽，但也并非所有项目都需要一窝蜂地切过去。

强烈推荐使用：

• 使用非主流语言或框架的项目（如 Dart、C++ 后端）。
• 需要特定系统级依赖的项目（如 Puppeteer、FFmpeg、ImageMagick 等）。
• 对本地与生产环境一致性有极高要求的企业项目。

保持原样即可：

• 标准的 Next.js、Nuxt.js 全栈项目。Vercel 原生支持对这些框架做了深度优化，构建速度通常比 Docker 更快，边缘网络支持也更好。
• 简单的静态站点。

总结

Vercel 支持 Dockerfile 是一个非常务实的改进。它在保持了 Serverless 平台“零运维”便利性的同时，通过拥抱容器的标准化，打通了更广泛的生态边界。对于喜欢折腾、需求复杂的开发者来说，这无疑是把锁链给解开了。快去看看你的项目能不能用这种方式重构一下吧！