# AI 生成的 Docker 项目怎么上线

> AI 给了你带 Dockerfile 的项目？容器部署的最短路径：本地验证、打包上传、平台构建发布，以及常见构建失败排查。
> 最近更新：2026-09-05
> 官方地址：https://mashangjia.com/guides/docker-ai-deploy/

## 直接答案

带 `Dockerfile` 的项目说明它需要运行时环境（后端、数据库连接等）。部署方式：把**整个项目目录**（含 Dockerfile）打成 zip 上传到支持容器部署的平台，平台会构建镜像并运行。码上架支持这种形态，免费版也可体验（zip 上限 50MB，以官网说明为准）。

## 上传前的三个检查

**1. Dockerfile 真的能 build**

有条件的话本地验证一次：

```bash
docker build -t my-app . && docker run -p 8080:8080 my-app
```

AI 写的 Dockerfile 常见问题是基础镜像拉取失败或启动命令写错——本地能跑，平台基本就能跑。

**2. 别把 node_modules / .git / venv 打进 zip**

这些是部署时重新生成的，打进去只会超限（50MB 上限）。`node_modules` 删掉再打包通常能小 90%。

**3. 端口和环境变量**

确认 Dockerfile 里 `EXPOSE` 的端口和程序监听端口一致；数据库地址、API key 这类用环境变量注入，不要写死在代码里。

## 部署步骤（码上架）

1. 项目目录打成 zip。
2. 打开 [码上架](https://mashangjia.com/) 上传——平台检测到 Dockerfile 会走容器构建通道。
3. 构建完成后得到网址。也可以让 AI Agent 读 [https://mashangjia.com/ai](https://mashangjia.com/ai) 契约自动完成全过程。
4. 正式使用记得注册认领站点。

## 常见构建失败

| 症状 | 原因 | 处理 |
|---|---|---|
| build 卡在拉镜像 | 基础镜像源被墙 | 换国内可达镜像源或更常见的基础镜像 |
| 启动后立刻退出 | CMD 写错/程序崩溃 | 本地 `docker run` 复现，看日志修 |
| 端口连不上 | EXPOSE 与实际监听不一致 | 统一成平台约定的端口（契约里有说明） |
| zip 超限 | 打包了依赖目录 | 删 node_modules/.git/venv 重打 |

## FAQ

**Q：只有 docker-compose.yml 没有 Dockerfile 行么？**
码上架支持 docker-compose manifest 形态的项目（以公开能力文档为准）。

**Q：容器项目能用免费版吗？**
可以体验，但容器构建消耗的资源远高于静态站，正式运营建议按套餐评估。

## 下一步

- 不认识 Docker 这些词，项目其实是静态的：[AI 写完网站怎么上线](/guides/ai-website-how-to-publish/)。
- 想让 AI Agent 全自动处理：[Claude Code 做完网站怎么发布](/guides/claude-code-deploy-website/)（其他 Agent 同理）。