基于 .NET 10 + Vue 3 的 AirPage 墨水屏快照管理与定时推送系统。系统采集行情、服务器状态或自定义 HTTP JSON 数据，生成适合 528×792 四级灰度屏的 PNG 预览和固件兼容 2-bit BMP，并推送到 AirPage。

当前版本：v0.0.6。可在 Releases 下载 Windows、Linux、macOS 自包含版本，无需预装 .NET。

• Vue 管理端：登录、用户/角色、菜单与数据权限、模板、数据源、重试规则、定时任务、设备和推送历史。
• 最新行情面板：三大指数、上涨/下跌/平盘、涨跌停及异动股票。
• 服务端状态面板：系统信息、应用内存、磁盘、运行时间、网络流量和高内存进程。
• 3xui代理监控：按 v3.7.0 数据模型采集 3x-ui/Xray v26.7.28 状态、入站/出站流量、客户端配额、最近活跃、IP、连接数及高流量入站。
• 自定义面板：支持 HTTP JSON 数据绑定，以及金句、工牌、登机牌、自由 JSON 绘制和图片自动适配。
• 标准五段 Cron、独立时区、任务启停、测试执行和指数退避重试。
• 每个用户拥有独立设备、默认设备、数据源、任务、私有模板及推送记录；管理员可配置跨用户数据权限。
• AirPage 设备 ID 使用 ASP.NET Core Data Protection 加密存储；接口和日志不回显凭据。
• 严格四调色板、2-bit、bottom-up BMP 编码，并检查 512 KiB 限制。
• SQLite 持久化、Docker 部署和 GitHub Actions 构建。

docker compose up -d --build

也可直接使用多架构镜像：

docker run -d --name airpage-system -p 5088:8080 -v airpage-data:/app/data ghcr.io/sunkejava/airpagesystem:0.0.6

直接运行在 3x-ui 主机时，程序会自动查找 /etc/x-ui/x-ui.db 等常见路径。也可以通过配置指定：

"ThreeXUi": {
  "DatabasePath": "/etc/x-ui/x-ui.db",
  "PanelVersion": "",
  "XrayVersion": ""
}

Docker 部署需要把宿主机数据库以只读方式挂载进容器：

volumes:
  - ./data:/app/data
  - /etc/x-ui/x-ui.db:/host/3x-ui/x-ui.db:ro
environment:
  ThreeXUi__DatabasePath: /host/3x-ui/x-ui.db

数据库仅以 SQLite 只读模式打开。面板不会读取或显示 UUID、密码、订阅 ID；容器只能看到容器内进程，因此 Docker 部署时 3x-ui/Xray 进程状态可能显示“停止”，流量及入站数据不受影响。原生部署可以同时获得进程状态和数据库数据。

浏览器访问 http://localhost:5088：

1. 首次启动使用 admin 登录，一次性随机密码会显示在本机启动日志；也可通过 BootstrapAdmin__Password 环境变量预设。
2. 在“设备”页粘贴 AirPage 设备链接并设为默认设备。
3. 在“面板模板”中预览“最新行情面板”或“服务端状态面板”。
4. 确认排版后选择设备立即推送，或在“定时推送”中创建任务。

运行数据保存在根目录 data/，不会提交到 Git。

需要 .NET 10 SDK、Node.js 24+ 和中文字体。

cd src/airpage-web
npm install
npm run build
cd ../AirPageSystem.Api
dotnet run --urls http://localhost:5088

前端热更新：

cd src/airpage-web
npm run dev

默认时区为 Asia/Shanghai。首版调度器按 Cron 执行；行情模板若需严格排除法定休市日，可继续增加交易日历策略。

先添加 HTTP JSON 数据源，再创建 custom 模板：

{
  "titlePath": "$.title",
  "metrics": [
    { "label": "状态", "path": "$.status" },
    { "label": "在线数", "path": "$.online" }
  ],
  "itemsPath": "$.items",
  "columns": [
    { "label": "名称", "path": "$.name" },
    { "label": "数值", "path": "$.value" }
  ]
}

当前支持对象属性路径，例如 $.data.status。首版刻意不支持脚本表达式与远程代码执行。

• 只接受受信任 AirPage 域名的 HTTPS 设备地址。
• 设备 ID 加密后存入 SQLite；请持久化 data/ 中的数据库和 Data Protection 密钥。
• 自定义数据源默认禁止访问环回及 RFC1918 私网地址以减少 SSRF 风险。局域网监控需显式设置 DataSources__AllowPrivateNetworks=true。
• 登录、RBAC 和数据隔离已内置；公网部署仍应配置反向代理 TLS，并通过环境变量或 Secret Manager 管理初始密码。
• 不要提交真实设备 URL、API 令牌、数据库或 appsettings.Production.json。

src/
├─ AirPageSystem.Api/  .NET 10 API、调度、渲染和推送
└─ airpage-web/        Vue 3 + Vite 管理端

• GET/POST /api/devices
• GET/POST/PUT /api/templates
• GET/POST /api/data-sources
• POST /api/data-sources/{id}/test
• GET/POST /api/schedules
• POST /api/panels/execute
• GET /api/dashboard
• GET /api/history

• 公开行情源仍受上游可用性影响；可通过重试规则降低瞬时失败率。
• 3x-ui 数据库只读模式无法取得 Xray API 的精确实时在线集合，因此面板明确显示“近3分钟活跃”，不冒充实时在线数。
• 升级程序会自动补齐 v0.0.4 数据库结构；部署前仍建议备份 data 目录。