快速上手

安装

NomiFun 是完全开源、本地优先的「超级 AI 工作站」：一套 Rust 后端 + React 19 前端，配两种宿主形态——桌面应用 nomifun-desktop（Tauri 2，环回端口启动、每次启动注入本地信任 token，桌面窗口免登录）与自托管 Web 服务 nomifun-web（axum，默认 127.0.0.1:8787，默认需登录）。两者共享同一个后端，因此在任一宿主里配置的 provider、伙伴、知识库在另一宿主里同样可见。

本页带你从零把 NomiFun 装到本机或服务器上。

下载入口：NomiFun 应用下载地址为 GitHub Releases。进入后选择对应版本和平台资产；如果当前版本暂未包含你的平台产物，也可以按下方步骤从源码构建（桌面 Tauri / Web axum）或用 Docker 自托管。

想了解平台支持与系统要求，可参考下载页。

前置条件

无论走哪条路径，都需要一套可用的构建工具链：

  1. Rust（stable，edition 2024）——编译后端；桌面端还需编译 Tauri 外壳。用 rustup 安装。
  2. Bun ≥ 1.3.13——前端包管理与构建，同时也是 agent 引擎的硬运行时依赖。1.1.38 存在 stdin 缺陷，请勿使用。
  3. Tauri CLI v2——仅桌面端需要，作为 devDependency 引入，无需全局安装。
  4. Git——克隆仓库；技能发现与若干内置工具也会用到。
  5. C/C++ 构建工具——Windows 用 MSVC + WebView2 运行时；macOS 用 Xcode Command Line Tools；Linux 用 build-essential cmake clang pkg-config perl。

在实际运行 NomiFun 的机器上，还推荐装好 ripgrep（代码搜索后端，缺失时回退 grep）与 node / npm / npx（许多 MCP stdio 服务通过 npx -y … 启动）。构建机本身不需要这两项。

克隆仓库后，先安装一次 JS 依赖（后续 package.json 变动时重跑）：

git clone https://github.com/nomifun/nomifun-tauri.git
cd nomifun
bun install

下文命令均假设工作目录为仓库根目录。

操作步骤

按你的使用场景三选一。单机自用选 A；要从手机 / 局域网 / 服务器访问，选 B 或 C。

A. 从源码构建桌面应用

桌面应用是一个 Tauri 2 外壳，在进程内链接后端，并在一个空闲的 127.0.0.1 端口上以本地信任策略启动它。WebView 会拿到每次启动生成的本地信任 token，因此桌面窗口没有登录界面。

  1. 开发模式直接运行：bun run dev。Vite 开发服务器起在 http://localhost:5173，cargo 编译 nomifun-desktop，外壳挑选空闲端口派生嵌入式后端并加载界面。渲染端支持热重载。
  2. 出 Release 二进制：先 bun run build:ui 把 SPA 构建到 ui/dist，再 bun run build 产出独立可执行文件与平台安装包（落在 target/release/bundle/：Windows 的 .msi/.exe、macOS 的 .app/.dmg、Linux 的 .deb/.AppImage）。
  3. 分发签名构建（可选）：macOS 用 bun run build:signed（需配置签名密钥），Windows 签名仍需外部代码签名证书。

装好后启动桌面应用，进入「设置 → 关于」即可看到当前版本号，确认安装成功：

安装完成后的“关于”页 · 可见版本号

B. 从源码构建 Web 服务

nomifun-web 是一个 axum 服务，在同一进程内挂载同一个后端，并在同一端口（默认 8787）上同时提供已构建的 SPA。适合在局域网、VPN 或 VPS 上自托管。它默认要求登录。

  1. 安装依赖并构建 SPA：bun install 后执行 bun run build:ui（非开发模式提供服务前必须先构建）。
  2. 启动服务：bun run serve:web（等价于 cargo run -p nomifun-web），默认绑定 127.0.0.1:8787，使用与桌面应用相同的按用户数据目录。
  3. 浏览器打开 http://127.0.0.1:8787。首次访问会被引导到设置页——你输入的用户名与密码将成为初始管理员账户，此后所有人都需要登录。

要开放到局域网并预置管理员（跳过交互式首次设置），用 --host 0.0.0.0 配合 --admin-user / --admin-password，并显式指定 --data-dir 与 --dist 绝对路径：

nomifun-web \
  --host 0.0.0.0 --port 8787 \
  --data-dir /var/lib/nomifun \
  --dist /opt/nomifun/web \
  --admin-user admin \
  --admin-password "换成一个足够强的密码"

C. Docker / Docker Compose

仓库附带多阶段 Dockerfile 与 docker-compose.yml，构建出一个无 GUI镜像（debian:bookworm-slim 上的 SPA + nomifun-web + bun）。

  1. 在仓库根目录执行 docker compose up -d --build。
  2. 访问 http://<server-ip>:8787。服务配置了 restart: unless-stopped，安装即等同于开机自启；持久化状态存放在挂载到容器 /data 的命名卷 nomifun-data，请像其他数据库一样定期备份。
  3. 公网部署务必先在 docker-compose.yml 中预置管理员（NOMIFUN_ADMIN_USERNAME / NOMIFUN_ADMIN_PASSWORD），并在前面加一层 TLS——仓库附带 Caddyfile 与被注释掉的 caddy 服务即推荐做法，启用后记得设置 NOMIFUN_HTTPS=true 让会话 cookie 获得 Secure 标记。

要点与注意

  • 桌面端是单用户工具。 启动它的操作系统账户拥有 agent 的全部能力（含 shell 与文件访问）。桌面窗口免登录靠的是本地信任 token，而非「无鉴权」——只知道端口的其他进程不会被自动信任。
  • 不要直接暴露桌面端口做远程访问。 想从另一台设备访问，请用应用内的 WebUI 局域网远控（一次性扫码、token 5 分钟 TTL），或独立部署 Web 服务。
  • 首次运行窗口期。 Web 服务在你完成设置前，任何能到达端口的人都可能认领管理员。非环回绑定时服务会打印醒目警告；用 NOMIFUN_ADMIN_PASSWORD 预置即可关闭这个竞态窗口。
  • --insecure-no-auth 默认是敌对选项。 它完全禁用鉴权，仅限 loopback 或完全可信的私有网络。远程裸跑后端，本质上等同于给该主机开通远程代码执行——鉴权 + TLS 是底线。
  • 同一数据目录只允许一个后端实例。 后端启动时会取排他的 server.lock；在同时装有桌面应用的机器上裸跑 nomifun-web，会因为指向同一目录而快速失败。要并行多实例，请为每个实例指定独立的 --data-dir。

验证安装

无论走哪条路径，都可以做一次快速检验：

# Rust 工作区编译干净
cargo check --workspace

# Web 主机响应 SPA + 鉴权状态
curl -sS http://127.0.0.1:8787/api/auth/status
# → 200 {"success":true,"needs_setup":..., "user_count":...}

若日志中出现 nomifun-web: embedded backend + SPA on one port，且 /api/auth/status 返回 JSON，说明后端已启动、SPA 在同一端口提供服务。桌面端则以「设置 → 关于」页显示的版本号为准。

常见问题

窗口打开后是空白白屏。 确认已安装 WebView 运行时——Windows 10 需要 WebView2 Evergreen Bootstrapper，Linux 需要 libwebkit2gtk-4.1-0。

agent 命令报 bun: command not found。 agent 引擎会派生 Bun 执行工具。请确保 bun 在系统 PATH 上（curl -fsSL https://bun.sh/install | bash），或用 NOMIFUN_EMBED_BUN=1 构建以把 Bun 嵌入二进制。

Failed to bind backend port。 另一个进程占用了临时端口；退出其他 NomiFun 实例后重试。

相关

  • 简介 —— NomiFun 是什么、两种宿主的取舍。
  • 快速上手 —— 装好后的第一段会话。
  • WebUI 局域网远控 —— 把现有桌面安装变成可扫码远程访问的实例。

完整文档 → GitHub