从零开始搞懂容器部署：手把手带你用 Docker 把项目送上服务器

最近不少朋友在后台问笔者，说自己本地写好的项目，一到服务器上就跑不起来，环境变量、依赖版本、系统库缺失……各种问题能把人折磨到怀疑人生。其实，这类痛点早就有了标准解法，那就是 Docker 容器部署。

今天这篇文章，我们不聊虚的，直接上手实操。笔者会带着你从理解核心概念开始，一步步把一个真实项目打包成镜像，然后部署到云服务器上并成功运行。读完这篇文章，你不仅能搞定部署，还能避开那些新手最容易踩的坑。

一、为什么大家都在用容器部署？先搞清楚它解决了什么问题

在 Docker 出现之前，部署一个应用通常意味着你要在一台干净的服务器上手动安装各种依赖。比如部署一个 Python 应用，你得先装 Python 解释器、pip 包管理器，再装 Nginx、Redis，还得小心翼翼地处理版本兼容问题。更惨的是，如果你同时部署两个项目，一个需要 Python 3.7，另一个需要 Python 3.10，那服务器环境基本就乱套了。

Docker 的核心逻辑是“镜像”与“容器”。你可以把镜像理解成一个包含了应用代码、运行环境、系统依赖的“压缩包”，而容器就是这个压缩包运行起来后的独立进程。每个容器之间相互隔离，互不干扰。

这样做的好处显而易见：环境一致性。在本地能跑，在服务器上就一定能跑，因为运行环境被完整地封装在了镜像里。

二、部署前的准备工作：服务器与基础软件

要玩转容器部署，你首先得有一台属于自己的云服务器。这里笔者多说一句，千万不要为了省几十块钱去买那种配置极低、口碑堪忧的小作坊服务器。部署讲究的是稳定与安全，建议选择大厂正规云服务商，比如阿里云、腾讯云，或者国际上的 AWS、DigitalOcean。如果你只是个人学习或跑轻量级业务，2核4G 的配置基本够用，带宽按量付费即可。

操作系统方面，笔者推荐使用 Ubuntu 22.04 LTS 或 Debian 12，这两款系统的软件源更新及时，社区资料丰富，遇到问题也容易搜到解决方案。

服务器到手后，第一步就是安装 Docker。按照官方文档执行以下命令即可：

# 更新软件源
sudo apt update

# 安装依赖
sudo apt install -y ca-certificates curl

# 添加 Docker 官方 GPG 密钥
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 添加 Docker 软件源
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# 启动 Docker 并设置开机自启
sudo systemctl enable docker --now

安装完成后，运行 docker --version 验证是否成功。如果能看到版本号，说明 Docker 已经就绪。

三、实战：将一个 Node.js 项目打包成镜像

光说不练假把式，我们直接拿一个简单的 Node.js Web 服务来演示。假设你的项目根目录下有一个 app.js 文件，内容是一个监听 3000 端口的 HTTP 服务。

为了让 Docker 知道如何构建这个项目，我们需要在项目根目录创建一个名为 Dockerfile 的文件（注意没有扩展名）。这个文件就是镜像的“配方”。

一个标准的 Node.js 项目的 Dockerfile 长这样：

# 指定基础镜像
FROM node:18-alpine

# 设置工作目录
WORKDIR /app

# 先拷贝 package.json，利用 Docker 缓存机制加速构建
COPY package*.json ./

# 安装依赖
RUN npm install --registry=https://registry.npmmirror.com

# 拷贝项目源码
COPY . .

# 暴露端口
EXPOSE 3000

# 容器启动时执行的命令
CMD ["node", "app.js"]

这里有几个细节值得注意：

• 基础镜像选择：node:18-alpine 比完整版镜像小很多，只有几十 MB，拉取速度快，且安全性更高。
• 利用缓存：先拷贝 package.json 再拷贝源码，是为了在依赖没变的情况下，Docker 构建时能直接命中缓存层，避免重复安装依赖。
• 换源：在国内服务器上，npm install 经常因为网络问题卡死。这里推荐使用淘宝镜像源，速度飞快。

写好 Dockerfile 后，在项目根目录执行构建命令：

sudo docker build -t my-node-app:latest .

参数 -t 用于给镜像打标签，格式是 名称:版本。构建完成后，可以通过 sudo docker images 查看本地镜像列表。

四、运行容器并实现外部访问

镜像构建成功，接下来就是运行容器了。执行以下命令：

sudo docker run -d --name my-app -p 8080:3000 my-node-app:latest

这条命令的参数解释如下：

参数	含义
-d	后台运行容器（detach 模式）
--name	给容器起一个自定义名字，方便管理
-p 8080:3000	端口映射。将服务器的 8080 端口映射到容器内的 3000 端口

此时，你通过浏览器访问 http://你的服务器IP:8080，就能看到应用输出内容了。

如果发现访问不了，优先检查三件事：

• 云服务商的安全组策略是否放行了 8080 端口。
• 服务器本地的防火墙（ufw status）是否拦截了该端口。
• 容器是否真的在运行（sudo docker ps 查看状态）。

五、进阶操作：使用 Docker Compose 编排多容器应用

真实项目往往不止一个服务。比如你的应用还需要 MySQL 数据库，总不能手动去启动两个容器再配置网络吧？这时候就需要用到 Docker Compose。

Compose 允许你通过一个 docker-compose.yml 文件来定义和运行多个容器。我们创建一个简单的编排文件：

version: '3.8'

services:
  app:
    build: .
    ports:
      - "8080:3000"
    depends_on:
      - db
    environment:
      - DB_HOST=db
      - DB_PORT=3306

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=yourpassword
      - MYSQL_DATABASE=appdb
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

在这个配置中，我们定义了两个服务：app 和 db。app 服务会基于当前目录的 Dockerfile 构建镜像，db 服务直接拉取 MySQL 官方镜像。通过 depends_on 指定启动顺序，确保数据库先于应用启动。

启动所有服务只需要一条命令：

sudo docker compose up -d

查看实时日志用 sudo docker compose logs -f，停止并移除所有服务用 sudo docker compose down。可以说，Compose 让多容器管理变得异常轻松。

六、部署后的日常运维与常见坑

容器跑起来只是第一步，日常运维才是重头戏。这里笔者总结几个高频问题及解法。

1. 容器日志疯狂增长，撑爆磁盘

默认情况下，Docker 会保存所有容器的标准输出日志。如果不加限制，日志文件能涨到几个 GB。解决办法是在 /etc/docker/daemon.json 中配置日志轮转：

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

配置完成后执行 sudo systemctl restart docker 使其生效。注意，该配置只对新建容器有效，老容器需要重建。

2. 容器重启后数据丢失

容器是无状态的，一旦被删除，容器内写入的文件也会随之消失。如果你有需要持久化的数据（比如数据库文件、上传的图片），务必使用 Volume 挂载。在 docker run 命令中加入 -v /宿主机路径:/容器内路径 即可。

3. 镜像更新后如何平滑升级

当代码更新后，你需要重新构建镜像并替换旧容器。标准流程是：

# 重新构建镜像
sudo docker build -t my-node-app:latest .

# 停止并删除旧容器
sudo docker stop my-app && sudo docker rm my-app

# 启动新容器
sudo docker run -d --name my-app -p 8080:3000 my-node-app:latest

如果你的服务不能中断，可以使用 docker compose up -d --build 实现滚动更新。

七、写在最后的建议

容器部署的本质是“一次构建，到处运行”。它极大地降低了部署门槛，但也对开发者的网络架构知识提出了新要求。笔者建议你在学习过程中，多动手去部署几个不同类型的项目，比如 Python FastAPI、Java Spring Boot 或者静态前端项目（用 Nginx 容器托管）。

另外，关于服务器选择，笔者再啰嗦一句：请务必选择正规云厂商。有些朋友贪图便宜，买了不知名小厂的“超低价”服务器，结果三天两头宕机，数据丢失投诉无门。一份价钱一分货，稳定的基础设施才是业务长久运行的基石。如果你还没有服务器，趁着云厂商有新人优惠时入手一台轻量应用服务器，性价比非常高。

好了，今天的分享就到这里。希望这篇文章能帮你真正跨过“部署”这道坎。如果你在实操中遇到任何报错，欢迎在评论区留言，我们一起探讨解决。