Nextcloud 单点登录

用 Casdoor 配置 Nextcloud

1. 1

   在 Casdoor 中注册 Nextcloud

   在 Casdoor 控制台打开 应用，为 Nextcloud 添加一个应用，在它的 OIDC/OAuth 标签页复制 客户端ID 和 客户端密钥。把下面的地址加到 重定向URLs：

   • https://cloud.example.com/apps/user_oidc/code

   If your Nextcloud URLs include /index.php, use https://cloud.example.com/index.php/apps/user_oidc/code instead. 要用群组的话，先在应用所属的组织里创建群组（例如 family or finance）并加入用户，再在同一个标签页把 Token 中的群组格式 设成 Name，这样令牌里是 family，而不是 <组织>/family。

2. 2

   Install the OpenID Connect app

   Install OpenID Connect user backend from the Nextcloud app store, or with occ:

   sudo -u www-data php occ app:install user_oidc

3. 3

   Add Casdoor as a provider

   Run this from the Nextcloud directory. It names the provider Casdoor, maps Nextcloud user IDs to Casdoor usernames instead of hashes, and creates Nextcloud groups from the groups claim.

   sudo -u www-data php occ user_oidc:provider Casdoor \
     --clientid="<client ID>" \
     --clientsecret="<client secret>" \
     --discoveryuri="https://auth.example.com/.well-known/openid-configuration" \
     --scope="openid email profile" \
     --unique-uid=0 \
     --mapping-uid=name \
     --mapping-display-name=displayName \
     --mapping-email=email \
     --mapping-groups=groups \
     --group-provisioning=1

4. 4

   Sign in

   The Nextcloud login page now has a Log in with Casdoor button. To send everyone straight to Casdoor, turn off the other login methods; administrators can still reach the normal login form by adding ?direct=1 to the login URL.

   sudo -u www-data php occ config:app:set --type=string --value=0 user_oidc allow_multiple_user_backends

Nextcloud 的设置取自它的官方文档（核对于 2026年10月：Nextcloud user_oidc）；另见Casdoor 文档。Nextcloud 是其所有者的商标。