Explain gateway stopped states with Web UI diagnostics (#663)

* feat: add gateway diagnostics to Web UI status

* fix: improve gateway diagnostics mobile layout
This commit is contained in:
luSkyl
2026-05-16 21:24:48 +08:00
committed by GitHub
parent 840cb6cd9f
commit 8571a7d0ac
4 changed files with 157 additions and 2 deletions
@@ -131,6 +131,18 @@ export interface GatewayStatus {
url: string
running: boolean
pid?: number
diagnostics?: GatewayDiagnostics
}
export interface GatewayDiagnostics {
pid_path: string
config_path: string
pid_file_exists: boolean
config_exists: boolean
health_url: string
health_checked_at: string
health_ok?: boolean
reason: string
}
interface ManagedGateway {
@@ -508,16 +520,36 @@ export class GatewayManager {
const pid = this.readPidFile(name)
const { port, host } = this.readProfilePort(name)
const url = buildHttpUrl(host, port)
const pidPath = join(this.profileDir(name), 'gateway.pid')
const configPath = join(this.profileDir(name), 'config.yaml')
const diagnostics: GatewayDiagnostics = {
pid_path: pidPath,
config_path: configPath,
pid_file_exists: existsSync(pidPath),
config_exists: existsSync(configPath),
health_url: `${url.replace(/\/$/, '')}/health`,
health_checked_at: new Date().toISOString(),
reason: 'stopped',
}
// 首先检查 PID 文件:如果存在且进程存活且健康,则标记为运行
if (pid && this.isProcessAlive(pid) && await this.checkHealth(url)) {
diagnostics.health_ok = true
diagnostics.reason = 'pid alive and health check passed'
this.gateways.set(name, { pid, port, host, url, owned: false })
return { profile: name, port, host, url, running: true, pid }
return { profile: name, port, host, url, running: true, pid, diagnostics }
}
if (pid) {
diagnostics.health_ok = false
diagnostics.reason = this.isProcessAlive(pid) ? 'pid alive but health check failed' : 'stale pid file'
} else if (!diagnostics.pid_file_exists) {
diagnostics.reason = 'missing pid file'
}
// 没有 PID 文件时不认领端口上的未知网关,避免误判其他 profile 的网关
this.gateways.delete(name)
return { profile: name, port, host, url, running: false }
return { profile: name, port, host, url, running: false, diagnostics }
}
/** 检测所有 profile 的网关状态 */