Lewati ke konten utama

Langkah-Langkah Mengatur Ulang Kata Sandi Administrator Portainer

Ketika Anda lupa kata sandi akun administrator Portainer dan tidak dapat masuk ke Portainer, sistem TerraMaster TNAS mendukung pengaturan ulang kata sandi akun melalui perintah terminal SSH. Anda dapat menggunakan metode ini untuk mengatur ulang kata sandi login admin tanpa kehilangan apa pun, memungkinkan Anda masuk ke Portainer dengan normal tanpa menginstal ulang aplikasi dan kehilangan data konfigurasi yang ada.

Prasyarat​

  1. Buka terminal SSH TNAS Anda.
  2. Pastikan Portainer telah dihentikan di App Center TNAS (harus dihentikan, jika tidak file basis data terkunci dan pengaturan ulang akan gagal).

Langkah-Langkah​

1. Temukan direktori data Portainer Anda​

Pertama, temukan folder data Portainer yang berisi portainer\.db.

Jalankan perintah berikut:

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

Setelah eksekusi, Anda akan melihat output yang mirip dengan:

/Volume1/@apps/Portainer/portainer.db

Catat awalan jalur /Volume1/@apps/Portainer – ini adalah direktori data Anda.

2. Jalankan perintah pengaturan ulang resmi​

Ganti /path/to/portainer dalam perintah di bawah ini dengan jalur direktori data yang Anda temukan pada langkah sebelumnya, lalu salin dan jalankan di terminal:

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

Misalnya:

Jika direktori data Anda adalah /Volume1/@apps/Portainer, perintah lengkapnya adalah:

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

3. Dapatkan kata sandi baru​

Setelah menjalankan perintah, terminal akan menampilkan sesuatu seperti:

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!@#$
  • Baris pertama menunjukkan pengaturan ulang berhasil.
  • aBcD1234!@#$ pada baris kedua adalah kata sandi baru sementara – salin!

4. Mulai Portainer dan masuk​

  1. Kembali ke App Center TNAS dan mulai ulang Portainer.
  2. Buka halaman web Portainer (alamat default: http://your_TNAS_IP:9000).
  3. Masukkan admin sebagai username, tempel kata sandi sementara yang Anda salin dari langkah sebelumnya, dan Anda dapat masuk.

5. (Sangat disarankan) Segera ubah kata sandi setelah masuk​

  1. Setelah masuk ke Portainer, klik avatar pengguna di sudut kanan atas.
  2. Pilih My Account → Change Password.
  3. Masukkan kata sandi sementara, atur kata sandi baru Anda sendiri, dan simpan.

Pertanyaan yang Sering Diajukan​

1. Mengapa saya perlu menghentikan Portainer terlebih dahulu?​

Karena Portainer mengunci file portainer.db saat berjalan; alat pengaturan ulang tidak dapat memodifikasinya. Setelah dihentikan, file dilepaskan dan pengaturan ulang dapat berhasil.

2. Apakah pengguna dan konfigurasi yang saya buat sebelumnya akan hilang setelah pengaturan ulang?​

Operasi ini hanya mengatur ulang kata sandi akun admin. Ini tidak menghapus atau memodifikasi pengguna lain, lingkungan runtime, file template, atau parameter konfigurasi sistem apa pun.

3. Perintah mengembalikan docker: command not found?​

Ini berarti Docker Engine tidak diaktifkan pada TNAS Anda. Buka App Center TNAS, instal dan aktifkan Docker Engine, lalu jalankan perintah lagi.

4. Tidak ada output kata sandi setelah menjalankan perintah?​

  • Periksa apakah jalur direktori data sudah benar.
  • Konfirmasi bahwa Portainer telah sepenuhnya berhenti.
  • Jalankan perintah lagi.