适用范围与准备

适用于浏览器已收到Nextcloud的“Access through untrusted domain”页面。普通使用者先核对原入口;只有管理该实例的人才修改服务配置。本篇不处理DNS完全无法解析、TLS证书失败或密码错误。

先区分原因

trusted_domains限制的是用户访问Nextcloud所用的服务器主机名或IP,而不是客户端的来源IP名单。换了域名、端口或反向代理入口后出现提示,说明要核对请求身份与配置;换公共代理不能自动取得域名信任。

按顺序操作

  1. 记录地址栏的完整协议、主机、端口和路径,先与组织提供的原地址比较。若误用服务器IP或旧书签,回到已核对的正式域名,不在未知的新入口提交账号。
  2. 普通使用者把错误和脱敏地址发给实例管理员,不尝试获取服务器配置。管理员先确认Nextcloud版本、部署方式及真正生效的配置来源;容器、安装包和附加配置文件可能覆盖手改值。
  3. 备份现有配置,并检查trusted_domains中是否包含计划开放的准确主机名。条目使用主机名或允许的主机名加端口,不填写https://或/nextcloud路径,也不把访问者电脑的IP加进去。
  4. 确认新入口属于该实例且DNS、证书与反向代理已正确配置后,按部署方式追加一个最小范围条目,保留原有合法条目。下面只是配置片段,不是完整config.php;不能覆盖数据库、密钥或其他设置。
  5. 重新通过准确的新入口访问,旧入口也做回归。若修改没生效,核对配置加载与包管理方式,不用通配所有域名或移除安全检查来隐藏问题;反向代理的受信任代理设置也不等同于trusted_domains。
PHP配置片段示意;保留现有条目并按实际主机替换,不能整文件覆盖
'trusted_domains' => [
    'old.example.com',
    'cloud.example.com:8443',
],
字段或地址用途
trusted_domains允许作为服务入口的主机身份
客户端来源IP不是这个列表的对象
HTTPS证书另行证明服务身份,列表不会签发证书
反向代理配置决定转发信息与信任边界,需独立核对

怎样确认有效

首先确认不再出现同一域名拒绝页面,再用已有账户验证授权功能;域名放行不授予账号或文件权限。仅网页能打开,不能证明所有同步客户端已切到新地址。

无效时恢复与下一步

出现配置错误或旧入口失效时恢复本次修改前的配置,并按原部署机制加载;保留错误日志供管理员分析。不要公开完整config.php。本文核对公开管理文档,未修改任何Nextcloud实例或测试真实账户。