"在 Deno 中获取远程客户端 IP 地址"

Question

如何在 Deno 中获取客户端的IP 地址<\/em>？

我已经使用标准http<\/code>库创建了一个测试服务器，但我无法找到提取客户端 IP 的方法。 我需要它作为防止多次提交的安全功能。

在 NodeJS\/Express 中， request<\/code>对象的ip<\/code>属性也有同样的作用。 req.ip<\/code>在 Express 中给出了我想要的东西，但在 Deno 中它是什么等价物？

我的代码是：

是否有任何其他解决方法可以防止来自同一设备的多次访问？
谢谢<\/strong>

Answer 1

由于serve的类型化方式，以类型安全的方式执行此操作有点复杂。 首先，我将向您展示如何执行此操作的示例，然后我将解释这些类型。

例子

example.ts ：

import {
  serve,
  type ConnInfo,
  type Handler,
  type ServeInit,
} from 'https://deno.land/std@0.125.0/http/server.ts';

function assertIsNetAddr (addr: Deno.Addr): asserts addr is Deno.NetAddr {
  if (!['tcp', 'udp'].includes(addr.transport)) {
    throw new Error('Not a network address');
  }
}

function getRemoteAddress (connInfo: ConnInfo): Deno.NetAddr {
  assertIsNetAddr(connInfo.remoteAddr);
  return connInfo.remoteAddr;
}

const handler: Handler = (request, connInfo) => {
  const {hostname, port} = getRemoteAddress(connInfo);
  const message = `You connected from the following address: ${hostname}`;
  return new Response(message);
};

const init: ServeInit = {port: 8080};

serve(handler, init);
console.log(`Listening on port ${init.port}...\nUse ctrl+c to stop`);

---

类型

查看serve函数的文档，您可以看到它接受两个参数：一个Handler类型的回调和一些ServeInit类型的选项：

async function serve(handler: Handler, options?: ServeInit): Promise<void>;

Handler回调接受两个参数：一个Request和一个ConnInfo类型的对象：

type Handler = (request: Request, connInfo: ConnInfo) => Response | Promise<Response>;

ConnInfo看起来像这样：

interface ConnInfo {
  readonly localAddr: Deno.Addr;
  readonly remoteAddr: Deno.Addr;
}

应该具有远程 IP 地址的部分（从技术上讲，它是远程主机名，但它很可能是一个 IP 地址，除非您在服务器环境中配置了自定义 DNS 设置）是connInfo.remoteAddr的对象，它（您可以见上文）是Deno.Addr类型，如下所示：

// in the Deno namespace

type Addr = NetAddr | UnixAddr;

这就是它变得复杂的地方。 Deno.Addr是Deno.NetAddr和Deno.UnixAddr的可区分联合（这意味着它可以是任何一个），并且使用属性transport来区分两者。

// in the Deno namespace

interface NetAddr {
  hostname: string;
  port: number;
  transport: "tcp" | "udp";
}

interface UnixAddr {
  path: string;
  transport: "unix" | "unixpacket";
}

网络地址具有hostname属性（其值将是 IP 地址）和port属性，而 unix 地址具有path属性。

为支持服务器而在内部创建的侦听器实际上仅在 TCP 上侦听，因此我认为可以安全地假设远程地址将是网络地址。 但是，因为serve函数中Handler回调参数的类型签名并没有明确说明（尽管它应该！），TypeScript 不知道这一点。

因此，作为程序员，您需要确保地址实际上是网络地址，然后才能以类型安全的方式访问网络地址（而不是 unix 地址）上的属性。 这就是类型断言函数assertIsNetAddr发挥作用的地方。 （类型断言执行运行时测试，从而为编译器提供条件“保证”：如果条件不能得到保证，则抛出异常。）因为作为程序员，您已经比 TypeScript 编译器了解更多（即该地址在 TCP 上并且将是一个网络地址），您可以断言该地址确实是一个网络地址。 然后编译器将允许您使用该地址作为网络地址。

如果您想在地址不是网络地址的情况下除了抛出错误之外做一些事情：代替断言函数，您可以使用类型谓词作为代码中的条件。

这是 TypeScript Playground 的链接，我在其中使用示例中使用的类型创建了一个 Playground，因此您可以探索/实验。

---

最后，（这不是类型安全的）如果您只想在没有检查的情况下使用该值（因为您已经完成研究并且确信您永远不会处理非 TCP 连接，您可以简单地使用类型断言：

const handler: Handler = (request, connInfo) => {
  const {hostname, port} = connInfo.remoteAddr as Deno.NetAddr;
  const message = `You connected from the following address: ${hostname}`;
  return new Response(message);
};