Win10下bat运行带Bcrypt密码的Portainer启动命令登录失败如何解决

问题原因 #

1. Windows .bat 批处理的语法不识别单引号作为字符串定界符，原命令中--admin-password='$2a$xxx'的写法会把单引号本身和哈希值一起作为参数传递给Portainer，导致程序拿到的哈希值多了前后两个单引号，和实际生成的Bcrypt值不匹配，密码校验自然失败。
2. 原命令使用的portainer/portainer是Portainer v1.x的旧镜像，v2.x之后官方镜像已更名为portainer/portainer-ce，旧镜像的参数解析逻辑和v2.x官方文档规则不兼容，也会导致参数不生效。
3. 排查记录中提到临时方案删除的是--admin-passwd参数，和官方正确参数名--admin-password存在拼写差异，属于潜在的书写错误。

解决方案 #

修正后的批处理命令写法 #

bat中字符串需用双引号包裹，同时哈希值中的$符号需要替换为$$进行转义，避免被bat识别为变量，同时替换为官方最新的Portainer CE镜像，完整命令如下：

docker run --rm -d --name "portainer" -p "127.0.0.1:9001:9000" -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce --admin-password="$$2a$$10$$0PW6gPY0TSeYzry2RSakl.7VUVmzdmD6mQPcemiG6i2vfJGGGePYu"

执行前清理旧资源 #

运行命令前先执行以下指令清理残留的容器和数据卷，避免缓存影响：

docker stop portainer
docker rm portainer
docker volume rm portainer_data

执行修正后的命令等待10秒后访问127.0.0.1:9001，即可直接使用admin/portainer登录。

内容的提问来源于stack exchange，提问作者Markus-Hermann