Laravel 服务器 IP 检测与下载分流

接口说明

本文同时说明服务端检测服务器 IP 与浏览器端按访客 IP 下载分流，两者用途不同，不能混淆。

{"ip":"185.220.236.7","country":"TW","region":"Taiwan","city":"Taipei"}

应用场景

这些场景都能体现 IP 信息接口价值，并明确区分服务器 IP 与访客 IP。

• 后台查看 Laravel 服务器出口 IP
• 确认服务器或代理节点所在地区
• 下载页按访客国家切换节点
• 为不同地区用户提供不同下载线路
• 排查服务器网络和用户下载体验问题

实现逻辑

实现前先确认请求发起方：服务器发起请求得到服务器 IP，浏览器发起请求得到访客 IP。

• Laravel 后端请求接口检测服务器出口 IP
• 下载页由 Blade 输出默认下载链接
• 浏览器请求接口识别访客地区
• 根据 country 替换下载节点
• 接口失败时继续使用默认链接

代码示例

以下代码都直接使用 https://my.ipin.io/info，注释和界面文字均已本地化。

IpController

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\Http;

class IpController extends Controller
{
    public function server()
    {
        $info = ['ip'=>'Unknown', 'country'=>'Unknown', 'region'=>'Unknown', 'city'=>'Unknown'];
        try {
            // 服务端调用 /info：检测服务器当前出口 IP。
            $response = Http::timeout(3)->get('https://my.ipin.io/info');
            if ($response->successful()) { $info = array_merge($info, $response->json()); }
        } catch (\Throwable $e) {}
        return view('server-ip', ['info' => $info]);
    }

    public function download()
    {
        return view('download');
    }
}

server-ip.blade.php

<div class="server-ip-box">
  <h2>服务器出口 IP 信息</h2>
  <p>IP：{{ $info['ip'] }}</p>
  <p>Country：{{ $info['country'] }}</p>
  <p>Region：{{ $info['region'] }}</p>
  <p>City：{{ $info['city'] }}</p>
</div>

download.blade.php

<div class="download-box">
  <a id="ipinDownloadBtn" href="/download/default/app.zip">Download</a>
  <p id="ipinDownloadNode">Default</p>
</div>
<script>
(async function () {
  const el = document.getElementById("ipinDownloadNode");
  const btn = document.getElementById("ipinDownloadBtn");
  const defaultText = "欢迎访问本站，这是默认内容。";
const contentMap = { TW: "台湾地区用户内容", US: "美国地区用户内容", JP: "日本地区用户内容" };
try {
  // 浏览器调用 /info：识别访客 IP。
  const info = await fetch("https://my.ipin.io/info").then(res => res.json());
  el.textContent = contentMap[info.country] || defaultText;
} catch (e) {
  // 接口异常时保留默认内容。
  el.textContent = defaultText;
}
  const nodeMap = { TW: "/download/tw/app.zip", US: "/download/us/app.zip", JP: "/download/jp/app.zip" };
  try {
    const info = await fetch("https://my.ipin.io/info").then(res => res.json());
    btn.href = nodeMap[info.country] || "/download/default/app.zip";
    el.textContent = info.country || "Default";
  } catch (e) { btn.href = "/download/default/app.zip"; }
})();
</script>

routes/web.php

use App\Http\Controllers\IpController;

Route::get('/server-ip', [IpController::class, 'server']);
Route::get('/download', [IpController::class, 'download']);

SEO 与体验建议

默认内容应完整可读，地区化内容作为增强体验出现。这样搜索引擎可以抓取稳定内容，接口失败时用户也能继续使用页面。

常见错误

以下问题会影响文章准确性、代码可运行性和接口介绍可信度。

• 不要混淆服务器 IP 检测和访客下载分流
• 下载按钮必须保留默认链接
• 不要让下载功能完全依赖接口
• 服务器检测不要放在高流量页面
• 下载节点映射表应清晰维护

总结

Laravel 场景需要同时说明两种模式：服务端检测服务器 IP，浏览器端用于访客下载分流。二者分清后，文章和代码才准确。

常见问题

下面的问答围绕本文场景单独整理，问题和答案都与当前文章直接相关。