5441 字
27 分钟
一台服务器多项目生产实战
2026-11-15

写到这一篇,前面所有单点知识都要收口了。部署、网络、日志、安全、备份、监控、反向代理,每一篇单看都成立,但真把它们一起搬上同一台服务器跑生产,问题立刻换了一副面孔:不再是「某个功能不会用」,而是「十个项目互相干扰、一起出事」。这篇就是整合篇,给出一套能长期维护的单机多项目整体方案:一项目一目录一 Compose、网络与资源双隔离、一个反代统一出口、日志备份监控全部走全局基线,最后附一张上线巡检清单。

先看乱象:单机多项目跑久了会出什么事#

如果你已经在一台服务器上堆了几个月容器,下面这些场景大概率眼熟。先把乱象列清楚,后文每一节都是在逐条拆解它们:

乱象典型事故根因本篇解法
端口大杂烩新项目 docker compose up 直接报 port is already allocated,或者更糟——抢注成功,老项目被顶掉所有项目都往宿主机乱绑端口,没有登记、没有规划端口只绑 127.0.0.1 且仅在确有必要时绑,对外统一走反代(第五节)
资源无上限一个项目内存泄漏,OOM Killer 先杀掉的却是隔壁的数据库,整台机器一起陪葬容器默认可以吃满整机 CPU 和内存每项目资源配额模板,提前圈好上限(第四节)
日志爆盘某天凌晨磁盘 100%,所有容器写不进去集体异常,排查半天发现是一个跑了三个月的容器日志写了 40 GB没给日志做轮转基线,docker system df 从没看过daemon.json 全局日志基线 + 单项目覆盖(第六节)
改一处崩一片给 A 项目加个环境变量,顺手 docker compose down 了共用的那份大杂烩 Compose 文件,B、C 项目跟着下线多个项目挤在同一份 Compose、同一个默认网络里,命运被绑在一起一项目一目录一 Compose,网络各自独立(第二、四节)
网络全互通所有容器都在默认 bridge 或同一张网里,任何一个服务被攻破,攻击者能直接横向访问所有项目的数据库没有做网络隔离,数据库端口在容器网络里对所有人敞开每项目独立网络,只有反代进公共网络(第四节)
备份靠想起来磁盘坏了才发现:数据卷从没备份过,Compose 文件改过十几版,一版都没存档没有固定的备份节奏,配置没有版本管理卷定时备份 + 配置进 Git(第六节)
更新一锅烩Watchtower 半夜把十个项目全更新了,其中一个新版不兼容,早上起来全线飘红还没法快速定位更新没有分批,没有分组,没有回滚预案按项目分批更新、关键服务手动更新(第七节)

看完这张表,结论其实很朴素:单机多项目能不能长期稳定,不取决于单点技术多熟练,而取决于有没有一套所有项目共同遵守的规范。规范立住了,十个项目和两个项目的管理成本差不多;规范立不住,三个项目就能乱成一团。

目录规范:一项目一目录,一目录一 Compose#

所有项目统一放在 /opt 下,一个项目一个目录,目录名就是项目名。每个目录里自成一套:Compose 文件、环境变量、配置、数据,互不借用、互不引用。

/opt/
├── edge/ # 统一入口:反向代理(独立项目,见第五节)
│ ├── compose.yaml
│ └── Caddyfile
├── blog/
│ ├── compose.yaml
│ ├── .env # 本项目的密钥与变量,不进 Git
│ ├── .env.example # 变量清单模板,进 Git
│ ├── config/ # 挂载给容器的配置文件
│ └── data/ # 绑定挂载的数据目录(或改用命名卷)
├── cloud/
│ ├── compose.yaml
│ ├── .env
│ └── data/
├── monitor/
│ ├── compose.yaml
│ └── .env
└── backup/ # 备份脚本与备份落点(也可直接同步到异地)
├── backup-all.sh
└── logs/

这套结构有三条硬规矩:

第一,一项目一 Compose 文件,永远不要把多个不相关的项目写进同一份 compose.yaml。项目之间唯一的耦合点是第五节那张公共网络,除此之外谁下线都不影响别人。Compose 的基本写法和 project 概念在部署篇里讲透了,这里只强调组织方式。

第二,.env 单独管,且不进 Git。密钥、密码、Token 只存在于各项目自己的 .env 里;仓库里只提交 .env.example,列出变量名和示例值。这样配置可以放心版本化,密钥又不外泄。反面教材是把真实密码写进 compose.yaml 再推到公开仓库,机器人几分钟内就能扫到并拿去挖矿或勒索,这类事故每个月都在发生。

第三,数据与配置分离。config/ 是人写的、可以进 Git 的;data/(或命名卷)是程序生成的、走备份流程的。恢复一个项目时逻辑很清晰:配置从 Git 拉,数据从备份回,两条线不混。

数据库这类有状态服务,优先用命名卷而不是随手绑定挂载到某个临时路径,卷的命名、备份与恢复方法见数据卷与备份篇。无状态的 Web 服务则怎么方便怎么来。

命名规范:前缀统一,见名知意#

项目多了之后,docker ps 满屏都是 app、web、db、redis 这种名字,根本分不清属于谁。解决办法是所有资源统一加项目名前缀:

资源命名规则示例(项目 blog)示例(项目 cloud)
项目目录项目名本身/opt/blog/opt/cloud
Compose 项目名与目录名一致(name: 显式写明)blogcloud
容器名项目名-角色blog-web、blog-dbcloud-app、cloud-db
自定义网络项目名-netblog-netcloud-net
命名卷项目名-数据名blog-dbdatacloud-uploads
镜像(自建)项目名/服务名:版本blog/web:1.4.0cloud/api:2.1.3

Compose 文件开头把项目名写死,不要依赖目录名自动推导,搬目录时才不会串味:

name: blog
services:
web:
image: blog/web:1.4.0
container_name: blog-web
# ...
db:
image: postgres:16-alpine
container_name: blog-db
# ...

注意 container_name 写死之后,这个服务就不能再扩容多副本了(名字会冲突)。单机多项目场景绝大多数服务都是单副本,写死名字换来的是运维时一眼可辨;真需要多副本的服务,去掉这一行、靠 Compose 自动命名即可。另外,自建镜像一律打明确版本号,生产环境不要用 latest 当唯一标签,出事时你连回滚到哪一版都说不清。

隔离三件套:网络、资源、端口#

隔离是这篇的核心。三个维度一起上,任何一个项目出问题,都被关在自己的笼子里。

网络隔离:每项目一张自己的网#

每个项目在自己的 Compose 里声明一张自定义网络,本项目的所有服务都进这张网;项目内部用服务名互相访问(比如 Web 连 db:5432),项目之间则完全不通。网络模型、自定义网络与容器间通信的原理见网络篇,这里给多项目落地的固定写法:

name: blog
services:
web:
image: blog/web:1.4.0
container_name: blog-web
networks:
- blog-net # 项目内通信
- edge # 只把需要被反代访问的服务额外挂到公共网络
db:
image: postgres:16-alpine
container_name: blog-db
networks:
- blog-net # 数据库只进项目内网,坚决不挂 edge
networks:
blog-net:
name: blog-net
edge:
external: true # 由 edge 项目统一创建,见第五节

关键在数据库:它只出现在 blog-net 里,cloud 项目的任何容器都解析不到 blog-db 这个名字,更连不上。这样即便某个项目的 Web 层被攻破,攻击者也摸不到其他项目的数据库,横向移动在容器网络这一层就被切断。

资源隔离:每项目一份配额模板#

容器默认能吃满整机资源,必须用配额圈住。下面这段是本系列的通用模板,直接抄进每个项目的每个服务,按项目体量改数字。配额参数的含义、CPU 与内存限制的区别在安全与资源篇里有详解,这里给生产可用的组合:

services:
web:
image: blog/web:1.4.0
deploy:
resources:
limits:
cpus: "1.0" # 最多用 1 核
memory: 512M # 硬上限,超了触发 OOM Kill(只杀自己)
reservations:
cpus: "0.25" # 保底份额,整机繁忙时优先保障
memory: 128M
mem_swappiness: 0 # 可选:减少被换出到 swap 的倾向
WARNING

deploy.resources 在 Docker Compose V2 里执行 docker compose up 时是生效的(这是新版 Compose 规范的行为,和 Swarm 无关),不要被老资料里「deploy 只对 Swarm 有效」的说法误导。验证方法很简单:容器起来后 docker inspect 看 HostConfig 里的 Memory 与 NanoCpus,或者 docker stats 观察上限是否吻合。

配额数字怎么定:先用 docker stats 观察一周拿到各服务的日常水位,limits 给到水位的 1.5~2 倍,数据库这类关键服务再多给一点。宁可一开始给宽些再收紧,也不要拍脑袋给个小数字——内存上限给太小,容器会被反复 OOM Kill,表面看是「服务老重启」,实际是自己把自己掐死。

端口隔离:只绑 127.0.0.1,对外只留一个出口#

除反代之外,任何项目的端口都不直接暴露到公网。确有调试或本机访问需要的,绑到回环地址:

ports:
- "127.0.0.1:8080:80" # 只有本机能访问,外网扫不到

绝大多数服务连这一行都不需要写:反代和它在同一张 edge 网络里,直接用容器名加内部端口访问即可,根本不用经过宿主机端口。宿主机上真正对公网开放的,理想状态下只有 SSH 和反代的 80/443。端口越少,攻击面越小,这也是安全与资源篇反复强调的最小暴露原则。

统一入口:一张公共网络加一个反代#

所有项目的对外流量收拢到一个反代上:域名、HTTPS 证书、访问日志都在这一个点解决,新项目接入不用再碰宿主机防火墙。

做法是先建一张全局公共网络,由 edge 项目(即反代自己)创建,其他项目以 external: true 的方式挂载——第四节的 Compose 片段里已经出现了它:

Terminal window
docker network create edge

反代二选一:配置灵活、生态成熟选 Nginx,写法见用 Docker 部署 Nginx 反向代理与自动 HTTPS;想省心、证书全自动选 Caddy,写法见用 Docker 部署 Caddy:自动 HTTPS 反向代理。以 Caddy 为例,edge 项目的 Caddyfile 里每个项目一段,按容器名反代:

blog.example.com {
reverse_proxy blog-web:80
}
cloud.example.com {
reverse_proxy cloud-app:8080
}

新项目接入固定三步,照着走不会乱:

  1. 项目自己的 Compose 里,把需要对外的服务额外挂上 edge 网络(数据库等内部服务不挂)。
  2. 在 Caddyfile(或 Nginx 配置)里加一段:新域名指向新容器名与内部端口,重载反代。
  3. 把新域名解析到本机,证书由反代自动签发,完事。

整个过程不重启任何已有项目,反代重载也是平滑的。哪天某个项目要下线,同样反着来:删反代配置段、停项目、删解析,其他项目毫无感知。

全局基线:日志、备份与配置版本化#

单项目的细节前面各篇都讲过,这里定的是「所有项目统一执行」的基线数值,新项目上线即套用,不再逐个商量。

日志基线#

在 /etc/docker/daemon.json 里给所有容器兜底(单项目也可在 Compose 里用 logging 段单独覆盖),日志驱动与轮转参数见日志管理篇:

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

单文件 20 MB、保留 3 个,一容器日志最多占 60 MB。十个项目、几十个容器,最坏情况也就几个 GB,再也不会出现日志把磁盘写爆的事故。改完 daemon.json 需要重启 Docker 守护进程(会短暂影响全部容器),挑低峰期做,且重启前务必确认所有项目都设置了 unless-stopped 或 always 重启策略,否则重启完一地手动拉起的活。

备份与配置基线#

对象策略频率保留
命名卷 / 数据目录停写或快照后打包,脚本统一执行每天凌晨一次本地 7 天,异地 30 天
数据库用自带导出工具做逻辑备份(pg_dump、mysqldump 等),不要只拷数据文件每天一次,重要库可加中午一次同上
各项目 Compose 与配置全部进 Git 仓库(.env 除外)每次改动即提交Git 历史即版本线
.env 密钥单独加密备份一份到密码管理器或离线介质每次变更时长期
备份本身定期做恢复演练,抽一个卷实际还原验证每季度一次——

备份的具体命令与卷打包方法见数据卷与备份篇。这里只强调一条铁律:没做过恢复验证的备份,等于没有备份。备份脚本跑成功只证明「写出去了」,恢复演练才证明「拿得回来」。

更新与监控:分批、分组、留后路#

更新策略:按项目分批,不要一锅烩#

自动更新工具 Watchtower 的用法见自动更新篇,多项目场景要给它加约束:

项目类型更新策略理由
无状态小服务(博客、静态站、工具类)Watchtower 自动更新,错峰到凌晨低峰挂了影响小,新版收益(安全修复)大于风险
有状态服务(数据库、网盘、带数据的应用)关闭自动更新,手动看更新日志后升级数据格式变更、迁移脚本出问题都是大事,必须人在场
反代、监控等基础设施手动更新,且单独安排时间它们一挂,全站一起挂,不能和业务项目同批

给 Watchtower 分组靠的是标签(label):只给允许自动更新的容器打上启用标签,其余一律不碰;或者干脆跑两个 Watchtower 实例,分别管不同批次。再加一条:任何自动更新都要接通知(更新了谁、从哪版到哪版),第二天扫一眼通知,出问题能立刻对上时间线。

监控分工:三个层次各管一段#

监控不要指望一个工具包打天下,按层次分工(指标体系的搭建见容器监控篇:cAdvisor + Prometheus + Grafana):

层次回答的问题工具思路
存活监控服务还活着吗、域名还能打开吗HTTP/端口探测,挂了立刻推送告警
资源指标CPU、内存、网络、磁盘水位涨到哪了cAdvisor + Prometheus + Grafana 看趋势
业务探针关键接口返回是否正确、证书还有几天到期定时脚本请求接口并校验内容,证书到期单独提醒

其中磁盘水位是最容易被忽视又最致命的一项,给一条明确阈值:根分区使用率到 80% 预警、90% 告警,并把 docker system df 的结果纳入日常巡检——悬空镜像、无主卷、构建缓存攒几个月,同样能悄悄吃掉几十 GB。清理时只清明确无用的部分,不要图省事直接 docker system prune -a 一把梭,它会把停着但还要用的镜像和卷一起带走,生产机上这一条命令的破坏力堪比删库。

上线巡检清单:新项目上线前逐项打勾#

每个新项目接入这台服务器之前,按这张表走一遍,全部打勾才算上线完成。老项目每季度也拿它复查一次:

#检查项通过标准
1目录与命名在 /opt/<项目名>/ 下,Compose 写明 name:,容器/网络/卷都带项目前缀
2端口暴露docker ps 检查:除反代外无 0.0.0.0 绑定,调试端口只绑 127.0.0.1
3资源配额每个服务都有 CPU 与内存 limits,docker stats 核对生效
4网络隔离数据库等内部服务只在项目内网,未挂 edge;跨项目容器名互不解析
5日志轮转命中全局 daemon.json 基线或项目自有 logging 配置,无无限增长的日志
6密钥管理真实密钥只在 .env,仓库里只有 .env.example,无明文密码进 Git
7备份接入数据卷已加入统一备份脚本并实际跑通一次,恢复路径明确
8更新策略已明确归入自动/手动批次,Watchtower 标签与本项目策略一致
9监控接入存活探测已添加,域名与关键接口在监控列表内
10域名与证书反代配置段就位,HTTPS 可正常访问,证书自动续期链路完整
11重启自恢复服务设了 unless-stopped 或 always,手动重启宿主机(或模拟)后能自动回来
12回滚预案镜像保留上一个版本号,知道出事时改哪个标签、执行哪条命令回退

这张表打印出来贴在文档首页都不过分。它不高级,但生产事故里的大多数,恰恰死在这些基础项没人逐条确认过。

排障:多项目环境的高频问题#

WARNING

多项目排障的第一原则是先定位影响面:先确认是单项目问题还是整机问题。用 docker stats 看整机水位、用 docker ps 看异常容器状态,能省掉一半瞎猜的时间。

症状一:某项目突然打不开,其他项目正常。 先查反代:docker logs edge 看是否有上游连接错误;再查该项目容器是否在反复重启(docker ps 里 STATUS 显示 Restarting 多半是配额太小被 OOM Kill,或新配置写错);最后查它有没有被手滑移出 edge 网络(docker network inspect edge 看成员列表)。

症状二:所有项目同时变慢或打不开。 这是整机问题,按顺序查:df -h 看磁盘是不是满了(日志、镜像、备份包是三大嫌疑);docker stats 看是不是某个容器在狂吃 CPU/内存——如果它没设配额,就是隔离没做全,回到第四节补上;free -h 与 dmesg | grep -i oom 看有没有进程被系统杀掉。

症状三:新项目起不来,报网络或名字冲突。 多半是命名没遵守规范:容器名、网络名或卷名和已有项目撞了。docker ps -a、docker network ls 对照排查,根治办法是回第二节把前缀补齐。

症状四:证书突然过期,全站 HTTPS 报警。 自动续期失败通常是 80 端口被别的进程占了、域名解析被改过,或反代容器本身异常。先单独访问反代的日志定位续期报错,再逐项核对解析与端口,别急着手动签证书绕过——绕过一次,下个周期还会再炸。

症状五:磁盘莫名少了几十 GB。 docker system df -v 逐项看:镜像、容器可写层、卷、构建缓存谁在膨胀。构建缓存和悬空镜像可以清,卷必须逐个确认归属再动。

什么时候该拆出去#

这套方案能舒服地撑起一台中配服务器上的十来个中小项目,但它有明确的天花板:单机没有高可用,宿主机一挂全挂;资源总量就这么多,项目只增不减迟早见底。判断是否该扩容,看三个信号:整机内存或 CPU 长期水位超过 70%;某个项目开始需要多副本或独立带宽;维护窗口越来越难找(重启一次影响太多项目)。

处理顺序是先纵向加配置,再把最吃资源或最关键的项目拆到第二台机器(目录规范统一,迁移就是搬目录加改解析),真到了多机协同、需要服务编排与滚动发布的阶段,再考虑上 Swarm 这类集群方案,入门路径见 Docker Swarm 篇。不要提前上重型架构——单机规范做扎实,比过早上集群重要得多。

小结#

  • 多项目乱象的根源不是技术不行,而是没有共同规范;先立规矩,再谈技巧。
  • 目录、命名、网络、资源、端口五条规范是地基:一项目一目录一 Compose、资源命名全带前缀、数据库只进内网、每服务必设配额、对外只留反代一个出口。
  • 日志、备份、更新、监控全部走全局基线,新项目套模板接入,不逐个发明方案。
  • 上线前过一遍十二项巡检清单,每季度复查一次;备份必须做过恢复验证才作数。
  • 单机方案有边界,水位、副本、维护窗口三个信号出现时,按加配置、拆项目、上集群的顺序走。

至此,从单容器入门到多项目生产,整个系列算是闭环了。把这一篇的规范当成默认设置带进每一个新项目,服务器会越用越省心,而不是越用越心慌。

一台服务器多项目生产实战
https://www.anexns.cloudns.org/posts/docker-multi-project-prod/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0