适用范围与准备
适用于浏览器已收到Nextcloud的“Access through untrusted domain”页面。普通使用者先核对原入口;只有管理该实例的人才修改服务配置。本篇不处理DNS完全无法解析、TLS证书失败或密码错误。
先区分原因
trusted_domains限制的是用户访问Nextcloud所用的服务器主机名或IP,而不是客户端的来源IP名单。换了域名、端口或反向代理入口后出现提示,说明要核对请求身份与配置;换公共代理不能自动取得域名信任。
按顺序操作
- 记录地址栏的完整协议、主机、端口和路径,先与组织提供的原地址比较。若误用服务器IP或旧书签,回到已核对的正式域名,不在未知的新入口提交账号。
- 普通使用者把错误和脱敏地址发给实例管理员,不尝试获取服务器配置。管理员先确认Nextcloud版本、部署方式及真正生效的配置来源;容器、安装包和附加配置文件可能覆盖手改值。
- 备份现有配置,并检查trusted_domains中是否包含计划开放的准确主机名。条目使用主机名或允许的主机名加端口,不填写https://或/nextcloud路径,也不把访问者电脑的IP加进去。
- 确认新入口属于该实例且DNS、证书与反向代理已正确配置后,按部署方式追加一个最小范围条目,保留原有合法条目。下面只是配置片段,不是完整config.php;不能覆盖数据库、密钥或其他设置。
- 重新通过准确的新入口访问,旧入口也做回归。若修改没生效,核对配置加载与包管理方式,不用通配所有域名或移除安全检查来隐藏问题;反向代理的受信任代理设置也不等同于trusted_domains。
'trusted_domains' => [
'old.example.com',
'cloud.example.com:8443',
],| 字段或地址 | 用途 |
|---|---|
| trusted_domains | 允许作为服务入口的主机身份 |
| 客户端来源IP | 不是这个列表的对象 |
| HTTPS证书 | 另行证明服务身份,列表不会签发证书 |
| 反向代理配置 | 决定转发信息与信任边界,需独立核对 |
怎样确认有效
首先确认不再出现同一域名拒绝页面,再用已有账户验证授权功能;域名放行不授予账号或文件权限。仅网页能打开,不能证明所有同步客户端已切到新地址。
无效时恢复与下一步
出现配置错误或旧入口失效时恢复本次修改前的配置,并按原部署机制加载;保留错误日志供管理员分析。不要公开完整config.php。本文核对公开管理文档,未修改任何Nextcloud实例或测试真实账户。