Skip to main content

Portainer 管理员重置密码步骤

当你遗忘 Portainer 管理员账号密码，无法登录 Portainer 时，铁威马 TNAS 系统支持通过 SSH 终端命令重置账户密码，你可以通过此方式无损重置 admin 登录密码，从而正常登录 Portainer，无需重装应用丢失原有配置数据。

前提准备​

  1. 打开 TNAS 的 SSH 终端
  2. 确保 Portainer 已经在 TNAS 应用中心里停止运行（必须停止，否则数据库文件被占用，重置会失败）

步骤​

1. 找到你的 Portainer 数据目录​

首先，我们要找到 Portainer 的数据文件夹，里面存着portainer.db。

执行下面这条命令：

find /Volume1/@apps/Portainer -name "portainer.db"

执行后，你会看到类似这样的输出：

/Volume1/@apps/Portainer/portainer.db

把前面的路径 /Volume1/@apps/Portainer 记下来，这就是你的数据目录。

2. 执行官方重置命令​

把下面命令里的 /path/to/portainer，替换成你上一步找到的数据目录路径，然后复制到终端执行：

docker run --rm -v /path/to/portainer:/data portainer/helper-reset-password

举个例子：

如果你的数据目录是 /Volume1/@apps/Portainer，完整命令就是：

docker run --rm -v /Volume1/@apps/Portainer:/data portainer/helper-reset-password

3. 拿到新密码​

执行命令后，终端会输出类似这样的内容：

2025/04/22 12:00:00 Password successfully updated for user: admin
2025/04/22 12:00:00 Use the following password to login:  aBcD1234!@#$
  • 第一行表示重置成功
  • 第二行的 aBcD1234!@#$ 就是临时新密码，复制下来！

4. 启动 Portainer 并登录​

  1. 回到 TNAS 应用中心，重新启动 Portainer
  2. 打开 Portainer 网页（默认地址：http://你的TNAS IP:9000）
  3. 用户名输入 admin，密码粘贴上一步复制的临时密码，就能登录了！

5.（强烈建议）登录后立刻修改成自己的密码​

  1. 登录 Portainer 后，点击右上角的用户头像
  2. 选择 My Account → Change Password
  3. 输入临时密码，设置你自己的新密码，保存即可

常见问题解答​

1. 为什么要先停止 Portainer？​

因为 Portainer 运行时会锁定 portainer.db 文件，重置工具无法修改。停止后文件才会被释放，重置才会成功。

2. 重置后我之前创建的用户、配置还在吗？​

该操作仅重置 admin 账户密码，不会删除或改动其他用户、运行环境、模板文件及系统各类配置参数。

3. 执行命令时提示 docker: command not found？​

说明你的 TNAS 没开启 Docker 引擎。先去 TNAS 应用中心，安装并开启 Docker Engine，再回来执行命令即可。

4. 执行后没看到密码输出？​

  • 检查数据目录路径是否正确
  • 确认 Portainer 已经完全停止运行
  • 重新执行一次命令