讲师中心 微信公众号
AI工具推荐 视频效率加速

Linux Dockerfile 编写最佳实践

梦宇同学_5579

梦宇同学_5579

发布时间:2026-02-13 20:40:03

|

1017人浏览过

|

来源于php中文网

原创

优先使用官方-slim镜像(如python:3.12-slim)而非Alpine,避免musl/glibc兼容问题;RUN命令合并安装与清理以减小体积;统一用COPY代替ADD防意外解压或URL缓存失效;多阶段构建分离编译与运行环境;务必配置.dockerignore过滤无关文件。

linux dockerfile 编写最佳实践

FROM 选基础镜像时,别只看名字大小

很多人一上来就搜“最小 Docker 镜像”,然后选 alpine,结果跑 glibc 程序直接报 not foundNo such file or directory——其实是动态链接错了。Alpine 用的是 musl,不是 glibc,Python/Go 编译的二进制如果没静态链接,就挂。

实操建议:

  • 优先用官方语言镜像的 -slim 版本,比如 python:3.12-slim(基于 Debian,兼容性好,体积也不大)
  • 确认你打包的二进制是否依赖 glibc:在宿主机上跑 ldd your-binary | grep libc,有 libc.so.6 就别硬上 Alpine
  • 真要 Alpine,用 apk add --no-cache 装依赖,别留 /var/cache/apk

RUN 合并命令不是为了少写几行,是为了减少层和缓存失效

Docker 每个 RUN 都建一层,中间产物不自动清理。比如先 apt update && apt install,再 rm -rf /var/lib/apt/lists/*,这两步分开写,第二层里确实删了,但第一层还留着整个 apt 缓存目录,镜像体积照样大。

实操建议:

  • 把安装 + 清理写在同一行 RUN apt update && apt install -y curl && rm -rf /var/lib/apt/lists/*
  • 避免 RUN pip install 单独成行——它会把整个 pip 缓存打进镜像。改用 RUN pip install --no-cache-dir
  • 如果要用 curl 下东西,别装完就走,加 && rm /usr/bin/curl(前提是后续不需要)

COPYADD 别混用,ADD 的自动解压和远程拉取是坑源

ADD 看起来方便:支持 tar 自动解压、支持 URL 下载。但正因如此,它容易触发意外行为。比如 ADD app.tar.gz /app/,你以为只是复制,其实它默默解压了;更糟的是,如果 app.tar.gz 里有绝对路径(如 /etc/passwd),Docker 会照写进去,可能覆盖关键文件。

onewo-rtlinux
onewo-rtlinux

Linux 实时编程助手。生成、审查并修改用于周期性控制任务和中断驱动程序的 C 代码。强制实施实时调度策略。

下载

实操建议:

  • 一律用 COPY,需要解压就显式写 RUN tar -xzf
  • 绝不用 ADD 拉远程 URL:ADD https://.../script.sh /tmp/ 会让构建缓存完全失效(URL 内容变,层就重做),改用 RUN curl -fsSLO + COPY 分离关注点
  • COPY --chownRUN chown 更干净,尤其对非 root 用户启动的服务

多阶段构建不是炫技,是解决“编译环境 vs 运行环境”错位

很多 Go/Node/Rust 项目在镜像里既装了 go 又放了 go build 出来的二进制,结果镜像里塞了一堆 /usr/local/gopkgmod 目录——运行根本不需要。这类镜像不仅大,还暴露编译工具链,增加攻击面。

实操建议:

  • 编译阶段用 golang:1.22,运行阶段用 debian:bookworm-slimscratch(Go 静态编译后可上 scratch
  • COPY --from=builder 显式挑出二进制,别 COPY . 整个目录
  • 注意:多阶段不能跨 stage 共享环境变量或 shell 设置,ARG 要在每个 stage 里重新声明

最常被忽略的一点:.dockerignore 文件没配好,node_modules__pycache__.git 全塞进镜像,体积虚高、构建变慢、还可能泄露敏感信息。它比任何 RUN rm 都管用——从源头过滤。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

479

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

576

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

976

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

751

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1406

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

3894

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

1734

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

3706

2025.06.17

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

CLion 远程开发实战
CLion 远程开发实战

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn