---
title: 核心架构与技术选型
type: decision
permalink: main/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/核心架构与技术选型
stable_id: 7687d956-f904-4629-bd5d-4f5b55ec2b84
scope: project
memory_type: decision
project_id: 6f47523e-e22e-4cdd-bd18-76e5e474ee0c
usage_profile_id: 7aee455b-24cc-4008-bdaf-443721e6f939
status: active
revision: 1
request_id: migrate-decision-01
created_at: '2026-08-12T17:20:43.326366+00:00'
updated_at: '2026-08-12T17:20:43.326366+00:00'
tags:
- architecture
- decisions
---

1. **构建源码**：选择 Qosmio openwrt-ipq 25.12-nss，而非官方 OpenWrt，因为它提供 AX9000 IPQ807x 设备支持和 NSS 数据平面加速。
2. **Docker 构建隔离**：Docker 容器中编译，避免污染主机环境；命名卷 openwrt-build-work 保留增量构建缓存（>50GB）。
3. **FastAPI + Vue 3**：分离前后端，后端负责构建任务编排、配置校验和产物服务，前端提供可视化操作界面。
4. **大分区布局**：将 Qosmio 双 UBI 布局改为单 rootfs 232 MiB，最大化可用空间，配合暗云 U-Boot。
5. **设备侧硬件控制**：自研 luci-app-ax900-hardware，通过 Linux hwmon 和 LED 子系统提供温控/风扇/RGB 控制，而非使用第三方工具。
6. **单设备专注**：后端有 profile 抽象，但 ZIP 名、分区修补和默认文本仍固定 AX9000，扩展第二设备需进一步拆分。