serve 命令

托管服务器的前台进程,也是 service install 安装的 systemd 单元的启动目标。生产环境通常不直接运行它,而是通过 systemd 管理(安装步骤见站内搜索 ?部署托管服务器)。

语法

docdoc serve --config <path>

参数

参数 说明 必填 缺省
--config <path> 服务器配置文件路径 是 —

行为说明

  • 配置文件缺 service.token 时拒绝启动并提示 配置缺少 Service.Token:serve 必须设置 Token
  • 启动后从数据目录恢复站点注册表,进程重启不丢站点
  • 开启 TLS 后监听 HTTPS,并在 tls.httpPort(缺省 80)按路由区分流量:ACME 质询与管理 API(/api/v1/sites 子树、健康探针)应答原内容,其余 301 跳转到 HTTPS
  • 设置 service.managementPort 时,额外以明文 HTTP 监听该端口,仅服务管理 API 与健康探针,其余路径 404

输出示例

docdoc serve 0.1.0 监听 http://0.0.0.0:10001(2 个站点)

SIGINT / SIGTERM 触发优雅退出。