Solidway v0.1.0 已以 AGPL-3.0 发布,源码与 Releases 在 GitHub 上。文档正在按发布版本重写:除「快速开始」与「参考」外,其余页面仍在描述计划中的行为。当前权威说明见仓库内的 docs/getting-started.md 与 docs/architecture.md。
命令行
二进制接受的参数。其余全部在控制台配置。
solidway <data_root> [选项]
二进制只有一个位置参数:数据目录。其余——路由、凭据、Key、绑定地址、TLS、冷却时长—— 都在该目录下的数据库里,由控制台修改。
选项
| 选项 | 用途 |
|---|---|
--mode <desktop|standalone> |
默认 standalone。desktop 允许重启请求,并在 stdin 关闭时退出(桌面壳使用)。 |
--listen <addr> |
本次运行临时覆盖绑定地址与端口,不写入数据库。 |
--web-assets <dir> |
从磁盘目录加载控制台,而不是内嵌副本。 |
--master-key <hex|base64> |
直接提供 32 字节主密钥,仅用于恢复。 |
--reset-password |
把管理员打回「未设置口令」状态后退出。 |
-h、--help |
打印用法。 |
启动事件
stdout 上的机器可读行,前缀固定为 solidway: :
| 事件 | 含义 |
|---|---|
listening addr=<host:port> |
监听已就绪 |
bootstrap token=… url=… |
一次性引导地址(standalone、管理员尚未初始化) |
desktop-login url=… |
桌面自动登录地址(desktop 模式) |
bind-failed addr=… kind=… holder_pid=… holder_comm=… |
端口绑定失败 |
bootstrap-consumed |
引导令牌已被使用 |
含令牌的行不会写入 solidway.log。
退出与信号
| 信号 | 效果 |
|---|---|
SIGTERM / SIGINT |
落盘用量、写运行时快照、停止子进程后退出 |
| stdin EOF(仅 desktop 模式) | 等同于 SIGTERM——托管方已消失 |