Laravel访问局域网共享文件链接自动追加本地地址无法跳转如何解决

你的问题核心是SMB共享路径未指定协议时，浏览器会识别为当前站点下的相对路径，自动拼接当前站点域名导致跳转错误，可按以下方案处理： #

方案1：直接使用标准file协议格式输出链接 #

• 不要使用Laravel的url()、route()等辅助函数包裹SMB路径，这类函数会自动拼接当前站点域名生成相对链接
• 将原路径的反斜杠全部替换为正斜杠，补全file://///协议前缀（局域网SMB共享的标准file URI格式为5个斜杠开头），最终输出的链接格式如下：

<a href="file://///192.168.0.100/Adjuntos/Gerencia.docx">下载Gerencia.docx</a>

• 注意：Chrome、Edge等现代浏览器默认禁止HTTP/HTTPS站点跳转file协议链接，你需要将内部站点域名加入浏览器的file协议访问白名单，可通过组策略批量配置公司内所有设备的浏览器规则。

方案2：Laravel做代理下载（兼容性最优，无需修改浏览器配置） #

如果不想调整浏览器安全策略，可以在Laravel侧实现SMB文件代理下载，由后台服务读取局域网共享文件后返回给前端，操作步骤如下：

1. 安装SMB操作扩展包

composer require icewind/smb

2. 新增下载路由，正则匹配完整文件路径

// routes/web.php
Route::get('/smb-download/{filePath}', [SmbDownloadController::class, 'download'])
    ->where('filePath', '.*')
    ->name('smb.download');

3. 编写控制器逻辑，添加路径校验防止目录遍历漏洞

<?php

namespace App\Http\Controllers;

use Icewind\SMB\BasicAuth;
use Icewind\SMB\Server;
use Illuminate\Http\Request;

class SmbDownloadController extends Controller
{
    public function download(Request $request, string $filePath)
    {
        // 校验路径仅允许访问指定共享目录，防止恶意遍历
        $allowedDir = 'Adjuntos/';
        if (!str_starts_with($filePath, $allowedDir)) {
            abort(403, '无权访问该路径文件');
        }

        // 初始化SMB连接，替换为你实际的共享账号密码
        $auth = new BasicAuth('共享账号', 'WORKGROUP', '共享密码');
        $server = new Server('192.168.0.100', $auth);
        $share = $server->getShare('你的共享文件夹名称');

        // 返回流式下载响应
        return response()->streamDownload(function () use ($share, $filePath) {
            $stream = $share->read($filePath);
            fpassthru($stream);
            fclose($stream);
        }, basename($filePath));
    }
}

4. 前端直接调用代理下载路由即可

<a href="{{ route('smb.download', ['filePath' => 'Adjuntos/Gerencia.docx']) }}">下载Gerencia.docx</a>

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