Apache如何配置相对路径指向用户目录站点实现资源正确加载

你遇到的问题是mod_userdir部署的站点下，根相对路径资源默认指向域名根目录而非用户子目录，以下是三种可直接落地的解决方式，按推荐优先级排序：

方法1：页面添加base标签（零服务器配置，性能最优） #

如果你能修改站点HTML代码，优先用这个方案，没有额外服务器开销，不需要调整Apache配置。
直接在所有HTML页面的<head>标签最开头加入base标签：

<base href="/~user1/">

加完后页面内所有写为根相对路径的资源（包括/images/xxx.png、/css/xxx.css这类路径）、站内跳转链接、表单提交地址，都会自动以/~user1/作为根路径解析，不需要修改原有任何src、href属性值。配置完成后清理浏览器缓存即可生效。

注意：如果页面中有带锚点的跳转（比如href="#top"），部分旧版浏览器可能受base标签影响，遇到这类场景单独给锚点链接补全路径即可。

方法2：.htaccess配置重写规则（无需改代码，单用户场景适用） #

如果不方便改站点代码，用Apache重写规则实现路径自动转发即可。

• 先开启Apache重写模块并重载服务：

  a2enmod rewrite
  systemctl reload apache2
  

• 编辑mod_userdir的配置文件（一般路径为/etc/apache2/mods-available/userdir.conf），确保你存放站点的用户目录开启了AllowOverride权限，参考配置如下：

  <Directory /home/*>
      AllowOverride All
      Options FollowSymLinks Indexes
      Require all granted
  </Directory>
  

  改完配置记得执行systemctl reload apache2生效。
• 在站点根目录/home/user1下新建.htaccess文件，写入以下重写规则：

  RewriteEngine On
  # 跳过已经是用户目录路径的请求，避免循环重写
  RewriteCond %{REQUEST_URI} ^/~
  RewriteRule ^ - [L]
  
  # 把所有根路径开头的静态资源请求重写到当前用户目录下
  # 可根据自己的资源目录增删判断条件
  RewriteRule ^(images|css|js|static|uploads)/(.*)$ /~user1/$1/$2 [L]
  

  如果需要把所有根路径请求（不止静态资源）都转到用户目录下，把最后一条重写规则替换成下面的即可：

  RewriteRule ^(.*)$ /~user1/$1 [L]
  

• 给.htaccess文件加可读权限，确保Apache运行用户能正常读取：

  chmod 644 /home/user1/.htaccess
  

方法3：全局虚拟主机配置重写（多用户场景适用） #

如果你服务器上有多个/~username格式的用户站点，不想逐个配置.htaccess，可以直接在对应虚拟主机的配置文件中写全局规则，基于请求来源自动匹配对应用户目录：

<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/html

    # 启用mod_userdir，按你的实际路径配置用户目录映射
    UserDir enabled
    UserDir /home/*

    # 开启重写引擎
    RewriteEngine On
    # 基于请求Referer判断当前访问的用户目录，自动转发根路径静态资源
    RewriteCond %{HTTP_REFERER} https?://example.com/~([a-zA-Z0-9_-]+)/
    RewriteRule ^/(images|css|js|static|uploads)/(.*)$ /~%1/$1/$2 [L]
</VirtualHost>

改完配置执行systemctl reload apache2即可生效。这个方案的缺点是依赖HTTP Referer头，部分隐私模式、安全插件可能会禁用Referer发送，会导致资源加载失败，稳定性不如前两个方案。

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