Superalgos / 安装部署
Superalgos 安装：五条官方路径与它们各自的硬前置
最容易踩的坑不是命令写错，而是「装错了对象」：官方要求的默认路径是先 fork 官方仓库、再 clone 你自己的 fork，并准备一个有 repo 与 workflow 权限的 GitHub 令牌——因为社区扩展也要逐个 fork 到你的账号下。这一页把五条路径、前置条件、体积与端口一次讲清，并说明为什么「下载 apk」这条路走不通。
五条官方路径怎么选
官方把「开发者与贡献者」列为默认路径，同时提供另外四条。它们的差别不只是命令，而是「装完之后你能做什么」。
| 路径 | 关键命令 / 产物 | 前置条件 | 装完能做什么 | 适合谁 | 注意点 |
|---|---|---|---|---|---|
| 开发者与贡献者（官方默认） | git clone <你的 fork> → node setup → node setupPlugins <用户名> <PAT> → node platform | Node.js（16.6+）、Git、浏览器（推荐 Chrome）、GitHub 个人访问令牌（repo+workflow） | 完整功能，且可以提交代码、文档、翻译与评测 | 要长期用、要改、要参与贡献的人 | 必须 clone 自己的 fork，不是上游仓库；node setup 可加 shortcuts 建快捷方式 |
| 打包版（Windows 便携/安装包、macOS DMG） | 从官方 Releases 下载对应系统安装包 | 无需 Node/Git | 日常功能齐全，可创建并提交治理用户档案 | 只想先把软件用起来、不想碰命令行的人 | 安装包未做代码签名，杀毒会拦截；macOS 需去隔离或手动允许 |
| Docker | docker run ghcr.io/superalgos/superalgos:latest | Docker Desktop（Mac/Win）或 Docker Engine（Linux/BSD） | 干净隔离的生产实例 | 要长期稳定运行、不想污染主机环境的人 | 标准 Docker 安装不能提交贡献或配置治理档案；镜像约 2 GB，容器内不含 git（刻意如此） |
| 树莓派 | 同开发者路径，但不装浏览器，用 node platform minMemo noBrowser | 需要先熟悉开发者路径或 Docker 路径 | 低功耗的实盘/长期运行节点 | 要一台 7×24 跑任务的小机器 | 官方建议只在「准备开始实盘」时用极简硬件，学习阶段仍应在全尺寸电脑上 |
| 公有云 | 社区项目（如 AWS 的 Terraform 方案） | 同上，且要会云平台操作 | 云上长期运行 | 要云上部署且愿意自己排障的人 | 官方不支持任何公有云厂商；文档里的 AWS 项目在 2022-12 时仍在开发，未达生产可用 |
| EasyClaw 技能路线（备选，非本平台安装方式） | 安装 EasyClaw 后按任务提问 | 安装 EasyClaw；部分技能另有依赖或凭据 | 行情取数、指标、图表与研究结论 | 研究阶段先要结论、不想装 Node 环境的人 | 它不是 Superalgos 的安装方式，也不提供交易机器人链路；两者无已证实集成 |
默认路径怎么走：fork → clone → setup → 扩展 → 启动
以下命令全部来自官方 README；每一步给出可核对的预期结果。
装前置：Node.js、Git，以及浏览器
官方要求安装最新版 Node.js 与 Git，并建议 Chrome（开发团队只在 Chrome 与 macOS 的 Safari 上测试）。预期：
node -v返回 16.6 以上的版本号、npm -v返回 5 以上；低于 Node 16 的机器需先升级（Ubuntu 等发行版自带的版本通常偏旧，官方推荐用 nvm 装新版）。拿一个 GitHub 个人访问令牌（PAT）
在 GitHub 的令牌新建页创建一个新令牌，权限勾选
repo与workflow。官方要求把令牌拷出来保存好，后面setupPlugins会用到，日常使用中也会偶尔需要。预期：拿到一串以gh开头的令牌。fork 官方仓库（注意别只 fork 一个分支）
在官方仓库页点 Fork。官方特别提示：默认页面会给「只 fork master 分支」的选项，必须去掉这个勾选，否则后续脚本无法从多个仓库构建应用。预期：你的账号下出现 Superalgos 仓库副本。
clone 你自己的 fork 并装依赖
复制你自己 fork 页面的地址，执行
git clone <你的 fork 地址>，然后cd Superalgos与node setup。可选参数：shortcuts建桌面快捷方式；tensorflow才装 TensorFlow 依赖。官方建议装在盘根目录或路径较短的目录，某些系统对长路径不友好。预期：依赖安装完成，不出现大段报错。装社区扩展
执行
node setupPlugins <你的 GitHub 用户名> <你的 PAT>。这一步会把社区扩展仓库逐个 fork 到你的账号并 clone 到本地Plugins目录；官方说明没做完这一步无法正常使用软件。扩展仓库出问题时，删掉Plugins下对应目录重跑本命令即可修复。启动并进行首次运行
执行
node platform；内存 8 GB 及以下加minMemo，无界面服务器加noBrowser；也可指定项目与工作区，例如node platform Foundations Blank-Template。预期：终端显示服务已启动，浏览器打开 GUI（默认 34248 端口），随后按官方要求逐课做完内置教程。
两条路线的前置条件有什么不同：缺哪一项会卡在哪
下面每一项都来自官方 README 或子 README，最后一列写清「没有它会怎样」。
| 前置项 | 要求 | 依据 | 缺了会怎样 |
|---|---|---|---|
| Node.js | 官方排查段写 node > 16.6、npm > 5；低于 16 需先升级 | README Troubleshooting | node setup 大量报错或直接失败 |
| Git | 按向导装最新版并保留默认设置 | README 前置章节 | 无法 clone fork，扩展也无法 clone |
| 浏览器 | 推荐 Chrome；官方只在 Chrome 与 macOS Safari 上测试 | README Usage Notes | 界面可能异常，且官方支持需要你先在 Chrome 复现 |
| GitHub 账号 + PAT | 令牌权限需含 repo 与 workflow | README 第 2 步 | setupPlugins 无法 fork 与 clone 扩展仓库 |
| 磁盘与网络 | 仓库约 1.18 GB，还要放下依赖与后续数据 | GitHub API size | clone 或 node setup 中途失败 |
| 内存 | 官方建议 8 GB 以上用普通模式；≤8 GB 用 minMemo；仅 1 GB 的机器需退到 Node 16.x | README Usage / Troubleshooting | 启动后卡顿甚至跑不完教程 |
| Python 3（仅 TensorFlow） | 只在你打算试 TensorFlow 集成时需要 | README 前置章节 | 仅影响该可选集成，不影响主体功能 |
http://192.168.0.132:34248。所以如果你在找 apk，正确做法是先用桌面路径装好，再用手机浏览器连过去。Docker 与打包版有什么区别：端口、卷与两个官方警告
这两条路径最容易被低估，因为它们的限制不在安装过程，而在装完之后。
| 项目 | 官方值 / 做法 | 说明 | 注意点 |
|---|---|---|---|
| Docker 镜像 | ghcr.io/superalgos/superalgos:latest | 镜像约 2 GB，基于 alpine，构建于 GitHub Actions | 标签可选 latest / master / develop / 提交哈希 / 发行标签；生产建议用哈希或发行标签钉住版本 |
| Docker 端口 | 34248（GUI）与 18041 | 容器内实际执行 node platform noBrowser minMemo | 需要显式 -p 映射，否则宿主机访问不到界面 |
| Docker 数据卷 | My-Data-Storage / My-Log-Files / My-Workspaces / My-Network-Nodes-Data / My-Social-Trading-Data | 不挂卷则容器重启后数据丢失 | 权限不对时保存工作区会报错，可调目录属主或用户组 |
| 容器内没有 git | 日志里会出现一条 git 缺失的报错 | 官方明确这是刻意的，不影响机器人运行 | 别把它当成故障去修 |
| 打包版签名 | 未做代码签名 | 官方解释是签名要花钱、而项目完全免费 | 杀毒很可能报不安全并拦截；需要你手动允许安装 |
| macOS 去隔离 | DMG 分 x64 与 ARM64 两种；需在终端执行去隔离命令或在安全设置里手动允许 | 官方给了对应命令与菜单路径 | 选错架构的 DMG 会跑不起来 |
| 打包版数据位置 | 用户文档目录下的 Superalgos_Data | 重装不丢数据，便于备份 | 与开发者路径的数据目录不同，迁移时别只拷一部分 |
卸载与数据落盘：它会往哪里写东西
搞清楚这一点，备份、迁移与容器化才不会丢数据。
| 问题 | 官方答案 | 对你的影响 | 注意点 |
|---|---|---|---|
| 卸载怎么做 | 在安装目录执行 node uninstall，再删除整个 Superalgos 目录 | 不需要跑系统级卸载器 | 快捷方式要先用该命令清理 |
| 目录之外写了什么 | 官方说明除快捷方式外不写任何东西 | 删目录即可彻底移除 | 打包版会把数据放在文档目录的 Superalgos_Data，删目录前先确认 |
| 换机器/重装怎么保数据 | 保留数据目录与工作区目录 | 回测与挖好的数据不必重跑 | 容器路线要提前把对应目录挂成卷 |
| 日志放哪 | ./Platform/My-Log-Files/<应用名>/{error,combined}/<日期>.log | 排错的第一站 | 五个应用各有独立目录，详见排错页 |
| 多个实例能共存吗 | 可以，但官方提示要先重命名安装目录再执行建快捷方式 | 便于同时跑稳定版与开发版 | 不重命名会产生快捷方式名字冲突 |
| 怎么更新代码 | 开发者路径可执行 node updateGithubRepos 更新已 fork 的仓库 | 老 fork 重装时常用 | 官方要求先跑过 node setup 与 node setupPlugins |
依赖安装阶段的排查表
下表场景全部来自官方 README 的 Troubleshooting 附录与 Prerequisites Notes，按「先看现象再看核对方式」排列。
| 现象 | 可能原因 | 核对方法 | 处理方向 |
|---|---|---|---|
node setup 报大量意料之外的错误 | 本地 npm 状态与锁文件不一致 | 看报错是否集中在依赖解析阶段 | 官方建议先执行 npm ci --omit=optional 重置，再重跑 node setup |
| 提示 node / npm 版本过低 | npm < 5 或 node < 16.6 | node -v、npm -v | 先升级 Node；发行版自带版本偏旧时用 nvm 装新版 |
| 装到一半提示权限不足 | 装在受系统保护的目录 | 确认安装目录是否需要管理员权限 | Windows 用管理员命令行；Linux/macOS 用 sudo node setup |
| Windows 下命令找不到 | C:\Windows\System32 不在全局 PATH | 检查系统 PATH 变量 | 按官方提示把该目录加回 PATH |
| Linux 上提示 make/cc/gcc 缺失 | 非 x86 芯片（如 arm64）需要额外构建工具 | 看报错里指向的缺失程序名 | 按官方说明安装 make、gcc、g++（如 apt-get install build-essential） |
Linux 上提示跑 npm audit fix | 该提示在本项目里不适用 | —— | 官方明确说忽略它，不要执行 |
| 装 TensorFlow 依赖时最后报错 | TensorFlow 集成在 Windows 上有已知边界情况 | 看报错后面是否跟着官方给的后续指令 | 按报错后附的说明处理；该集成官方自述为部分且未完成，非必装项 |
| 更新 fork 时拉不下上游改动 | node setup 的 npm 前置脚本会执行 git checkout develop 与 git pull upstream develop | 确认本地是否有名为 upstream 的远端指向官方仓库 | 补齐 upstream 远端或改用官方推荐的手动更新方式 |
安装常见问题
命令与前置以官方 README 与子 README 为准；本站未做实机安装验证。
一定要 fork 官方仓库吗？直接 clone 行不行？
官方默认路径要求先 fork、再 clone 你自己的 fork，理由是安装脚本要从多个仓库构建应用，同时你的改动也需要能提回项目。想让后续的扩展安装与贡献流程正常，建议按官方路径来；具体是否可以变通、变通后会缺什么能力，请以官方文档与你自己的验证为准。
为什么还需要 GitHub 令牌？会不会有风险？
令牌用于让脚本把社区扩展仓库 fork 到你的账号并 clone 到本地，权限需要 repo 与 workflow。风险控制上有两点值得注意：一是令牌权限尽量按最小必要给，二是不把它写进任何要分享的截图或文件里。官方同时提醒：管理员不会主动索要你的 API key 或令牌，主动私聊索取的一律按诈骗处理。
有 apk 或者手机端吗？
没有官方 Android 安装包。界面是本地启动的网页服务，默认 34248 端口，手机可以用浏览器访问同一局域网内的地址。所以正确顺序是先在电脑上装好并启动，再用手机浏览器连过去——以官方文档为准。
仓库有多大？网络不好能装吗？
GitHub 公开 API 显示仓库约 1.18 GB，装完还要加上依赖与后续数据。官方还特别建议把安装目录放在盘根目录或路径较短的位置，某些系统对长路径不友好。网络不稳时最容易在 clone 与 node setup 两步失败，建议预留时间并保持连接稳定。
下载的安装包被杀毒软件拦下来了，是病毒吗？
官方明确说明打包版安装包没有做代码签名，原因是签名要花钱而项目完全免费，因此被杀毒标记为不安全是预期现象。你需要自行判断是否信任该来源并手动允许安装。如果你不接受这个前提，可以改用开发者路径或 Docker 路径。
Docker 装完为什么提示 git 缺失？
这是刻意的：官方在容器里不安装 git，因为生产容器只需要运行机器人，不需要从仓库拉代码。README 明确说这条报错不影响机器人正常运行，不要把它当作故障处理。
装完就能开始交易了吗？
不能，也不建议这样理解。官方要求先做完内置交互教程（前三课约 2–3 小时），之后依次是准备数据、搭策略、跑回测与模拟盘，最后才考虑接入真实凭据。本站不提供任何收益预期、买卖点或资金建议，实盘风险与合规要求请自行确认。
不想装这一整套环境，有没有替代做法？
如果你当前的目标只是拿到行情、指标或研究结论，可以先走免部署的 EasyClaw 技能路线（本机已核验 akshare-finance、quant-analyst、chart-image 等技能）；但它不是 Superalgos 的安装方式，也不能替代交易机器人链路，两者没有已证实集成。入口在顶部导航「对比」。