### Docker 配置文件 `config.json` 的用途及配置方法 #### 文件位置与结构 Docker 客户端会自动创建并维护 `.docker/config.json` 文件，通常位于用户的主目录下（例如 Linux 和 macOS 中路径为 `$HOME/.docker/config.json`）。此文件主要用于存储认证信息和其他客户端设置。其默认内容可能如下所示： ```json { "auths": { "https://index.docker.io/v1/": { "auth": "<base64-encoded-auth-string>" } }, "credsStore": "desktop", "currentContext": "default" } ``` 该文件中的字段解释如下[^1]： - **auths**: 存储用于访问私有仓库的身份验证信息。 - **credsStore**: 指定凭证管理工具的名称，例如 `desktop` 或其他插件。 - **currentContext**: 当前使用的上下文。 #### 认证机制 当用户通过命令如 `docker login` 登录到某个容器注册表时，`.docker/config.json` 会被更新以保存登录凭据。这些凭据经过 Base64 编码后存入 `auths` 字段下的对应条目中。需要注意的是，虽然编码后的字符串看似加密，但实际上它仅是一种简单的字符转换方式，并不提供真正的安全性[^2]。 #### 手动编辑配置 如果需要手动修改或添加新的认证数据至 `config.json`，可以按照以下模板操作： ```json { "auths": { "my-private-repo.example.com": { "username": "your_username", "password": "your_password", "email": "your_email@example.com", "auth": "YXNkZnNhZGZzYWQ=" /* 这里应填入 base64(username:password) */ } } } ``` 其中 `"auth"` 值可以通过 Python 脚本生成： ```python import base64 def generate_auth_token(username, password): token_string = f"{username}:{password}" auth_encoded = base64.b64encode(token_string.encode('utf-8')).decode('utf-8') return auth_encoded print(generate_auth_token("example_user", "secure_password")) ``` 运行以上脚本将返回一个适合放入 JSON 文件内的授权串[^3]。 #### 注意事项 尽管可以直接编辑 `config.json` 来更改某些选项，但建议优先利用官方支持的方法完成大部分任务，比如使用 CLI 工具执行诸如 `docker logout` 或重新调用 `docker login` 等指令来刷新本地记录的信息。此外，在共享机器环境中务必妥善保护好个人敏感资料以免泄露风险增加[^4]。