安裝

You can download the latest version of the Nextcloud Desktop Synchronization Client from the Nextcloud download page. There are clients for Linux, macOS, and Microsoft Windows.

目前支持的伺服器版本是發佈時最新的三個穩定版本。這意味著 latest 發佈系列支持穩定的伺服器主要版本。請參閱 https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule 獲取支持的主要版本。

Installation on macOS and Windows is the same as for any software application: download the program and then double-click it to launch the installation, and then follow the installation wizard. After it is installed and configured the sync client will automatically keep itself updated; see 自動更新器 for more information.

Linux 用戶必須按照下載頁面上的指示添加適合其 Linux 發行版的存儲庫，安裝簽名密鑰，然後使用其包管理器安裝桌面同步客戶端。Linux 用戶還將通過包管理器更新其同步客戶端，當有可用更新時，客戶端會顯示通知。

Linux 用戶還必須啟用密碼管理器，如 GNOME Keyring 或 KWallet，以便同步客戶端可以自動登錄。

您還可以在下載頁面上找到源代碼檔案和舊版本的鏈接。

系統要求

Windows 10+（僅限 64 位）
macOS 11.4+（僅限 64 位）
Linux (Ubuntu 22.04 or openSUSE 15.5 or ...) (64-bits only)

Note

對於 Linux 發行版，我們支持當前的 LTS 版本（如果技術上可行）。對於 BSD，如果技術上可行，我們也支持，但不進行測試。

自定義 Windows 安裝

如果您只是想在本地系統上安裝 Nextcloud 桌面同步客戶端，您可以簡單地啟動 .msi 檔案並在彈出的嚮導中進行配置。

功能

MSI 安裝程式提供了幾個可以單獨安裝或移除的功能，您也可以通過命令行控制它們。如果您正在自動化安裝，請運行以下命令：

msiexec /passive /i Nextcloud-x.y.z-x64.msi

該命令將把 Nextcloud 桌面同步客戶端安裝到默認位置並啟用默認功能。如果您想禁用，例如，桌面快捷方式圖標，您可以簡單地將上述命令更改為以下內容：

msiexec /passive /i Nextcloud-x.y.z-x64.msi REMOVE=DesktopShortcut

請參見以下表格以獲取可用功能的列表：

功能	預設啟用	描述	禁用屬性
客戶端	是，必需	實際客戶端
桌面快捷方式	是	在桌面添加快捷方式	`NO_DESKTOP_SHORTCUT`
開始菜單快捷方式	是	在開始菜單添加快捷方式	`NO_START_MENU_SHORTCUTS`
外殼擴展	是	添加檔案管理器集成	`NO_SHELL_EXTENSIONS`

安裝

您還可以選擇僅安裝客戶端本身，使用以下命令：

msiexec /passive /i Nextcloud-x.y.z-x64.msi ADDDEFAULT=Client

例如，如果您想安裝所有功能，但不包括 DesktopShortcut 和 ShellExtensions 功能，您有兩種選擇：

You explicitly name all the features you actually want to install (whitelist) where Client is always installed anyway:
```
msiexec /passive /i Nextcloud-x.y.z-x64.msi ADDDEFAULT=StartMenuShortcuts
```

You pass the NO_DESKTOP_SHORTCUT and NO_SHELL_EXTENSIONS properties:

msiexec /passive /i Nextcloud-x.y.z-x64.msi NO_DESKTOP_SHORTCUT="1" NO_SHELL_EXTENSIONS="1"

Note

The Nextcloud .msi remembers these properties, so you don't need to specify them on upgrades.

Note

您無法使用這些來更改已安裝的功能，如果您想這樣做，請參見下一部分。

更改已安裝的功能

You can change the installed features later by using REMOVE and ADDDEFAULT properties.

如果您想稍後添加桌面快捷方式，請運行以下命令：
```
msiexec /passive /i Nextcloud-x.y.z-x64.msi ADDDEFAULT="DesktopShortcut"
```

如果您想刪除它，只需運行以下命令：

msiexec /passive /i Nextcloud-x.y.z-x64.msi REMOVE="DesktopShortcut"

Windows keeps track of the installed features and using REMOVE or ADDDEFAULT will only affect the mentioned features.

比較 REMOVE 和 ADDDEFAULT 參考 Windows 安裝程序指南。

Note

You cannot specify REMOVE on initial installation as it will disable all features.

安裝資料夾

You can adjust the installation folder by specifying the INSTALLDIR property like this:

msiexec /passive /i Nextcloud-x.y.z-x64.msi INSTALLDIR="C:\Program Files\Non Standard Nextcloud Client Folder"

Be careful when using PowerShell instead of cmd.exe, it can be tricky to get the whitespace escaping right there. Specifying the INSTALLDIR like this only works on first installation, you cannot simply re-invoke the .msi with a different path. If you still need to change it, uninstall it first and reinstall it with the new path.

禁用自動更新

To disable automatic updates, you can pass the SKIPAUTOUPDATE property.:

msiexec /passive /i Nextcloud-x.y.z-x64.msi SKIPAUTOUPDATE="1"

安裝後啟動

To launch the client automatically after installation, you can pass the LAUNCH property.:

msiexec /i Nextcloud-x.y.z-x64.msi LAUNCH="1"

此選項還會移除復選框，讓用戶決定是否要在非被動/安靜模式下啟動客戶端。

Note

此選項在沒有 GUI 的情況下不會有任何效果。

安裝後不重新啟動

The Nextcloud Client schedules a reboot after installation to make sure the Explorer extension is correctly (un)loaded. If you're taking care of the reboot yourself, you can set the REBOOT property:

msiexec /i Nextcloud-x.y.z-x64.msi REBOOT=ReallySuppress

This will make msiexec exit with error ERROR_SUCCESS_REBOOT_REQUIRED (3010). If your deployment tooling interprets this as an actual error and you want to avoid that, you may want to set the DO_NOT_SCHEDULE_REBOOT instead:

msiexec /i Nextcloud-x.y.z-x64.msi DO_NOT_SCHEDULE_REBOOT="1"

安裝嚮導

安裝嚮導將逐步引導您完成配置選項和帳戶設置。首先，您需要輸入 Nextcloud 伺服器的 URL。

如果您已經在 Nextcloud 實例上擁有帳戶，您可以按下 登錄到您的 Nextcloud 按鈕。如果您沒有 Nextcloud 實例和帳戶，您可能想要與提供商註冊帳戶。在這種情況下，請按 使用提供商創建帳戶。請記住，桌面客戶端可能未提供提供商支持。在這種情況下，您將不會看到此頁面，而是會被提示進入下一頁。

輸入您的 Nextcloud 實例的 URL。該 URL 與您嘗試訪問 Nextcloud 實例時在瀏覽器中輸入的 URL 相同。

現在您的網頁瀏覽器應該會打開並提示您登錄到 Nextcloud 實例。請在網頁瀏覽器中輸入您的用戶名和密碼並授予訪問權限。完成後，請返回到嚮導。請記住，如果您已經登錄到瀏覽器，則可能不需要再次輸入用戶名和密碼。

在本地資料夾選項屏幕上，您可以同步 Nextcloud 伺服器上的所有檔案或選擇單個資料夾。預設的本地同步資料夾是 Nextcloud，位於您的主目錄中。您也可以更改這個設定。

當您完成選擇同步資料夾後，請單擊右下角的連接按鈕。客戶端將嘗試連接到您的 Nextcloud 伺服器，當成功連接時，嚮導會自動關閉。您現在可以通過單擊系統托盤圖示來打開主對話框，觀察同步活動。