HTTPAPI | URL 预留

HTTP.SYS URL 预留是 Windows 操作系统中的一项功能，允许用户为其应用程序或服务预留特定的统一资源定位符（URL）。使用 HTTP.SYS 预留 URL 后，操作系统将拦截该 URL 的所有传入 HTTP 请求，并将其路由到指定的应用程序或服务。

 

要使用 HTTP.SYS 保留 URL，应用程序或服务必须首先通过调用 HTTP API 向 HTTP.SYS 驱动程序注册该 URL。应用程序或服务需指定 URL、HTTP 方法（如 GET、POST）及认证要求等附加设置。

 

URL 注册后，HTTP.SYS 将拦截该 URL 的所有传入 HTTP 请求，并根据 URL 和方法查找已注册的应用程序或服务。如果找到匹配的应用程序或服务，HTTP.SYS 驱动程序将把请求传递给该应用程序或服务进行处理。

 

NETSH 命令

注册 URL

在此示例中，正在为用户 DOMAIN\user 注册 URL http://example.com:80/。您可以将其替换为所需的 URL 和用户。

 

netsh http add urlacl url=http://example.com:80/ user=DOMAIN\user

 

删除 URL

在此示例中，URL http://example.com:80/ 正在被删除。您可以将其替换为要删除的 URL。

 

netsh http delete urlacl url=http://example.com:80/

 

显示所有 URL

此命令将显示系统上所有已注册 URL 保留项的列表。

 

netsh http show urlacl

 

TsgcWebSocketServer_HTTPAPI

HTTP.SYS 服务器在启动时自动注册 URL，使用以下参数和方法完成注册。

 

• Host 和 Port：若 Host 不为空且 Port 不为零，服务器将尝试注册该 URL。示例：URL https://127.0.0.1:5000 将使用以下属性注册
  • Host = '127.0.0.1';
  • Port = 5000
  • SSL = True
• NewBinding: 使用此方法注册一个或多个 URL。
  • 注册 URL https://127.0.0.1:5000 --> NewBinding('127.0.0.1', 5000, '/', True)
  • 注册 URL http://+:5000/ws/ --> NewBinding('+', 5000, '/ws/')

 

URL 注册在以下情况需要管理员权限：

• 端口号低于 1024
• 主机是通配符 "+"，而非 IP 地址。

 

 

如果您想为服务器的所有 IP 地址注册 443 端口，只监听端点 "/ws/"，但不希望以管理员权限运行服务器，请执行以下步骤：

 

• 使用 netsh 注册 URL
  • netsh http add urlacl url=https://+:443/ws/ user=DOMAIN\user
• 使用以下绑定配置服务器
  • NewBinding('+', 443, '/ws/', True);
• 禁用 ConfigureSSLCertificate 属性
  • TsgcWebSocketServer_HTTPAPI.BindingOptions.ConfigureSSLCertificate = false;
• 配置 SSL 证书
  • HTTPAPI 服务器 SSL