FluxDNS

文档状态：有效

适用范围：项目概览、使用入口与仓库导航

面向策略分流的 DNS 服务，采用 Rust 后端与 React WebUI，可将管理界面内嵌为单个发布二进制。

正式后端入口连接 UDP/TCP/DoH、Policy、真实上游 connector、Moka 与 FDCS 缓存快照、资源刷新、聚合统计和日分片解析详情。独立 Management 服务提供首次初始化、内存 Bearer/认证专用 Cookie 刷新、v2 配置事务、查询/实时事件及 12 路由内嵌 SPA。仅接受新版配置和数据布局，不迁移旧数据；Windows 联合验证及平台边界见 WebUI 验收。

能力与证据见当前实现，后续变更见活动计划。DoT/DoQ、主动上游健康检查和通用 YAML 编辑不属于当前已接线能力。

使用入

• 配置格式：配置参考 与 config-example.yaml。示例值不能直接作为受保护的生产配置。
• 构建、内嵌打包和显式配置启动：交付实现。
• 容器部署：compose 示例 与 env 模板；镜像由 container workflow 推送到 ghcr.io/deqiying/fluxdns。
• 前端开发：frontend/README.md。
• 工具来源和版本：环境规则；本地配置与运行数据：本地测试规则。

本地测试文件统一放在忽略的 _fluxdns/；凭据、真实账号/hash、数据库和日志不得提交。CLI 默认配置与开发脚本显式配置参数的区别见交付文档。

仓库布局

路径	职责
backend/	Rust binary crate；从根目录用 --manifest-path backend/Cargo.toml 调用
frontend/	独立 WebUI、OpenAPI、生成类型与契约 fixtures
docs/	plans、architecture、implementation、rules
script/	本地打包、版本与进程管理入口
.agents/skills/project-doc-maintenance/	文档维护技能与检查器
.github/workflows/release.yml	共享质量门禁、四平台并行构建、平台完成即上传及完整性校验后发布
.github/workflows/container.yml	独立镜像流水线：tag 推送即自行编译并推送 GHCR，不依赖发布流程
docker/	Dockerfile、部署示例与 env 模板、镜像冒烟夹具
VERSION	发布版本的唯一入口
deploy/、_fluxdns/	忽略的发布物与本地运行数据

设计取舍见架构入口，变更协作从 AGENTS.md 开始。项目名使用 FluxDNS，binary/服务标识使用 fluxdns。