Snipe-IT在子目录部署时的登录重定向问题解决方案

背景介绍

Snipe-IT是一款流行的开源IT资产管理软件。在实际部署中，很多用户会选择将Snipe-IT安装在Web服务器的子目录下（如/snipe-it），而非根目录。这种部署方式虽然官方文档有所提及，但在实际配置过程中会遇到一些技术挑战，特别是登录后的重定向问题。

问题现象

当Snipe-IT部署在子目录时，用户登录后会被错误地重定向到网站根目录(/)而非预期的子目录(/snipe-it)。这不仅破坏了用户体验，还可能导致功能异常。

问题根源分析

经过深入分析，这个问题主要源于LoginController.php中的重定向逻辑。默认实现中，redirect()->intended()方法没有正确处理子目录部署场景，导致生成的URL缺少子目录前缀。

解决方案

1. 基础配置调整

首先确保以下基础配置正确：

1. 在.env文件中设置：

   APP_URL=https://your-domain/snipe-it
   LIVEWIRE_URL_PREFIX=/snipe-it
   

2. Apache配置中添加Alias指令：

   Alias /snipe-it "/var/www/html/public"
   

2. .htaccess文件修改

修改public/.htaccess文件：

1. 在RewriteEngine On后添加：

   RewriteBase /snipe-it
   

2. 调整目录重写规则：

   RewriteCond %{REQUEST_URI} snipe-it/(.+)/$
   

3. 核心重定向逻辑优化

对于Docker部署，需要修改LoginController.php中的重定向逻辑。替换默认的：

return redirect()->intended()->with('success', trans('auth/message.signin.success'));

为以下更健壮的实现：

$originalUrl = redirect()->intended()->getTargetUrl();
$baseUrl = url('/');
$path = parse_url($originalUrl, PHP_URL_PATH);
$safePath = is_null($path) ? "" : $path;
$intendedUrl = $baseUrl . $safePath;
return redirect()->to($intendedUrl)->with('success', trans('auth/message.signin.success'));

这段代码的工作原理：

1. 获取原始重定向URL（可能缺少子目录前缀）
2. 获取包含子目录的基准URL
3. 提取原始URL中的路径部分
4. 安全处理路径为空的情况
5. 构建包含正确子目录前缀的完整URL

注意事项

1. 此方案特别适用于Docker部署场景
2. 修改容器内文件是临时方案，容器重建后会失效
3. 对于生产环境，建议构建自定义镜像或使用配置管理工具持久化这些修改

总结

虽然官方不完全推荐子目录部署方式，但通过合理的配置调整，特别是重定向逻辑的优化，完全可以实现稳定可靠的子目录部署方案。这个解决方案不仅解决了登录重定向问题，还保持了扫描资产标签等功能的正常使用，为用户提供了完整的体验。

对于需要在子目录部署Snipe-IT的用户，建议仔细测试所有功能，特别是涉及URL重定向的场景，确保系统在各种使用情况下都能正常工作。