Harbor —— 重置或取回 admin 密码

最新推荐文章于 2025-07-02 22:37:24 发布

原创最新推荐文章于 2025-07-02 22:37:24 发布 · 994 阅读

CC 4.0 BY-SA版权

当Harbor无法登录且提示密码错误时，可能是由于存储异常导致。本文档详细介绍了如何在未通过GUI修改密码的情况下取回admin密码，以及在必要时如何重置admin密码。首先，通过docker进入Harbor的admin-server或core容器，然后查看或更新存储在harbor_user表中的密码。对于重置，需进入db容器，使用psql更新admin的salt和password字段，并重启服务。这是一个针对Harbor系统管理的实用指南。

原文地址：Harbor —— 重置或取回 admin 密码（永久地址，保存网址不迷路 🙃）

问题描述

突然某天 Harbor 无法登录，提示帐号密码错误，怀疑是被意外修改，因此尝试重置 admin 密码。

最后发现问题出现在后端存储上，存储异常导致无法登录。此处记录重置和取回密码的方法。

取回 admin 密码

该方法仅适用于：没有通过 Harbor GUI 修改密码的场景，否则只能重置。

第一步、进入容器

# Harbor version <=1.7：
docker exec -it "<harbor-adminserver container id>" bash

# Harbor version >=1.8：
docker exec -it "<harbor-core container id>" bash

第二步、查看密码

env | grep HARBOR_ADMIN_PASSWORD

重置 admin 密码

docker exec -it "<harbor-db container id>" bash

psql -U postgres -d registry
> select * from harbor_user;
> update harbor_user set salt='', password='' where user_id = "<admin user_id>";

# 重启服务，也可能无需重启，我们没有重置过，这里治理参考官方文档进行记录。

参考文献

How to reset and retrieve forgotten Harbor admin password (76289)