跳转到主要内容

​
安装器内部机制

当前这套文档只记录仓库里真实存在的安装器： 从零开始的真实路径是： 
git clone https://github.com/fased-ai/fased.git fased
cd fased
./install.sh
Windows 请先安装 WSL2， 然后在 Ubuntu 中运行同样的仓库命令。

​
install.sh 会做什么

1

检测主机环境

支持 macOS、Linux 和 WSL2。
2

确保兼容的 Node.js 运行时

Fased 推荐 Node 24，并要求 Node 22.14 或更新版本且带有内置 node:sqlite 模块。在支持的 Linux 主机上，启用自动安装时安装器可以安装缺失依赖。
3

确保 Git 可用

需要从仓库检出或更新。
4

准备仓库运行时

使用当前公开支持的仓库 checkout 安装流程。
5

按需运行新手引导

如果没有跳过，新手引导会交给 fased onboard --install-daemon。
6

通过 Sync 写入 SAT 运行时 id

预发布安装会保持 config/sat-runtime.env 为空。Satcoin mainnet proof 发布后，在 Mining 页面使用 Sync 验证签名 manifest，并写入官方 SAT ids。

​
最常用命令

./install.sh

./install.sh --help

./install.sh --no-onboard

./install.sh --verbose

​
常见模式

./install.sh
默认会运行新手引导。

​
主要参数

参数说明
--auto-install在支持的 Linux 上自动安装依赖
--no-auto-install不自动安装缺失依赖
--install-dir <path>指定 checkout/安装目录
--hosting使用托管/VPS 新手引导默认值
--local使用本地机器新手引导默认值
--swap-gb <n>为小内存 Linux 主机配置 swap
--no-onboard构建/安装后跳过新手引导
--verbose显示安装命令输出
--help显示帮助
-- 后面的额外参数会转发给 fased onboard --install-daemon。

​
环境变量

变量说明
FASED_INSTALL_REPO=<url>bootstrap 使用的仓库 URL
FASED_INSTALL_DIR=<path>checkout/安装目录
FASED_CONFIG_DIR=<path>配置、安装标记、缓存和日志目录
FASED_CLI_BIN_DIR=<path>install.sh 写入 fased 的目录
FASED_INSTALL_VERBOSE=1显示安装命令输出
FASED_INSTALL_USER=<name>root bootstrap 使用的非 root 用户
FASED_SAT_RUNTIME_ENV_FILE=<path>安装和新手引导读取的 SAT env 文件

​
自动化

无头安装： 
git clone https://github.com/fased-ai/fased.git fased
cd fased
./install.sh --no-onboard
在 CI 或受控主机上指定安装目录： 
git clone https://github.com/fased-ai/fased.git fased
cd fased
./install.sh --install-dir "$HOME/agent" --no-onboard

​
暂未作为公开安装路径

直接 npm install -g、pnpm add -g 或 Bun 全局包安装不是当前公开设置路径。 等包发布和发布自动化准备好后，这些路径可以重新加入。现在支持的公开路径仍然是仓库安装器。

​
相关页面