### 配置 Docker Registry 使用 htpasswd 实现基本认证 为了使 Docker Registry 支持基于 `htpasswd` 文件的身份验证，在启动容器时需通过环境变量和挂载卷的方式引入必要的配置。 创建并填充用于存储用户名及哈希后的密码字符串的文件，通常命名为 `htpasswd`。此操作可通过命令完成： ```bash htpasswd -Bbn admin 123456 > /data/docker.registry/etc/registry/auth/passwd ``` 上述指令会生成一个名为 `passwd` 的文件，并将其放置在 `/data/docker.registry/etc/registry/auth/` 路径下[^2]。 接着定义 YAML 或 JSON 格式的配置文档来告知 Docker Registry 启用 HTTP 基本认证机制以及指向外部凭证管理器的位置。对于简单的场景来说，可以采用如下形式的配置片段： ```yaml auth: htpasswd: realm: basic-realm path: /etc/docker/registry/auth/htpasswd version: 0.1-dev log: fields: service: registry storage: cache: blobdescriptor: inmemory http: addr: :5000 headers: X-Content-Type-Options: [nosniff] health: storagedriver: enabled: true interval: 10s threshold: 3 ``` 注意这里的 `path` 字段应当对应到之前创建好的 `htpasswd` 文件所在位置。之后利用 `-v` 参数把主机上的该文件共享给容器内的相应路径；同时设置 `REGISTRY_AUTH=htpasswd`, `REGISTRY_AUTH_HTPASSWD_REALM=basic-realm` 和 `REGISTRY_AUTH_HTPASSWD_PATH=/etc/docker/registry/auth/htpasswd` 环境变量以激活这项特性[^1]。 最后一步便是执行运行命令启动带有这些选项的服务实例： ```bash docker run -d \ --restart=always \ --name registry \ -e REGISTRY_AUTH=htpasswd \ -e REGISTRY_AUTH_HTPASSWD_REALM="basic-realm" \ -e REGISTRY_AUTH_HTPASSWD_PATH="/etc/docker/registry/auth/htpasswd" \ -v /data/docker.registry/etc/registry:/etc/docker/registry \ -p 5000:5000 \ registry:2 ``` 这样就完成了整个过程，现在访问这个私有仓库就需要提供有效的账户信息才能成功推送或拉取镜像了[^4]。