Federated shares with users of the same instance can deadlock PHP-FPM – create internal shares instead

未关闭
#66,675 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
20/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
活跃
技术栈
php
领域
backend, databases

调研方向

Start by reading the sharing implementation and the related issues #3042, #36790, and #65766 mentioned in the report. Trace how federated shares are created from the share dialog and public-link flow, and how share records are stored and removed. The requested work includes local recipient detection, link-bound internal shares, cleanup, an occ command, and a setup check; done means these paths avoid self-federated requests while preserving permissions and link revocation.

由索引模型根据 Issue 内容生成。

描述

0. Needs triage enhancement

[!TIP]

Help move this idea forward
  • Use the 👍 reaction to show support for this feature.
  • Avoid commenting unless you have relevant information to add; unnecessary comments create noise for subscribers.
  • Subscribe to receive notifications about status changes and new comments.

Is your feature request related to a problem? Please describe.

Users can create federated shares with other users on the same instance. Nextcloud then talks to itself over HTTPS for every access to such a share. This can take down the whole instance.

There are two ways users end up with these "self-federated" shares:

  1. Share dialog: The owner enters [email protected] (the cloud ID of a local user) instead of just user. The current check only prevents a federated share with the same user, not with other local users.
  2. Public link: A logged-in user opens a public link from the same instance and uses "Add to your Nextcloud". This creates a federated share to the own instance.

What happened on our instance (Nextcloud 34.0.2, Apache + PHP-FPM, pm.max_children = 5 at the time):

  • Five self-federated shares existed. When users browsed folders inside them (e.g. folders with many images), each request occupied a PHP-FPM worker, which then made an HTTPS request to the same instance and waited for a free worker.
  • Once all workers were busy, they waited for each other: a deadlock. The instance stopped responding entirely for about a day, until PHP-FPM was restarted.
  • The PHP-FPM log showed server reached pm.max_children setting, Apache logged AH01075: Error dispatching request ... (polling) for every request, and nextcloud.log showed error while discovering ocm provider and files_lock: Failed to get remote lock from DAV: Gateway Timeout for paths inside the self-federated shares.

More workers make this less likely, but do not prevent it. Self-federated shares also have no benefit over internal shares: the data is on the same server either way.

Describe the solution you'd like

1. Share dialog: create an internal share instead

When the recipient of a federated share is a cloud ID that resolves to the own instance, Nextcloud should create a regular internal share with the local user instead, with the same permissions. The owner intended to share with exactly this user, so this is safe.

Detection should consider all names of the instance (trusted_domains, overwrite.cli.url) and normalize scheme, trailing slashes and subpaths. Our instance alone is reachable under three hostnames.

2. Public link: link-bound internal shares

For links, simply converting into an internal share would be wrong: the owner would lose the ability to revoke access by deleting the link. I'd suggest a model similar to OneDrive/SharePoint:

  • When a logged-in user of the same instance opens a public link, offer "Add to my files" instead of "Add to your Nextcloud".
  • This creates an internal share that is bound to the link share. Its permissions never exceed those of the link.
  • In the sharing sidebar, the owner sees which users have added the link this way.
  • When the link is deleted or expires, all shares bound to it are removed as well.

This keeps the semantics of a link ("whoever has the link has access, until I revoke it") while avoiding the round trip over HTTPS.

3. For existing installations

An occ command that lists existing self-federated shares (share_external entries whose remote points to the own instance) and optionally converts them, plus a setup check warning about them.

Describe alternatives you've considered

  • Disabling federated sharing: not possible for us, we also use federation with other servers.
  • Disabling only "Add to your Nextcloud" for public links: closes the second path, not the first.
  • Lowering davstorage.request_timeout and setting request_terminate_timeout in PHP-FPM: limits the damage, but does not fix the cause. This is what we did for now.
  • Converting the shares manually in the database: error-prone, since several tables are involved.

Additional context

  • Version: We are on 34.0.2. The changelogs of 34.0.3 to 34.0.6 contain no change addressing this. I have not been able to test Nextcloud 35, where sharing is being reworked ("Unified sharing remote recipients", #64919; "Allow remote owners and initiators", #65915). If that already covers this case, I'd be glad for a pointer.
  • #3042: A Nextcloud developer already suggested creating an internal share when the entered cloud ID belongs to the same server ("Add to your Nextcloud"). The issue was later closed because the original bug was no longer reproducible; the suggestion itself was never implemented.
  • #36790: Self-federated share via "Add to your Nextcloud" leaves stale data in oc_filecache (closed due to missing info).
  • #65766: An unreachable federated remote blocks the user's whole filesystem. Same underlying problem: requests to a federated remote can hold workers indefinitely.
  • #3539: Two instances sharing one PHP-FPM pool deadlock on federated shares.
主要语言
PHP
星标
37.5k
派生
5.4k
平均合并
1 天 13 小时
30 天内合并 PR
639

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

nextcloud/server 的其他 Issue

查看 nextcloud/server 的全部 Issue

相似的 Issue

更多 PHP Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。