English | 简体中文
用于管理 Sub-Store 后端服务的命令行工具。由于该工具基于 Docker,您需要先安装 Docker。
您可以通过运行以下命令来安装这个工具:
curl -sSL https://sub-store-org.github.io/resource/ssm/install.sh | bash或者您可以下载 Release 文件,并手动配置环境变量和程序名称。
如果您正在使用脚本安装则可以直接执行以下命令。如果您正在进行手动安装,请确保每个命令中的程序名称匹配你的可执行文件名。
创建一个新的 Sub-Store Docker 容器并运行,如果镜像不存在将自动构建。
ssm new该命令支持以下 flag:
-
--interface或-i:当您传递-i标志时,将创建前端容器而不是后端容器。默认行为是创建一个后端容器。 -
--name或-n:容器的唯一名称,默认名称为ssm-backend,如果您传递了-i标标志来创建一个前端容器,则默认名称为ssm-frontend。此名称将用于管理持久化数据,只要不手动删除该名称的持久化数据,或者使用ssm delete -c标志执行删除操作,无论是如何删除/重建容器,只要使用此名称都可以访问该数据。 -
--version或-v:一个 Sub-Store Release 的版本字符串,默认获取最新版本。如果您传递了-i标志来创建前端容器,则-v标志将被忽略,它总是使用最新版本的前端。 -
--port或-p:指定端口映射,默认为3000,且必须可用,如果您传递了-i标标志来创建一个前端容器,则默认端口为80。如果你想使用域名访问服务,则需要使用反向代理工具(如 Nginx 或 Caddy)手动代理该端口。 -
--network:指定一个 docker network,作用等同于docker run中的--network, 不指定使用 Host 模式,指定则使用 Bridge 模式,若网络存在则加入该网络,若不存在则创建该网络并加入。 -
--private:默认情况下,创建一个 HostIP 为127.0.0.1的容器。如果使用--private=false则为0.0.0.0。。
⚠️ 注意如上图所示,3000 端口的服务添加时使用
http://localhost:3000/4424703b2bae575f0861bf07eafa来加入 Sub-Store 后端列表。
0.0.12版本前创建的容器请删除容器后重新使用ssm new命令创建来开启随机哈希,注意保持原容器名称来保持旧数据。
更新一个 Sub-Store Docker 容器,确保镜像已经存在且正在运行。
ssm update该命令支持以下 flag:
-
--name或-n:一个正在运行的容器名称,默认名称为ssm-backend。 -
--version或-v:一个 Sub-Store Release 的版本字符串,默认获取最新版本。如果您更新目标为前端容器,则-v标志将被忽略,它总是使用最新版本的前端。
启动一个未在运行的 Sub-Store Docker 容器,默认名称为 ssm-backend。
基本等价于
docker start <name>.
ssm new <name>停止一个正在运行的 Sub-Store Docker 容器,默认名称为 ssm-backend。
基本等价于
docker stop <name>.
ssm stop <name>删除一个 Sub-Store Docker 容器,默认名称为 ssm-backend。
基本等价于
docker rm <name>.
ssm delete <name>该命令支持以下 flag:
--clear或-c: 同时删除容器的持久化数据。如果删除的为前端镜像,则-c标志将被忽略,因为前端镜像没有持久化数据。
列出所有 Sub-Store Docker 容器。
基本等价于
docker ps -a并过滤以ssm镜像启动的容器。
ssm ls查看当前 Sub-Store-Manager-Cli 的版本。
ssm version如果您使用脚本安装则可以直接执行以下命令。如果您使用手动安装,请手动移除您的可执行文件。
rm -rf /usr/local/bin/ssm如果您想同时删除持久化数据,可以执行以下命令:
rm -rf ~/.ssmGPL-3.0 License
