K8s Nginx Ingress配路径前缀访问Nextcloud 子路径资源加载异常

• 你当前的Ingress配置仅完成了「外部带/nextcloud前缀的请求转发到后端Nextcloud服务根路径」的能力，但Nextcloud应用本身感知不到对外暴露的路径前缀是/nextcloud，默认会生成以根路径/开头的静态资源、接口链接，导致浏览器请求时丢失/nextcloud前缀。
• 现有Ingress配置没有给后端传递路径前缀的上下文，也没有对后端返回的重定向响应做修正。

1. 修改Ingress配置 #

调整后的完整Ingress配置如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nextcloud
  namespace: homeserver
  annotations:
    kubernetes.io/ingress.class: nginx
    cert-manager.io/cluster-issuer: letsencrypt-staging
    nginx.ingress.kubernetes.io/rewrite-target: /$2
    # 新增：自动修正后端返回的重定向头，补全/nextcloud前缀
    nginx.ingress.kubernetes.io/proxy-redirect: ^/ /nextcloud/
    nginx.ingress.kubernetes.io/configuration-snippet: |
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection $http_connection;
      # 新增：把对外路径前缀传递给后端应用
      proxy_set_header X-Forwarded-Prefix /nextcloud;
spec:
  rules:
  - host: www.myserver.com
    http:
      paths:
      - path: /nextcloud(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: nextcloud
            port:
              number: 80

2. 配置Nextcloud识别子路径前缀 #

这是核心修复步骤，让Nextcloud自身生成带/nextcloud前缀的链接，从根源避免资源路径错误：
如果手动修改Nextcloud的config.php配置文件，新增以下参数即可：

<?php
$CONFIG = array (
  // 保留原有配置不变，新增以下内容
  'overwritehost' => 'www.myserver.com',
  'overwritewebroot' => '/nextcloud',
  'overwrite.cli.url' => 'https://www.myserver.com/nextcloud',
  'htaccess.RewriteBase' => '/nextcloud',
);

如果使用官方Nextcloud容器镜像部署，可直接通过环境变量注入配置，无需手动修改文件：

• NEXTCLOUD_OVERWRITE_HOST=www.myserver.com
• NEXTCLOUD_OVERWRITE_WEBROOT=/nextcloud
• NEXTCLOUD_OVERWRITE_CLI_URL=https://www.myserver.com/nextcloud
• NEXTCLOUD_HTDOCS_RewriteBase=/nextcloud

配置完成后重启Nextcloud服务即可生效。

内容的提问来源于stack exchange，提问作者jbssm