portainer/authenticator

Authenticator

镜像概述和主要用途

Authenticator是一个帮助在config.json中填充Portainer API授权头的工具，旨在支持用户通过Docker CLI与Portainer API进行交互。

核心功能和特性

• 自动将Portainer API授权头添加到Docker配置文件config.json
• 简化Docker CLI与Portainer API的集成流程
• 无需手动配置授权信息，提升操作效率

使用场景和适用范围

适用于需要通过Docker CLI直接操作由Portainer管理的Docker环境的用户，特别是在需要通过API进行授权访问的场景下，如远程管理、自动化脚本执行等。

使用方法和配置说明

基础使用命令

通过以下Docker命令运行Authenticator，将Portainer API授权信息添加到本地Docker配置文件：

bash
$ docker run --rm -v ~/.docker/config.json:/config.json portainer/authenticator http://PORTAINER_URL:9000 username password

参数说明：

• --rm：容器运行结束后自动删除
• -v ~/.docker/config.json:/config.json：挂载本地Docker配置文件到容器内，用于更新授权信息
• PORTAINER_URL：替换为实际的Portainer服务URL（如192.168.1.100）
• username：Portainer登录用户名
• password：Portainer登录密码

Docker CLI与Portainer API集成示例

配置完成后，可通过以下命令使用Docker CLI连接Portainer API执行操作（如查看所有容器）：

bash
$ docker -H PORTAINER_URL:9000/api/endpoints/1/docker ps -a

执行后将显示类似以下输出：

CONTAINER ID        IMAGE                 COMMAND                  CREATED             STATUS                         PORTS                                            NAMES
04e273b9cb27        portainer/base        "/app/portainer --no…"   5 minutes ago       Up 5 minutes                   0.0.0.0:9000->9000/tcp   portainer
...