Chuyển đến nội dung chính

Các bước đặt lại mật khẩu quản trị viên Portainer

Khi bạn quên mật khẩu tài khoản quản trị viên Portainer và không thể đăng nhập vào Portainer, hệ thống TerraMaster TNAS hỗ trợ đặt lại mật khẩu tài khoản qua lệnh terminal SSH. Bạn có thể dùng phương pháp này để đặt lại mật khẩu đăng nhập admin mà không mất mát gì, cho phép bạn đăng nhập bình thường vào Portainer mà không cần cài đặt lại ứng dụng và mất dữ liệu cấu hình hiện có.

Điều kiện tiên quyết​

  1. Mở terminal SSH của TNAS của bạn.
  2. Đảm bảo rằng Portainer đã được dừng trong Trung tâm ứng dụng TNAS (phải dừng, nếu không tệp cơ sở dữ liệu sẽ bị khóa và việc đặt lại sẽ thất bại).

Các bước​

1. Xác định thư mục dữ liệu Portainer của bạn​

Trước tiên, tìm thư mục dữ liệu Portainer chứa portainer\.db.

Chạy lệnh sau:

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

Sau khi thực thi, bạn sẽ thấy kết quả tương tự:

/Volume1/@apps/Portainer/portainer.db

Ghi lại tiền tố đường dẫn /Volume1/@apps/Portainer – đây là thư mục dữ liệu của bạn.

2. Thực thi lệnh đặt lại chính thức​

Thay /path/to/portainer trong lệnh dưới đây bằng đường dẫn thư mục dữ liệu bạn đã tìm thấy ở bước trước, sau đó sao chép và chạy nó trong terminal:

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

Ví dụ:

Nếu thư mục dữ liệu của bạn là /Volume1/@apps/Portainer, lệnh đầy đủ là:

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

3. Lấy mật khẩu mới​

Sau khi thực thi lệnh, terminal sẽ xuất ra nội dung tương tự:

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!@#$
  • Dòng đầu tiên cho biết đặt lại thành công.
  • aBcD1234!@#$ ở dòng thứ hai là mật khẩu mới tạm thời – hãy sao chép nó!

4. Khởi động Portainer và đăng nhập​

  1. Quay lại Trung tâm ứng dụng TNAS và khởi động lại Portainer.
  2. Mở trang web Portainer (địa chỉ mặc định: http://your_TNAS_IP:9000).
  3. Nhập admin làm tên người dùng, dán mật khẩu tạm thời bạn đã sao chép ở bước trước, và bạn có thể đăng nhập.

5. (Rất khuyến nghị) Đổi mật khẩu ngay sau khi đăng nhập​

  1. Sau khi đăng nhập vào Portainer, nhấp vào ảnh đại diện người dùng ở góc trên bên phải.
  2. Chọn My Account → Change Password.
  3. Nhập mật khẩu tạm thời, đặt mật khẩu mới của riêng bạn và lưu.

Câu hỏi thường gặp​

1. Tại sao tôi cần dừng Portainer trước?​

Vì Portainer khóa tệp portainer.db trong khi chạy; công cụ đặt lại không thể sửa đổi nó. Sau khi dừng, tệp được giải phóng và việc đặt lại có thể thành công.

2. Người dùng và cấu hình tôi đã tạo trước đó có bị mất sau khi đặt lại không?​

Thao tác này chỉ đặt lại mật khẩu tài khoản admin. Nó không xóa hoặc sửa đổi người dùng khác, môi trường chạy, tệp mẫu hoặc bất kỳ tham số cấu hình hệ thống nào.

3. Lệnh trả về docker: command not found?​

Điều này nghĩa là Docker Engine chưa được bật trên TNAS của bạn. Vào Trung tâm ứng dụng TNAS, cài đặt và bật Docker Engine, sau đó chạy lại lệnh.

4. Không có mật khẩu xuất ra sau khi thực thi lệnh?​

  • Kiểm tra xem đường dẫn thư mục dữ liệu có đúng không.
  • Xác nhận rằng Portainer đã dừng hoàn toàn.
  • Chạy lại lệnh.