Vercel 终于支持 Dockerfile 部署了？实测与全流程指南

最近在折腾项目部署的时候，发现一个让很多开发者都兴奋的消息：Vercel 居然开始支持 Dockerfile 部署了！对于习惯了用容器打包应用的同学来说，这绝对是个不小的福音。毕竟以前在 Vercel 上部署那些非 Node.js 原生的生态（比如 Python、Go 或者某些特殊的二进制程序），总是有点束手束脚，各种 Build Command 玩出花来也不如一个 Docker 来得实在。

今天就来带大家实测一下这个功能，看看它到底靠不靠谱，以及我们该如何利用这个新特性。

为什么这是个好消息？

在此之前，Vercel 的强项在于它的“零配置”体验，尤其是对 Next.js、React 等前端框架的支持简直无敌。但如果你有一个后端服务是用 Python 写的，或者你需要安装系统级的依赖，以前你需要依靠 Vercel 提供的 Runtime 或者奇技淫巧的 package.json 脚本来解决。

Vercel 控制台的 Build & Development Settings 设置界面，当检测到 Dockerfile 时构建选项会自动调整。

现在有了 Dockerfile 支持，意味着：

环境变量自动注入机制示意图，Vercel 会将设置好的变量自动传入 Docker 容器的构建与运行环境中。

1. 环境一致性：本地开发环境（Docker）和生产环境终于可以做到 100% 一致了。
2. 语言无关性：理论上任何能打包进 Docker 镜像的语言都能跑，比如 Java、C++、Rust 等。
3. 依赖管理更简单：不再需要担心 Vercel 的构建环境缺了什么系统库，你在 Dockerfile 里装的什么，线上就有什么。

实测配置步骤

n 那么，怎么在 Vercel 上开启这个功能呢？目前来看，流程非常简单，甚至比配置 Nixbox 还要直观。

1. 准备 Dockerfile

首先，在你的项目根目录下创建一个标准的 Dockerfile。不需要特殊的 Vercel 注解，只要能构建出可监听端口的 Web 服务即可。

FROM node:18-alpine
WORKDIR /app
COPY . .
RUN npm install
RUN npm run build
CMD ["npm", "start"]

注意：Vercel 会自动检测到你的 Dockerfile 并试图使用它来构建。你的应用必须监听 0.0.0.0 的端口，并且通过环境变量 PORT 来获取端口号（就像在 Heroku 上一样），因为 Vercel 会动态分配端口。如果你的应用强行监听 80 或 3000 端口，部署大概率会失败。

2. 推送代码与配置

将代码推送到 GitHub/GitLab，然后在 Vercel 控制台导入项目。

• 如果 Vercel 检测到根目录下有 Dockerfile，它在 Settings > General > Build & Development Settings 中可能会自动将 Build Command 和 Output Directory 留空，转而直接调用 Docker 构建流程。
• 在某些情况下，你可能需要在项目设置中明确指定“Docker”作为构建环境（如果界面选项还没完全铺开，通常默认检测即可）。

3. 环境变量处理

在 Vercel 的环境变量设置页面的所有变量，在容器构建和运行时都会被自动注入。这一点非常友好，你不需要在 Dockerfile 里写死 API Key 或者数据库密码。

限制与注意事项

n 虽然听起来很美好，但目前实测来看，这个功能虽然放出来了，但并不是完全没有限制的。

1. 构建时间与镜像大小

Vercel 的免费版 Hobby 账户对构建时长和最终产物大小是有严格限制的。如果 Dockerfile 层数太多，或者下载的依赖包巨大（比如装了一个巨大的 Anaconda 环境），很容易触发超时或者报错。

建议：尽量使用 alpine 等精简基础镜像，并在 COPY 之前充分利用 Docker 缓存层，避免每次修改一行代码就重新下载所有依赖。

2. 缓存机制

Vercel 的 Docker 镜像层缓存策略与传统的 Docker Hub CI/CD 可能略有不同。如果你发现构建速度莫名其妙变慢，可以尝试在 package.json 或者依赖安装步骤上下点功夫，确保依赖层的变化不那么频繁。

3. Serverless 还是 Container？

需要注意的是，在 Vercel 的底层实现中，这种 Dockerfile 部署可能依然运行在他们的 Serverless Container 环境中。这意味着：

• 无状态：不要在容器里写本地文件，重启就没了。
• 冷启动：虽然有容器预热，但如果长时间没人访问，再次访问可能会经历一个容器启动的过程，对于启动缓慢的 Java 应用来说，首屏延迟可能会比较明显。

适用场景推荐

n 基于目前的体验，我强烈建议在以下场景尝试使用这个功能：

• 非 Node.js 后端服务：比如 FastAPI (Python)、Gin (Go) 项目，以前通过 vercel-python 等适配器很麻烦，现在直接丢 Dockerfile 最稳。
• 复杂依赖的爬虫/工具：需要安装 Chromium、Puppeteer 或者其他系统级库的工具。
• 微服务架构：配合 Vercel 的边缘网络，将一些逻辑较重的 API 从前端剥离出来单独部署。

总结

Vercel 支持 Dockerfile 是其迈向通用云平台的重要一步。对于个人开发者或小团队来说，这使得我们在选择技术栈时不再受限于 Vercel 的原生 Runtime，自由度大大提升。

如果你手头正好有被卡在 Vercel 部署门槛上的老项目，不妨今天就去试一试这个新功能，或许就能把那台吃灰的传统 VPS 给关掉了。