如何使用 OCC 重設 Nextcloud 管理員密碼

如果您無法再使用管理員帳號登入 Nextcloud，occ可以使用伺服器端指令重設該帳戶密碼，而無需使用 Web 介面。 Nextcloudocc是 Nextcloud 的命令列管理介面。重設操作會變更 Nextcloud 帳號密碼，但不會變更您的 Linux 登入密碼、資料庫密碼或主機控制面板密碼。

本教學使用 2026 年 10 月 6 日發布的最新版 Nextcloud 35 管理手冊。基本命令在多個版本中保持穩定，但安裝路徑、PHP 命令、服務帳戶和容器工作流程可能有所不同。請務必在確認自身實例的安裝方式後再使用範例值。

重置前你需要準備什麼

• 對執行 Nextcloud PHP 應用程式的伺服器或容器進行 Shell 存取。
• Nextcloud 安裝目錄的檔案系統路徑，即包含該occ檔案的目錄。
• 需要更改密碼的 Nextcloud 帳戶 ID 的確切地址。帳戶 ID 不能是空地址admin。
• Web 伺服器或 PHP 執行階段所使用的作業系統帳戶。在 Debian 和 Ubuntu 系統中，這通常是www-data；其他系統可能使用其他帳戶。
• 儲存在密碼管理器中的全新唯一密碼。

occ請以 HTTP 使用者（即執行 Web 應用程式的作業系統帳戶）身分執行，以確保檔案所有權和權限的一致性。 Nextcloud 的使用手冊中對此要求有詳細說明。即使您擁有 sudo 權限，也不要預設以 root 使用者身分執行命令。

第一步：找到正確的安裝程式和帳戶

透過 SSH 連線或開啟託管環境提供的 shell。切換到 Nextcloud 安裝目錄。常見的來源安裝路徑是 `/etc/Nextcloud/` /var/www/nextcloud，但軟體包、應用程式、容器和託管服務可能使用不同的路徑。

cd /var/www/nextcloud
ls -l occ

第二條指令應該會顯示一個occ檔案。如果沒有顯示，請停止操作並找到實際的應用程式目錄，而不是嘗試猜測路徑。如果您使用的是不同的帳戶名，請admin在後面的命令中將其替換為實際的 Nextcloud 使用者 ID。使用者 ID 不一定是顯示名稱或電子郵件地址。

步驟 2：執行互動式密碼重置

對於典型的 Debian 或 Ubuntu 原始碼安裝，如果其 Web 伺服器運行在 `Nextcloud` 目錄下www-data，請從 Nextcloud 目錄執行以下命令：

sudo -E -u www-data php occ user:resetpassword admin

www-data如果您的伺服器使用不同的 HTTP 用戶，請替換為admin已確認的帳戶 ID。如果您目前不在安裝目錄中，請使用完整路徑：

sudo -E -u www-data php /var/www/nextcloud/occ user:resetpassword admin

Nextcloud 會提示您輸入新密碼並要求您確認。通常情況下，輸入密碼時不會顯示密碼字元；這是正常現象。請在兩次提示中都輸入相同的密碼。成功訊息會確認 Nextcloud 已接受重設密碼。

步驟 3：僅將環境變數用於自動化

Nextcloud 也支援--password-from-env腳本操作。它會從OC_PASS環境變數中讀取密碼。請避免將真實密碼直接寫入命令列、shell 歷史記錄、提交到原始程式碼控制系統的腳本或共用的終端記錄中。

對於一次性 shell 會話，您可以輸入金鑰而不回顯它，將其匯出，運行文件中記錄的命令，然後將其清除：

read -s OC_PASS
export OC_PASS
sudo -E -u www-data php occ user:resetpassword --password-from-env admin
unset OC_PASS

read -s輸入新密碼後，按 Enter 鍵；輸入內容將保持隱藏狀態。此-E選項會要求 sudo 保留目前環境，但本地 sudo 策略可能會限制此行為。如果命令提示OC_PASS缺少或為空，請改用互動式重置或遵循平台的金鑰管理流程。切勿僅為了讓腳本運作而停用 sudo 安全措施。

第四步：驗證帳號是否可以登入

在隱私瀏覽視窗中開啟您常用的 Nextcloud URL，或登出目前工作階段，然後使用相同的帳戶 ID 和新密碼登入。成功登入表示憑證在 Web 應用程式中有效，而不僅僅是 CLI 命令已運行。如果您的組織使用雙重身份驗證，也請完成相應的驗證。

常見問題及應對方法

• Could not open input file: occ或出現檔案缺失錯誤：您可能位於錯誤的目錄或使用了錯誤的路徑。找到已安裝的occ文件，然後在該文件所在目錄下重新運行命令。
• 權限或所有權錯誤：檢查您的發行版對應的 Web 伺服器/PHP 帳戶，並以該帳戶身分執行命令。不要為了快速解決問題而遞歸更改所有權；這樣做可能會導致更廣泛的存取問題。
• 出現「使用者不存在」或類似帳號錯誤：請確認帳號 ID，包括大小寫（如適用）。除非電子郵件地址確實是帳號 ID，否則請勿替換為電子郵件地址。
• php如果缺少 PHP 命令列工具或選擇了錯誤的 PHP 版本：請使用 Nextcloud 安裝和託管平台支援的 PHP CLI 二進位檔案。一台伺服器上可以安裝多個 PHP 版本，因此不要假設預設命令與 Web 執行時間環境相符。
• 伺服器運行在 Docker、Nextcloud AIO、Snap 或虛擬設備上：請在應用程式環境中運行occ，並遵循該部署的官方命令流程。主機路徑、容器名稱和運行時使用者各不相同；從來源安裝複製的主機級命令可能指向錯誤的檔案系統。
• 此帳戶由 LDAP 或 Active Directory 管理：這些系統可以作為帳戶憑證的權威。本機 Nextcloud 密碼重設可能無法更新外部管理的密碼。請依照目錄管理員的重設步驟操作，並檢查您的身分提供者配置。
• 您沒有 shell 存取權限：如果帳戶在 Nextcloud 中儲存了有效的電子郵件地址，請嘗試登入頁面的密碼重設連結；或請其他 Nextcloud 管理員或您的主機服務提供者重設密碼。

康復後應避免的事項

請勿直接編輯 Nextcloud 資料庫來取代密碼雜湊。請勿變更作業系統密碼以期重設 Nextcloud 使用者。請妥善保管新密碼，從 shell 環境中移除任何臨時金鑰，並將其儲存在您的密碼管理器中。如果您懷疑舊憑證已洩露，請按照您所在組織的正常安全流程審查存取權限。

官方參考資料

Nextcloud 在「重設遺失的管理員密碼」文件中記錄了復原選項和遺失管理員密碼的解決方法。支援的命令、密碼提示和環境變數選項在「使用者和群組命令」以及「使用 occ 命令」中進行了描述。