Skip to content

v0.1.1：一键安装脚本、自带密钥与安装引导修复

Choose a tag to compare

View all tags
@SparkHello SparkHello released this 08 Aug 14:12
· 25 commits to main since this release
v0.1.1
816332b

面向安装体验的一个小版本：一键安装脚本正式进入发布镜像，支持自带密钥，并修掉三处会把新用户带偏的安装引导问题。

安装

curl -fsSL https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/install.sh | sh

脚本会检查 Docker、下载用户版 Compose、自动避开被占用的端口、等待首启就绪，并打印 GATEWAY_API_KEY、admin key 和客户端接入信息。首次启动需要 1–2 分钟完成容器内部安装。

镜像：ghcr.io/sparkhello/memory-platform:v0.1.1（linux/amd64 + linux/arm64）。从 v0.1.0 升级重新运行上面的命令即可，数据保留在 memory-platform-data 卷中。

两枚密钥分别用在哪

安装会打印两枚密钥，用途不同：

  • GATEWAY_API_KEY —— 客户端（含手机）和 Web Console 登录用。只有这一枚需要填进客户端。
  • admin key —— 权限更高，只在这台电脑的浏览器里解锁模型渠道与路由配置时用，不需要填进任何客户端，也不需要传到手机上。

新增：可以自己指定密钥

不想用自动生成的随机串，可以在首次安装时自带（至少 16 个字符、不含空白）：

GATEWAY_API_KEY=你自己的密钥 sh -c "$(curl -fsSL https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/install.sh)"

MEMORY_CONSOLE_ADMIN_KEY 同理。两者对用户版 compose 和源码安装的 scripts/setup.sh 一样生效，留空则维持原来的自动生成。密钥只经进程环境传递，不会写进安装目录的 .env。

安装完成后更换密钥用 memgw secret set gateway / modelgw secret set memory-console-admin。

提醒：不要用聊天软件或剪贴板同步工具把密钥传到手机——那等于交给了第三方。自己设一个记得住的强密码更稳妥。

修复

  • scripts/setup.sh 结束时没有打印客户端最需要的 /v1 Base URL，只给了管理台地址，容易让人把 /ui/ 地址填进客户端；端口也不再硬编码 2026，改为读取实际配置。
  • 通过环境变量传入的 GATEWAY_API_KEY 现在会持久化到 settings.env。此前只有自动生成的分支才写盘，自带密钥在服务重启后会丢失。
  • 端口被占用时给出的重试命令用了 $0，而通过 curl | sh 运行时 $0 是 sh，用户复制到的是跑不起来的 sh sh。
  • 一键脚本此前无法区分「重复安装」和「首装但日志解析失败」，会对首次安装的用户谎称"检测到已有安装、密钥沿用旧的"，把人引向根本不存在的旧密钥。现在改为在启动容器前精确匹配本 compose 项目的数据卷。

完整改动见 CHANGELOG。

Assets 2
Loading