SuperAPI AI 工具集

lazycat-advanced-routing

部署与运维

查看项目

更新于 10-15 23:44

技能介绍

用途:处理懒猫微服(LPK V2)打包、构建与路由配置中的 HTTP/HTTPS 路由、域名前缀、Host/TLS、复杂反向代理及 TCP/UDP 四层转发问题。

先校准规范:任何打包或路由任务先读 references/spec-sync.md,核对当前官方原文,并确认目标 lzcos 与 lzc-cli 版本;文档快照与官方冲突时以官方为准。LPK V2 须拆分配置:package.yml 存 package、version、name、description、权限等静态信息;lzc-manifest.yml 存 application、services 等运行结构。不要写旧元数据,也不要添加不存在的 application.secondary_domains。

按需求选机制:简单 HTTP/HTTPS、静态文件或启动本地程序用 application.routes(URL_PATH=UPSTREAM,默认移除匹配前缀);保留路径、按域名前缀分流、控制 Host/Header/TLS 校验用 application.upstreams(backend 仅支持 http、https、file);TCP/UDP、数据库等非 HTTP 协议用 application.ingress(L4 直通,不经平台 HTTP 鉴权);内置能力无法表达的复杂重写用应用内反向代理,优先用已核验镜像。routes 支持 http(s)://、file:///、exec://端口,程序路径;upstreams[].backend 不支持 exec://,需启动程序时用 backend_launch_command;ingress 只声明 tcp 或 udp。

域名规则:实际分配域名只能从 LAZYCAT_APP_DOMAIN 获取,不要按 application.subdomain 硬拼;应用内通常用 http://<service>:<port>;代表用户访问另一应用 HTTP 入口用 app.<target-package-id>.lzcx。前缀域名流量忽略 application.ingress。

风险边界:use_backend_host 控制 HTTP Host,非 TLS SNI 开关;HTTPS backend 应写匹配证书的主机名;disable_backend_ssl_verify 仅明确风险后使用;L4 无平台鉴权,应用须自行实现协议鉴权;接管 80/443 会绕过鉴权等能力,须设置 yes_i_want_80_443: true,绝大多数应用不应这样做。按需读取 references/route.md、advanced-routes.md、secondary-domains.md、l4forward.md。