Files

T

freedak f7a720204a Update: 将子项目从 submodule 转为完整内容

- 移除 GovAI, nomifun-tauri, 算力盒子 的 submodule 引用
- 添加所有子项目的完整源代码
- 保留原始 .git 为 .git.bak 备份

2026-07-04 19:20:46 +08:00

4.9 KiB

Raw Permalink Blame History

构建与打包

本页说明当前 NomiFun monorepo 能产出的发布物：React SPA、nomifun-web、 Tauri 桌面包、updater 产物、Docker 镜像和 Linux systemd 部署文件。

日常开发循环见 development.zh.md。部署运行见 ../guides/web-server-deployment.zh.md。

当前状态

产物	当前状态
SPA (`ui/dist`)	`bun run build:ui` 构建；桌面和 Web host 都使用它。
`nomifun-web`	支持的自托管 binary；默认开启鉴权。
Tauri 桌面包	`bun run build` 为当前 OS 构建。
macOS Developer ID 签名 + 公证	已有 `bun run build:signed` 包装脚本；需要本机 Apple 签名配置。
Tauri updater 产物	`bun run build:updater` 会生成 updater `.sig`；生产 endpoint/key 管理仍需发布配置。
Docker / Compose	支持本地构建与 compose 运行；本文不承诺公开 registry 镜像。
Native Linux + systemd	`packaging/linux/` 提供 unit 和说明。
Windows 签名	需要外部代码签名证书；仓库内未配置。

SPA

bun run build:ui

输出目录是 ui/dist/。

桌面构建通过 apps/desktop/tauri.conf.json 的 frontendDist 打包该目录。 nomifun-web 通过 --dist / NOMIFUN_WEB_DIST 服务它；从仓库内运行时，默认路径相对 apps/web 指向 ../../ui/dist。

Web Binary

bun run build:ui
cargo build --release -p nomifun-web

运行要求：

已构建的 SPA 目录；
可写数据目录；
PATH 上有 Bun，除非构建时使用 NOMIFUN_EMBED_BUN=1；
默认鉴权/admin 初始化流程，或仅在可信本地开发中显式使用 --insecure-no-auth。

示例：

target/release/nomifun-web --host 127.0.0.1 --port 8787 --dist ui/dist

未预置 NOMIFUN_ADMIN_USERNAME / NOMIFUN_ADMIN_PASSWORD 时，首次浏览器访问会创建管理员。

桌面包

bun run build

该命令调用 Tauri build，先构建 SPA，再在 target/release/bundle/ 下生成当前 OS 的安装包/应用包。

产品身份来自 apps/desktop/tauri.conf.json：

productName: "NomiFun"
identifier: "com.nomifun.desktop"
版本来自 workspace package metadata
dev URL http://localhost:5173
bundled frontend ../../ui/dist

桌面包应在目标 OS 上构建。跨 OS 桌面打包不是当前支持流程。

macOS 签名与公证

ad-hoc 签名产物只适合本地测试，不适合发给别人。生成 Developer ID 签名并公证的 DMG：

cp apps/desktop/signing/.env.signing.example apps/desktop/signing/.env.signing
# 填写本机 Apple 签名/公证信息
bun run build:signed

真实 .env.signing 与 Apple 私钥不会入库。包装脚本在 scripts/desktop-build-signed.sh，详细配置见 apps/desktop/signing/README.md。

Updater 产物

bun run build:updater

该命令启用 Tauri createUpdaterArtifacts，在安装包旁生成 .sig。这些签名只给 Tauri updater 使用，不等于 OS 信任：macOS 仍需要 Developer ID 签名/公证； Windows 仍需要代码签名证书。

生产发布仍需补齐：

生产 updater 密钥管理；
托管 latest.json endpoint；
发布 channel 策略；
renderer 中下载、应用、重启的完整流程。

见 apps/desktop/updater/README.md。

Docker

docker compose up -d --build

根 Dockerfile 用 Bun 构建 SPA，用 Cargo 构建 release nomifun-web，再把 binary 和 ui/dist 复制到 slim runtime image。Compose 启动一个 nomifun 服务，端口 8787，/data 作为 NOMIFUN_DATA_DIR。

启动后访问 http://<server>:8787。如果没有预置管理员，第一个能访问到的浏览器会看到首次管理员设置页。

docker-compose.yml 中的 Caddy 服务默认注释。需要 TLS 时可启用它或使用其他反向代理；浏览器通过 HTTPS 访问时设置 NOMIFUN_HTTPS=true。

Native Linux + systemd

见 packaging/linux/README.md。基本形态：

bun install
bun run build:ui
cargo build --release -p nomifun-web
sudo cp target/release/nomifun-web /opt/nomifun/
sudo cp -r ui/dist/. /opt/nomifun/web/
sudo cp packaging/linux/nomifun-web.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now nomifun-web

systemd 环境中，如果 agent 子进程需要 shell，请显式设置 SHELL；nologin 服务用户通常没有可用 shell。

分发前检查

cargo check --workspace
bun run build:ui
桌面包在目标 OS 上构建并 smoke test 启动。
macOS 分发前验证 codesign、spctl、xcrun stapler。
Web/Docker 验证首次管理员设置、登录、/health 和目标反向代理下的 WebSocket。

4.9 KiB Raw Permalink Blame History Unescape Escape