cc06fc073f
- 新增 proxy.h / proxy.c：路径前缀匹配 → HTTP/1.1 后端转发 - proxy_init/add_rule/match/forward API - X-Forwarded-For / X-Forwarded-Proto 透传 - 目前仅支持 HTTP 后端，HTTPS 后端拒绝并警告 - cocoon.h：新增 COCOON_MAX_PROXY_RULES=8，cocoon_config_t 添加 proxies 数组 - config.c：JSON 解析器新增 proxies 数组解析（prefix + target） - server.c： - connection_t 新增 ctx 指针，用于 handle_request 访问代理配置 - handle_request 中在静态文件服务前检查代理规则 - Makefile：proxy.c 加入 SRCS 和 test_server 编译规则 - cocoon.json：示例配置添加 proxies 数组 - tests/integration_test.sh：新增 3 项反向代理集成测试 - .cocoon-plan.md：标记反向代理为已完成 编译零警告，142 个单元测试 + 80 项集成测试全部通过。
72 lines
1.8 KiB
C
72 lines
1.8 KiB
C
/**
|
||
* proxy.h - 反向代理模块
|
||
*
|
||
* 轻量级反向代理，支持路径前缀匹配到目标后端。
|
||
*
|
||
* @author xfy
|
||
*/
|
||
|
||
#ifndef COCOON_PROXY_H
|
||
#define COCOON_PROXY_H
|
||
|
||
#include "cocoon.h"
|
||
#include "http.h"
|
||
#include "platform.h"
|
||
#include <stdbool.h>
|
||
|
||
#define COCOON_MAX_PROXY_RULES 8
|
||
|
||
typedef struct {
|
||
char path_prefix[256];
|
||
char target_host[256];
|
||
char target_path[256];
|
||
uint16_t target_port;
|
||
bool target_https;
|
||
} cocoon_proxy_rule_t;
|
||
|
||
typedef struct {
|
||
cocoon_proxy_rule_t rules[COCOON_MAX_PROXY_RULES];
|
||
size_t count;
|
||
} cocoon_proxy_config_t;
|
||
|
||
/**
|
||
* proxy_init - 初始化代理配置
|
||
*/
|
||
void proxy_init(cocoon_proxy_config_t *cfg);
|
||
|
||
/**
|
||
* proxy_add_rule - 添加代理规则
|
||
*
|
||
* @param cfg 代理配置
|
||
* @param prefix 路径前缀（如 "/api/"）
|
||
* @param target_url 目标URL（如 "http://localhost:3000"）
|
||
* @return true 成功
|
||
*/
|
||
bool proxy_add_rule(cocoon_proxy_config_t *cfg, const char *prefix, const char *target_url);
|
||
|
||
/**
|
||
* proxy_match - 查找匹配路径的代理规则
|
||
*
|
||
* @param cfg 代理配置
|
||
* @param path 请求路径
|
||
* @return 匹配的规则，未匹配返回 NULL
|
||
*/
|
||
const cocoon_proxy_rule_t *proxy_match(const cocoon_proxy_config_t *cfg, const char *path);
|
||
|
||
/**
|
||
* proxy_forward - 将请求转发到目标后端
|
||
*
|
||
* 建立到后端的连接，转发请求，将响应回写给客户端。
|
||
*
|
||
* @param client_fd 客户端 socket
|
||
* @param req HTTP 请求
|
||
* @param rule 代理规则
|
||
* @param client_addr 客户端地址（用于 X-Forwarded-For）
|
||
* @return true 保持连接，false 关闭
|
||
*/
|
||
bool proxy_forward(cocoon_socket_t client_fd, const http_request_t *req,
|
||
const cocoon_proxy_rule_t *rule,
|
||
const struct sockaddr_storage *client_addr);
|
||
|
||
#endif /* COCOON_PROXY_H */
|