gojs.net.http.Request

请求对象，通常无需初始化，可以直接在请求相关的边缘脚本中调用。

方法和属性

  1. // 请求ID
  2. req.id
  4. // 服务信息，包括id等属性
  5. req.server
  7. // 节点信息，包括id等属性
  8. req.node
  10. // 请求ID，同 req.id
  11. req.requestId
  13. // 请求完整URL
  14. req.url
  16. // 请求完整URL，同 req.url
  17. req.requestURL
  19. // 请求路径，不带参数
  20. req.path
  22. // 请求路径，不带参数，同 req.path
  23. req.requestPath
  25. // 请求URI，带参数，可以在发送请求之前修改
  26. req.uri
  28. // 请求URI，带参数，可以在发送请求之前修改，同  req.uri
  29. req.requestURI
  31. // 请求主机名，带端口 
  32. req.host
  34. // 请求客户端地址，可以通过X-Real-IP等HTTP Header获取
  35. req.remoteAddr
  37. // 请求客户端地址，直接连接节点的地址，有可能是别的代理服务
  38. req.rawRemoteAddr
  40. // 请求客户端端口号
  41. req.remotePort
  43. // 请求方法
  44. req.method
  46. // 请求发送的内容长度
  47. req.contentLength
  49. // 请求的内容编码
  50. req.transferEncoding
  52. // 请求的协议，比如HTTP/1.0
  53. req.proto
  55. // 请求的协议的主版本，比如1.0版本的主版本就是1
  56. req.protoMajor
  58. // 请求的协议的小版本，比如1.0版本的小版本为0
  59. req.protoMinor
  61. // 请求Cookie值
  62. req.cookie(name)
  64. // 请求的Header，结构为：{ name1: [value1, value2], name2: [value3], ... } 
  65. req.header
  67. // 设置请求Header
  68. // 值可以是一个字符串，也可以是一组字符串
  69. req.setHeader(name, value)
  70. req.setHeader(name, values)
  72. // 删除某个请求Header
  73. req.deleteHeader(name)
  75. // 设置请求相关属性
  76. req.setAttr(name, value)
  78. // 设置请求相关变量值
  79. req.setVar(name, value)
  81. // 格式化一组变量值，具体支持的变量，请参考备注1
  82. // 比如 req.format("${requestId}: ${requestPath}")
  83. req.format(varString)
  85. // 设置当前请求脚本执行完毕，不再执行后续的其他脚本
  86. req.done()
  88. // 允许请求，标记当前请求不启用WAF检查
  89. // 需要在请求初始化时调用
  90. req.allow()
  92. // 关闭当前请求所在连接
  93. // 这种情况下，不仅不会执行当前请求，同连接的其他请求也会一并拒绝执行
  94. req.close()

备注：

示例

根据请求路径来判断是否跳过WAF检查

  1. // 其中 /news 换成你自己要检查的路径
  2. if (req.path == "/news") {
  3.     req.allow()    
  4. }

根据请求路径来决定是否阻止访问

  1. // 这里我们阻止以 /. 开头的路径，比如 /.svn 之类的都将被阻止
  2. if (req.path.startsWith("/.")) {
  3.     // 断开当前连接，是对恶意请求比较常见的处理方式
  4.     req.close()
  5. }

打印用户所在国家或地区

  1. if (req.path == "/country") {
  2.     resp.send(200, "You are from " + req.format("${geo.country.name}"))
  3.     return
  4. }

其中 ${geo.country.name} 是请求中可以使用的变量，更多支持的变量可以看这里。

这样当用户访问 /country 时就可以打印出国家名，类似于：

  1. You are from 中国