
事情是从电视卡开始的。周五晚上全家看片,Jellyfin转码一部4K,画面隔几秒顿一下,声音倒是正常。我起身看了眼NAS,机箱风扇呼呼转,硬盘灯闪成一片。当时第一反应是盘的事,毕竟那台N100就两个盘位,做种盘常年挂着。ssh上去看了眼docker stats,人当场愣住:qBittorrent一个容器,CPU占了百分之二百四,Jellyfin那边饿得只剩百分之十几,转码线程根本抢不到核。
做种机嘛,校验和hash全开,一启动就是满负荷。可它抢的这个CPU,正是Jellyfin要拿来转码的。俩容器在同一台N100上打架,输的是坐在沙发上的我。这事处理完我才发现,我给容器限过内存,从来没给容器限过CPU——内存的坑去年踩过,CPU的坑今年才补上。
先说清楚:限内存和限CPU,是两本完全不同的账
去年我写过容器内存那本账,给峰值型容器加过-m 512m这种内存笼子。当时有句话我记得很清楚:限制是给「峰值没意义」的容器用的。但内存和CPU这两样东西,脾气完全不一样,笼子也得分别打。
内存超了,内核直接杀进程,容器消失,问题表现是「没了」。CPU超了没人杀它,大家排队分时间片,问题表现是「慢」。所以内存限额管的是生死,CPU限额管的是快慢。这决定了两件事:内存限额可以设得很紧,反正被杀会重启;CPU限额反而要谨慎,设紧了容器不会死,只会慢到你怀疑它坏了。
还有个数字必须看懂。docker stats里CPU那列不是0到100,是0到你机器总核数的百分比。我那台N100是四核,单容器跑满一个核显示100%,四个核全吃是400%。qBittorrent那晚的240%,意思是它咬住了两个多核不放。头一回见200%这个数的人容易吓一跳,以为爆表了,其实是四核机上的正常刻度。
第一步:抓现场,别凭感觉
动手限之前,先花十分钟弄清楚谁在抢CPU。ssh进NAS跑docker stats,盯个一两分钟,把CPU列的数记下来。嫌手抄麻烦就加个参数:docker stats --no-stream,只出一行结果就退出,方便存档对比。
我那晚抄下来的数是这样的:qBittorrent常年在80%到240%之间跳,做种校验hash的时候直接顶到240%;Jellyfin平时零头,转码瞬间冲到300%以上然后又落回去;Immich白天识别照片能吃150%;剩下六个容器加起来不到30%。这份底账的意思很清楚:qBittorrent是惯犯,Jellyfin是偶尔干正事的,Immich是白天错峰跑的,各有各的脾气。
这里有个判断标准,比数本身重要:抢CPU的容器,它的活是不是等得起。qBittorrent做种,校验慢十分钟没人在乎,做种的乐趣本来就在慢;Jellyfin转码,一卡电视上立刻看得见,家人第一次喊卡你就懂了。活等得起的容器才配限CPU,这跟内存限额「峰值没意义的才限」是同一个道理,只是换了维度。
第二步:上笼子,两种写法
已经在跑的容器,没法原地改限额,得删掉重建,挂载目录和端口照抄原来的就行,数据都在挂载目录里,不会丢。命令行新建时加一个参数:
docker run -d --cpus=1.5 qBittorrent镜像名
后面那串挂载参数照原样跟上。--cpus=1.5的意思是:这个容器最多用一个半核的算力。做种速度从原来的「两个核喂它」变成「一个半核喂它」,校验hash慢了两成左右,做种机完全无所谓。家底厚的话也可以用--cpuset-cpus 0,1这种写法,直接把它钉死在前两个核上,让转码的容器去用三、四核,物理隔离,谁也别抢谁的。我两招都用过:日常用--cpus软限,转码高峰那晚临时换cpuset分区,都管用。
用Compose的照抄这段,塞进对应服务的块里:
services:
qbittorrent:
cpus: 1.5
mem_limit: 512m
对,就这么短,cpus一行管CPU,mem_limit一行管内存,我现在的compose文件里两行都写。改完docker compose up -d重建一下就生效。飞牛界面里建容器的,在容器设置里翻到资源限制那一栏,CPU那里一般是可以勾选和填数的地方,原理一样,界面叫法不同,找不到就用SSH走命令行,殊途同归。
第三步:验收,限完得再量一次
笼子上完不算完,得回去重测一遍。第二天晚上家里看片时我又跑了一次docker stats:qBittorrent被按在150%以内,做种吞吐看了眼,速度掉了不到两成,换算成一部50G的校验,从8小时变成10小时,这种活睡一觉起来都一样。Jellyfin转码时能稳定拿到280%上下,电视上那个隔几秒一顿的画面消失了。这轮验收我最看重的就是Jellyfin的数:限CPU的本质不是让谁慢,是把抢来的算力还回去,还到真正卡顿的那个人手里。
| 容器 | 活等得起吗 | 我的限额 | 限后变化 |
|---|---|---|---|
| qBittorrent | 等得起,做种本就该慢 | cpus 1.5 | 校验慢两成,无人受害 |
| Jellyfin | 等不起,卡了立刻被骂 | 不限,反向保它 | 转码稳在280% |
| Immich | 半等得起,白天错峰 | cpus 2 + 手动触发识别 | 白天识别不再卡别的 |
| AdGuard Home | 等不起,DNS断了全屋喊 | 不限 | 本来就只吃零头 |
那张表是照我家账抄的,别直接照搬数字,你家容器的脾气得自己量。三个容器故意留在不限的行列里,因为它们的活等不起。限CPU从来不是给所有容器上枷锁,是给「活等得起却霸着算力不放」的那个惯犯单独上。
三个翻车点,我先替你踩了
头一个是数字单位。--cpus=1.5填的是核数不是百分比,0.5就是半个核。想填50%那种思路的,得换算成核数除以总核数,四核机的50%是cpus 2。我把这两个单位搞混过,第一次给Immich写了个--cpus=50,结果它一个人被分到十二个核的配额,等于没限,白高兴一场。第二个是已运行容器改不了,必须删了重建,挂载照抄,数据丢不了,但端口和参数得对着原来的抄,抄漏一个重启策略,半夜断电后它就起不来了,容器起不来的排查思路我以前写过。第三个是别拿CPU限额当性能优化用。它的定位是资源仲裁,是让谁都别饿死,不是让机器变快。机器真的不够用了,加内存换CPU的事另算,那笔账的链接放文末。
给不同家底的对号表
这套限额真正该抄作业的是小内存小核数机器的主人。N100四核、8G内存这种配置,容器一多早晚打架。反过来,J4125四核带核显转码、16G内存起步的机器,或者容器总共就三五个的,不用慌着上笼子,出了问题再回来看这篇也不迟。
| 家底 | 建议 |
|---|---|
| N100四核/8G,容器九个左右 | 活等得起的都限上,转码DNS类保无限额 |
| J4125/16G,容器五六个 | 先量再做,惯犯限一个就够 | 核显转码为主的机器 | 转码走核显不吃CPU,这类机器没这个病 |
表里最后一行是我最想说的:真转码大户,该走的是核显硬解这条路,Jellyfin开QSV硬解,转码基本不吃CPU,CPU限额的病根直接不存在。我那晚限完CPU电视不卡了,隔了两周还是把Jellyfin的硬解配上了,N100的核显从此才算干上正事。两头都做,机器才能真正松快。
相关的几篇链在这:容器内存那本账是本篇上集,「峰值两本账」的思路从那来的,建议先看;Docker入门那课管镜像端口挂载,新手补完再来;Compose的写法配上这篇正好一套;容器半夜起不来翻那篇排查;真要加钱换机器的,N100和J4125的选型账管那条路。核显转码配好了,这篇的CPU限额就只是保底。

发表评论