跳到主要内容

服务管理

查看和控制悦库系统服务的运行状态。

子命令一览​

子命令只读说明
service / service status✓显示服务组件运行状态
service list✓列出本机所有受管服务名称
service start [名称]—启动服务；指定名称则仅启动单个服务
service stop [名称]—停止服务；指定名称则仅停止单个服务
service restart—软重启服务
service restart --hard—硬重启服务（卸载后重装）
service s3proxy on|off—开启/关闭 S3 代理（需硬重启生效）
service s3proxy status✓查看 S3 代理当前状态

所有 service 子命令均需先执行 opscli login。

查看服务状态​

opscli service
# 等同于
opscli service status
opscli service status --json

Linux 输出示例：

组件名          状态       运行时长
ydisks          running    3天

Windows 输出示例：

服务名          说明              状态
ydisk-web       悦库 Web 服务     running
ydisk-task      悦库任务服务      running

列出服务名称​

opscli service list
opscli service list --json

列出本机所有受管服务的名称，可用于 restart --service <名称> 等需要指定服务名的场景。

启动服务​

# 启动全部服务
opscli service start

# 启动单个服务（如仅启动 MySQL）
opscli service start ydisk-db

服务名可通过 opscli service list 查看。

停止服务​

# 停止全部服务
opscli service stop

# 停止单个服务（如仅停止 Web）
opscli service stop ydisk-web

服务名可通过 opscli service list 查看。

重启服务​

# 软重启（默认）
opscli service restart

# 硬重启（卸载后重装，用于升级或配置大幅变更后）
opscli service restart --hard

S3 代理管理​

# 开启 S3 代理（修改配置后需硬重启生效）
opscli service s3proxy on

# 关闭 S3 代理
opscli service s3proxy off

# 查看当前状态
opscli service s3proxy status
opscli service s3proxy status --json

输出示例：

配置状态: 已开启
端口 2010:   正在监听
S3代理服务 工作正常

异常状态输出：

配置状态: 已开启
端口 2010:   未监听
S3 代理异常: 配置已开启但端口未监听，请执行 opscli service s3proxy on 后硬重启
配置状态: 已关闭
端口 2010:   未监听
S3 代理异常: 已关闭，请执行 opscli service s3proxy on 后硬重启

JSON 输出示例（--json）：

{
  "platform": "windows",
  "port_open": true,
  "proxy_enabled": true
}

常见问题​

  • 提示"请先执行 opscli login"：先执行 opscli login。
  • Windows 下提示"需要管理员权限"：以管理员身份运行命令行后重试。
  • restart --hard 与 restart 的区别：软重启直接重启服务进程；硬重启会先卸载再重新安装，适用于升级或配置大幅变更后。