getAttribute('cloud_actor') ?? CloudAccess::actor(); if (!$actor['is_admin']) { throw new CloudError('需要管理员权限', 403); } if ($write) { CloudAccess::manage($actor); } return $actor; } private function host($id): CloudHost { $host = CloudHost::find($id); if ($host === null) { throw new CloudError('宿主机不存在', 404); } return $host; } public function scan($request, $response) { $actor = $this->actor($request, true); $body = CloudInput::object($request); CloudInput::only($body, ['host', 'port']); return $response->withJson((new CloudEngineClient())->request('POST', '/internal/v1/hosts/scan', $actor, $body)); } public function hosts($request, $response, $args = []) { $write = $request->getMethod() !== 'GET'; $actor = $this->actor($request, $write); $engine = new CloudEngineClient(); if (!$write && !isset($args['id'])) { return $response->withJson(['hosts' => CloudHost::orderBy('id')->get()->toArray()]); } if (!$write) { $host = $this->host($args['id']); return $response->withJson(array_merge($host->toArray(), $engine->host((int) $host->id, 'GET', 'host', $actor))); } $body = CloudInput::object($request, 131072); CloudInput::only($body, ['name', 'enabled', 'host', 'port', 'private_key', 'private_key_passphrase', 'host_key', 'confirmed_fingerprint', 'storage_pool', 'iso_pool', 'rescue_iso_pool', 'default_network', 'region', 'country_code', 'public_pool_cidr', 'public_gateway', 'public_dns_servers', 'public_reserved_ips', 'public_vm_prefix']); $name = $body['name'] ?? ''; if (!is_string($name) || trim($name) === '' || mb_strlen($name) > 80) { throw new CloudError('宿主机名称需为 1 至 80 字符'); } $enabled = filter_var($body['enabled'] ?? true, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE); if ($enabled === null) { throw new CloudError('启用状态无效'); } $region = $body['region'] ?? ''; if (!is_string($region) || trim($region) === '' || mb_strlen(trim($region)) > 64) { throw new CloudError('具体地区需为 1 至 64 字符,例如 HongKong 或 Tokyo'); } $body['region'] = trim($region); $countryCode = $body['country_code'] ?? null; if (!is_string($countryCode) || !in_array($countryCode, self::HOST_COUNTRY_CODES, true)) { throw new CloudError('国家代码无效,请选择中国、日本、美国或新加坡'); } unset($body['name'], $body['enabled'], $body['country_code']); $host = isset($args['id']) ? $this->host($args['id']) : new CloudHost(); if (!$host->exists) { $host->name = trim($name); $host->region = ''; $host->country_code = $countryCode; $host->enabled = false; $host->default_network = 'default'; $host->created_at = $host->updated_at = time(); $host->save(); } // Secrets only transit this request. They are exclusively encrypted/stored by the engine. $result = $engine->host((int) $host->id, 'PUT', 'host', $actor, $body); $host->name = trim($name); $host->region = (string) ($result['region'] ?? $body['region'] ?? ''); $host->country_code = $countryCode; $host->default_network = (string) ($result['default_network'] ?? $body['default_network'] ?? 'default'); $host->enabled = $enabled; $host->updated_at = time(); $host->save(); $warnings = is_array($result['warnings'] ?? null) ? $result['warnings'] : []; $inventorySync = null; try { $inventory = $engine->host((int) $host->id, 'POST', 'host/discover-vms', $actor, [ // Casting is required for the empty case: JSON [] is a list, // while the engine contract requires an owner map ({}) keyed // by UUID. 'known_owners' => (object) CloudInstanceDiscovery::knownOwners((int) $host->id), // Saving a host is an explicit super-admin action. Import // every VM not yet represented by either ownership database, // including guests carrying metadata from an older panel. 'claim_unowned_managed' => true, ]); $inventorySync = CloudInstanceDiscovery::synchronize($host, $inventory); if ($inventorySync['ownership_conflicts'] > 0) { $warnings[] = '发现虚拟机在业务库与引擎中的归属不一致,已保留原归属,请检查日志'; } } catch (\Throwable $error) { $log = 'Host VM discovery failed after host save: ' . get_class($error); if ($error instanceof CloudError) { $log .= ' status=' . $error->httpStatus . ' message=' . $error->getMessage(); } error_log($log); if ($error instanceof CloudError && $error->httpStatus === 404) { $warnings[] = '宿主机已保存,但引擎尚未加载扫描接口;请重启 virt-cloud-engine.service 后再次保存'; } elseif ($error instanceof CloudError) { $warnings[] = '宿主机已保存,但引擎扫描未完成;请查看 virt-cloud-engine.service 日志后重试'; } else { $warnings[] = '宿主机已保存,但业务库导入失败;请执行 php xcat cloudInit 后再次保存'; } } return $response->withJson(array_merge($result, $host->toArray(), [ 'warnings' => array_values(array_filter($warnings)), 'inventory_sync' => $inventorySync, ]), isset($args['id']) ? 200 : 201); } public function test($request, $response, $args) { $actor = $this->actor($request, true); $this->host($args['id']); $body = CloudInput::object($request, 131072); return $response->withJson((new CloudEngineClient())->host((int) $args['id'], 'POST', 'host/test', $actor, $body)); } public function userIsoSettings($request, $response) { $write = $request->getMethod() !== 'GET'; $this->actor($request, $write); if (!$write) { return $response->withJson(['enabled' => CloudUserIsoFeature::enabled()]); } $body = CloudInput::object($request); CloudInput::only($body, ['enabled']); $enabled = filter_var($body['enabled'] ?? null, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE); if ($enabled === null) { throw new CloudError('用户 ISO 开关状态无效'); } CloudUserIsoFeature::save($enabled); return $response->withJson(['enabled' => $enabled]); } public function templates($request, $response, $args = []) { $method = $request->getMethod(); $actor = $this->actor($request, $method !== 'GET'); $body = in_array($method, ['POST', 'PATCH', 'PUT'], true) ? CloudInput::object($request) : null; $kind = $args['kind']; if ($kind === 'cloud') { $templateId = isset($args['id']) ? CloudInput::template((string) $args['id']) : null; $templateCreatedAt = null; if ($method === 'DELETE') { $body = CloudInput::object($request); CloudInput::only($body, ['created_at']); $templateCreatedAt = $body['created_at'] ?? null; if (!is_int($templateCreatedAt) || $templateCreatedAt < 1) { throw new CloudError('云镜像版本无效,请刷新目录后重试'); } CloudTemplateDeletionService::begin( (string) $templateId, $templateCreatedAt ); } if ($body !== null) { unset($body['host_id']); if ($method === 'POST' && isset($body['sha256']) && is_string($body['sha256']) && trim($body['sha256']) === '') { unset($body['sha256']); } } $path = '/internal/v1/vm-templates'; if ($templateId !== null) { $path .= '/' . rawurlencode($templateId); } elseif ($method === 'POST') { $path .= '/import'; } if (isset($args['job_id'])) { $path .= '/import-jobs/' . rawurlencode($args['job_id']); } $engine = new CloudEngineClient(); $fullCatalogRead = $method === 'GET' && !isset($args['job_id']) && !isset($args['id']); try { if ($method === 'POST') { $result = CloudTemplateDeletionService::queueImport( static fn (): array => $engine->request( $method, $path, $actor, $body ) ); } elseif ($fullCatalogRead) { $result = CloudTemplateDeletionService::fetchAuthoritativeCatalog( static fn (): array => $engine->request( $method, $path, $actor, $body ), static function (array $catalog): void { CloudDeploymentPageService::rememberTemplateCatalog( $catalog ); } ); } else { $result = $engine->request( $method, $path, $actor, $body ); } } catch (CloudError $error) { if ($method === 'DELETE' && $templateId !== null && $templateCreatedAt !== null) { if ($error->httpStatus === 404 && $error->getMessage() === '云镜像模板不存在') { CloudTemplateDeletionService::complete( $templateId, $templateCreatedAt, static function () use ($templateId): void { CloudDeploymentPageService::forgetTemplate( $templateId ); } ); return $response->withJson([ 'deleted' => true, 'cache_cleanup_pending' => false, ]); } elseif ($error->httpStatus === 409 && $error->getMessage() === '云镜像版本已变化,请刷新后重试') { CloudTemplateDeletionService::cancel( $templateId, $templateCreatedAt ); } } throw $error; } if ($method === 'DELETE' && $templateId !== null) { CloudTemplateDeletionService::complete( $templateId, (int) $templateCreatedAt, static function () use ($templateId): void { CloudDeploymentPageService::forgetTemplate($templateId); } ); } elseif (is_array($result['template'] ?? null)) { CloudTemplateDeletionService::reactivateImportedTemplate( CloudInput::template($result['template']['id'] ?? ''), filter_var($result['template']['created_at'] ?? null, FILTER_VALIDATE_INT) ?: 0, static function () use ($result): void { CloudDeploymentPageService::rememberTemplate( $result['template'] ); } ); } return $response->withJson($result); } // Rescue ISOs remain deliberately scoped to one host and its separate // rescue directory. $query = $request->getQueryParams(); $hostId = filter_var($query['host_id'] ?? $body['host_id'] ?? null, FILTER_VALIDATE_INT); if (!$hostId) { throw new CloudError('请选择宿主机'); } $this->host($hostId); if ($body !== null) { unset($body['host_id']); } $resource = 'rescue-templates'; if (isset($args['id'])) { $resource .= '/' . rawurlencode($args['id']); } if (isset($args['job_id'])) { $resource .= '/import-jobs/' . rawurlencode($args['job_id']); } return $response->withJson((new CloudEngineClient())->host($hostId, $method, $resource, $actor, $body)); } public function rescueUpload($request, $response) { $actor = $this->actor($request, true); $query = $request->getQueryParams(); $hostId = filter_var($query['host_id'] ?? null, FILTER_VALIDATE_INT); $name = $query['name'] ?? ''; if (!$hostId || !is_string($name) || trim($name) === '' || mb_strlen($name) > 64) { throw new CloudError('请选择宿主机并填写救援模板名称'); } $this->host($hostId); if (strtolower(trim(explode(';', $request->getHeaderLine('Content-Type'))[0])) !== 'application/octet-stream') { throw new CloudError('请直接上传 ISO 文件内容'); } $temporary = tempnam(sys_get_temp_dir(), 'cloud-rescue-'); if ($temporary === false) { throw new CloudError('无法准备私有上传文件', 503); } chmod($temporary, 0600); $file = fopen($temporary, 'wb'); try { if ($file === false) { throw new CloudError('无法准备私有上传文件', 503); } $bytes = 0; $stream = $request->getBody(); while (!$stream->eof()) { $chunk = $stream->read(1048576); $bytes += strlen($chunk); if ($bytes > 8 * 1024 * 1024 * 1024) { throw new CloudError('救援 ISO 超过 8 GiB', 413); } if ($chunk === '' && !$stream->eof()) { throw new CloudError('上传中断'); } if (fwrite($file, $chunk) !== strlen($chunk)) { throw new CloudError('无法保存上传文件', 503); } } fclose($file); $file = null; if ($bytes < 32768) { throw new CloudError('ISO 文件内容无效'); } return $response->withJson((new CloudEngineClient())->upload('/internal/v1/hosts/' . $hostId . '/rescue-templates?name=' . rawurlencode(trim($name)), $actor, $temporary), 202); } finally { if (is_resource($file)) { fclose($file); } unlink($temporary); } } }