/** * proxy.h - 反向代理模块 * * 轻量级反向代理,支持路径前缀匹配到目标后端。 * * @author xfy */ #ifndef COCOON_PROXY_H #define COCOON_PROXY_H #include "cocoon.h" #include "http.h" #include "platform.h" #include #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 */