11notes/debian

!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/banner/README.png

DEBIAN

!size!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png!pulls!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png%5B](https://github.com/11notes/docker-debian/issues)!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png!swiss_made

以无root权限运行Debian

简介 📢

Debian是一个完整的自由操作系统！

概要 📖

此镜像能做什么？ 该镜像提供一个基础Debian镜像，并包含一些额外优化，如默认内置curl、tini等工具，不缓存任何软件包。它将通过https://github.com/krallin/tini%E6%89%A7%E8%A1%8C%E8%84%9A%E6%9C%AC%60/usr/local/bin/entrypoint.sh%60%E3%80%82

如果将其用作构建自定义镜像的基础镜像，只需不设置自己的ENTRYPOINT以使用默认入口点，并提供自定义的/usr/local/bin/entrypoint.sh即可。

独特价值主张 💶

为什么选择此镜像而非其他现有镜像？ 好问题！因为...

• ...此镜像以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%EF%BC%88%E7%94%A8%E6%88%B7ID:%E7%BB%84ID%E4%B8%BA1000:1000%EF%BC%89
• ...此镜像在发布前后会自动扫描CVE（安全漏洞）
• ...此镜像通过安全且固定的CI/CD流程构建
• ...此镜像体积非常小

如果您重视安全性、简洁性和极致优化，那么此镜像可能适合您。

对比 🏁

以下是此镜像与最常用或原始Debian镜像的对比。

Docker Compose配置 ✂️

yaml
name: "debian"
services:
  debian:
    image: "11notes/debian:13.4.0"
    environment:
      TZ: "Europe/Zurich"
    restart: "always"

若要了解如何更改此容器镜像的默认UID/GID，请参考https://github.com/11notes/RTFM/blob/main/linux/container/image/11notes/how-to.changeUIDGID.md#change-uidgid-the-correct-way%E3%80%82

构建示例 🚧

yaml
FROM 11notes/debian:stable
# 构建过程中切换到root用户
USER root
# 配置应用
RUN set -ex; \
  setup your app
# 添加自定义入口点到镜像
COPY ./entrypoint.sh /usr/local/bin

默认设置 🗃️

环境变量 📝

主要标签 🏷️

以下是镜像的主要标签。同时也提供每个提交及其sha256短哈希值对应的标签。

• https://hub.docker.com/r/11notes/debian/tags?name=13.4.0
• https://hub.docker.com/r/11notes/debian/tags?name=stable
• https://hub.docker.com/r/11notes/debian/tags?name=13.4.0-unraid
• https://hub.docker.com/r/11notes/debian/tags?name=stable-unraid
• https://hub.docker.com/r/11notes/debian/tags?name=13.4.0-nobody
• https://hub.docker.com/r/11notes/debian/tags?name=stable-nobody

没有latest标签，如何处理更新？

个人认为:latest标签是一个不良习惯，不应使用。许多开发者在新版本中引入破坏性变更，这会给使用:latest的用户带来问题。如果不想将标签更改为最新的语义化版本，可以使用语义化版本的短格式。例如，不使用:13.4.0，而使用:13或:13.4。由于这些标签会在每个新版本发布时更新为软件的最新版本，使用它们类似于使用:latest，但至少固定在主版本或次版本，理论上不会引入破坏性变更。

如果仍坚持使用最新版本，可使用:rolling标签，但请注意！这将立即获取应用的最新版本，无论是否存在破坏性变更或安全问题，风险自负！

镜像仓库 ☁️

bash
docker pull 11notes/debian:13.4.0
docker pull ghcr.io/11notes/debian:13.4.0
docker pull quay.io/11notes/debian:13.4.0

Unraid版本 🟠

此镜像默认支持Unraid系统。只需在任何标签后添加**-unraid**，镜像将以99:100而非1000:1000的UID/GID运行。

Nobody版本 👻

此镜像默认支持nobody用户。只需在任何标签后添加**-nobody**，镜像将以65534:65534而非1000:1000的UID/GID运行。

源代码 💾

• https://github.com/11notes/docker-debian

基础镜像 🏛️

此镜像不基于其他镜像，而是以https://hub.docker.com/_/scratch%E4%BD%9C%E4%B8%BA%E8%B5%B7%E5%A7%8B%E5%B1%82%E3%80%82 镜像包含以下无发行版层：

• https://github.com/11notes/docker-distroless/blob/master/curl.dockerfile - 用于执行HTTP请求的工具
• ***:tini

构建工具 🧰

• debian

通用提示 📌

• 使用反向代理（如Traefik、Nginx、HAproxy）终止TLS并保护端点
• 使用Let’s Encrypt DNS-01挑战获取服务的有效SSL证书

ElevenNotes™️

此镜像仅供参考，使用风险自负。更新镜像版本前请务必备份数据。查看https://github.com/11notes/docker-debian/releases%E4%BA%86%E8%A7%A3%E7%A0%B4%E5%9D%8F%E6%80%A7%E5%8F%98%E6%9B%B4%E3%80%82%E5%A6%82%E4%BD%BF%E7%94%A8%E6%AD%A4%E9%95%9C%E5%83%8F%E9%81%87%E5%88%B0%E9%97%AE%E9%A2%98%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4https://github.com/11notes/docker-debian/issues%E3%80%82%E5%A6%82%E6%9C%89%E9%97%AE%E9%A2%98%E6%88%96%E5%BB%BA%E8%AE%AE%EF%BC%8C%E8%AF%B7%E5%88%9B%E5%BB%BAhttps://github.com/11notes/docker-debian/discussions%E8%80%8C%E9%9D%9Eissue%E3%80%82%E5%8F%AF%E5%9C%A8https://github.com/11notes?tab=repositories%E6%9F%A5%E7%9C%8B%E6%89%80%E6%9C%89%E5%85%B6%E4%BB%96%E4%BB%93%E5%BA%93%E3%80%82

创建于 17.03.2026, 07:05:22 (CET)