Files
ipass/rust/src/http.rs
T
admin 5c307ba1aa iPass 山海关:Rust 动态模块版全量入库
- vanilla nginx + Rust 动态模块(取代 OpenResty+Lua),共享内存为运行期真源
- 三域名分流 18098 ssl:mdm 管理台 / lm LLM 代理 / *.dm 企业转发,共用 *.mayishangshu.cn 通配符证书(证书不入库)
- LLM 统一出口:同 Key 鉴权、上游 Key 替换、白名单、限流配额、SSE
- 回归夹具 tests/(网关 55 + LLM 34 = 89 断言,夹具 cp 覆盖重置)
- 文档:readme(16 章)+ CLAUDE.md + conf/tls/README(acme.sh 证书管理、hairpin 环回链路)
2026-09-11 15:37:09 +08:00

206 lines
6.9 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 请求/响应辅助:参数解析、请求体读取、JSON 响应输出。
//!
//! 这一层承担旧版 `util.params` / `util.respond` 的职责,但有一处本质差异:
//! **ngx crate 没有暴露请求体读取**,必须直接走
//! `ngx_http_read_client_request_body` 的两段式异步接口。
use std::collections::HashMap;
use std::ptr;
use ngx::core::{Buffer, Status};
use ngx::ffi::{ngx_chain_t, ngx_http_request_t};
use ngx::http::{HTTPStatus, Request};
use serde_json::{Value, json};
use crate::util;
// ===========================================================================
// 取请求信息
// ===========================================================================
pub fn uri(r: *mut ngx_http_request_t) -> String {
// SAFETY: r 由 nginx 保证有效;uri 是请求内存池中的字符串
unsafe { String::from_utf8_lossy((*r).uri.as_bytes()).into_owned() }
}
/// HTTP 方法名。直接读 nginx 已解析好的 `method_name`,
/// 避免依赖 Method 枚举的全部变体名(少一个就编译不过)。
pub fn method_str(r: *mut ngx_http_request_t) -> String {
// SAFETY: 同上
unsafe { String::from_utf8_lossy((*r).method_name.as_bytes()).into_owned() }
}
pub fn args_raw(r: *mut ngx_http_request_t) -> Vec<u8> {
// SAFETY: 同上
unsafe { (*r).args.as_bytes().to_vec() }
}
/// 请求头(大小写不敏感)
pub fn header(r: *mut ngx_http_request_t, name: &str) -> Option<String> {
// SAFETY: 迭代器只在本函数存续期内使用
let request = unsafe { Request::from_ngx_http_request(r) };
for (k, v) in request.headers_in_iterator() {
if k.as_bytes().eq_ignore_ascii_case(name.as_bytes()) {
return Some(String::from_utf8_lossy(v.as_bytes()).into_owned());
}
}
None
}
/// 客户端地址(登录限速的分组键)
pub fn remote_addr(r: *mut ngx_http_request_t) -> String {
// SAFETY: r 有效;connection 在请求生命周期内必然存在
unsafe {
let conn = (*r).connection;
if conn.is_null() {
return "-".to_owned();
}
String::from_utf8_lossy((*conn).addr_text.as_bytes()).into_owned()
}
}
// ===========================================================================
// 请求体
// ===========================================================================
/// 收集已读入的请求体。
///
/// **调用前提**:本函数只应在 `ngx_http_read_client_request_body` 的
/// post_handler 里调用(见 `api::read_body_then`)。
///
/// 请求体可能跨越多个 `ngx_buf_t`(chain)。被刷写到临时文件的大请求体
/// 这里直接忽略——管理台 API 的请求体都是几百字节的小 JSON,
/// 且管理 server 已把 `client_body_buffer_size` 调到 1m 覆盖边界。
pub unsafe fn collect_body(r: *mut ngx_http_request_t) -> Vec<u8> {
let mut out = Vec::new();
let rb = unsafe { (*r).request_body };
if rb.is_null() {
return out;
}
let mut chain = unsafe { (*rb).bufs };
while !chain.is_null() {
// SAFETY: chain 由 nginx 构建,节点与 buf 均有效
unsafe {
let buf = (*chain).buf;
if !buf.is_null() && (*buf).in_file() == 0 {
let (pos, last) = ((*buf).pos, (*buf).last);
if !pos.is_null() && !last.is_null() && last > pos {
let len = last.offset_from(pos) as usize;
out.extend_from_slice(std::slice::from_raw_parts(pos, len));
}
}
chain = (*chain).next;
}
}
out
}
/// 合并 query string 与请求体参数。
///
/// 优先级与旧版一致:**请求体覆盖 query**(同名时以 body 为准)。
pub fn params(r: *mut ngx_http_request_t) -> HashMap<String, String> {
let mut map = HashMap::new();
for (k, v) in util::parse_kv(&args_raw(r)) {
map.insert(k, v);
}
let body = unsafe { collect_body(r) };
if body.is_empty() {
return map;
}
let ctype = header(r, "content-type").unwrap_or_default();
if ctype.to_ascii_lowercase().contains("application/json") {
if let Ok(Value::Object(obj)) = serde_json::from_slice::<Value>(&body) {
for (k, v) in obj {
let s = match v {
Value::String(s) => s,
Value::Number(n) => n.to_string(),
Value::Bool(b) => b.to_string(),
_ => continue,
};
map.insert(k, s);
}
}
} else {
for (k, v) in util::parse_kv(&body) {
map.insert(k, v);
}
}
map
}
// ===========================================================================
// 响应
// ===========================================================================
/// 发送 JSON 响应体(含额外响应头,如 Set-Cookie)。
///
/// `body` 的字节会被复制进 nginx 的请求内存池,随请求自动回收。
pub fn send_with(
r: *mut ngx_http_request_t,
status: HTTPStatus,
body: &str,
extra_headers: &[(&str, &str)],
) -> Status {
// SAFETY: r 有效
unsafe {
let request = Request::from_ngx_http_request(r);
let pool = request.pool();
let mut buf = match pool.create_buffer_from_str(body) {
Some(b) => b,
None => return Status::NGX_ERROR,
};
buf.set_last_buf(true);
let mut chain = ngx_chain_t { buf: buf.as_ngx_buf_mut(), next: ptr::null_mut() };
request.set_status(status);
request.add_header_out("Content-Type", "application/json; charset=utf-8");
request.add_header_out("Cache-Control", "no-store");
for (name, value) in extra_headers {
request.add_header_out(name, value);
}
request.set_content_length_n(body.len());
let st = request.send_header();
if st != Status::NGX_OK {
return st;
}
request.output_filter(&mut chain)
}
}
pub fn send(r: *mut ngx_http_request_t, status: HTTPStatus, body: &str) -> Status {
send_with(r, status, body, &[])
}
/// 统一成功响应:`{code:200, msg, data}`
pub fn ok(r: *mut ngx_http_request_t, data: Value, msg: &str) -> Status {
let body = json!({ "code": 200, "msg": msg, "data": data }).to_string();
send(r, HTTPStatus::OK, &body)
}
pub fn ok_with(
r: *mut ngx_http_request_t,
data: Value,
msg: &str,
extra_headers: &[(&str, &str)],
) -> Status {
let body = json!({ "code": 200, "msg": msg, "data": data }).to_string();
send_with(r, HTTPStatus::OK, &body, extra_headers)
}
/// 统一失败响应:`{code:<status>, msg}`(与旧版 `util.fail` 一致)
pub fn fail(r: *mut ngx_http_request_t, status: HTTPStatus, msg: &str) -> Status {
// HTTPStatus 是 newtype(`pub struct HTTPStatus(pub ngx_uint_t)`),直接取内层值
let code = status.0 as u16;
let body = json!({ "code": code, "msg": msg }).to_string();
send(r, status, &body)
}