getAttribute('cloud_actor') ?? CloudAccess::actor(); } private function json($response, array $value, int $status = 200) { return $response->withJson($value, $status)->withHeader('Cache-Control', 'no-store'); } public function session($request, $response) { try { $actor = CloudAccess::actor(); $user = Auth::getUser(); return $this->json($response, ['authenticated' => true, 'username' => $user->user_name, 'user_id' => (int) $user->id, 'email' => $user->email, 'admin' => $actor['is_admin'], 'can_manage' => $actor['can_manage'], 'approved' => true, 'csrf_token' => AdminCsrf::token(), 'balance' => (string) $user->money]); } catch (CloudError $error) { return $this->json($response, ['authenticated' => false, 'detail' => $error->getMessage()], $error->httpStatus === 401 ? 200 : $error->httpStatus); } } public function plans($request, $response) { $plans = []; foreach (Shop::where('status', 1)->orderBy('sort')->orderBy('id')->get() as $plan) { $host = CloudHost::where('id', $plan->host_id)->where('enabled', 1)->first(); if ($host !== null) { $plans[] = ['id' => (int) $plan->id, 'name' => $plan->name, 'price' => (string) $plan->price, 'cpu_cores' => (int) $plan->cpu_cores, 'memory_mib' => (int) $plan->memory_mib, 'bandwidth_mbps' => (int) $plan->bandwidth_mbps, 'disk_gib' => (int) $plan->disk_gib, 'validity_days' => (int) $plan->validity_days, 'traffic_quota_bytes' => (int) $plan->traffic_quota_bytes, 'traffic_gib' => $plan->trafficGiB(), 'stock' => (int) $plan->stock, 'host_id' => (int) $host->id, 'host_name' => $host->name, 'region' => $host->region]; } } return $this->json($response, ['plans' => $plans]); } public function orders($request, $response) { $actor = $this->actor($request); if ($request->getMethod() === 'POST') { // Compatibility alias for a browser loaded before the unified // billing release. It now creates only an unpaid invoice. return $this->createProvisionInvoice($request, $response, $actor); } $query = CloudOrder::query(); if (!$actor['is_admin']) { $query->where('user_id', $actor['user_id']); } return $this->json($response, ['orders' => $query->orderByDesc('id')->limit(200)->get()->map( fn ($order) => CloudOrderService::display($order))->all()]); } public function order($request, $response, $args) { $actor = $this->actor($request); $query = CloudOrder::where('id', $args['id']); if (!$actor['is_admin']) { $query->where('user_id', $actor['user_id']); } $order = $query->first(); if ($order === null) { throw new CloudError('订单不存在', 404); } return $this->json($response, ['order' => CloudOrderService::display($order)]); } public function orderRequest($request, $response, $args) { $actor = $this->actor($request); $key = (string) ($args['key'] ?? ''); if (preg_match('/^[A-Za-z0-9_.-]{16,128}$/D', $key) !== 1) { throw new CloudError('订单请求标识无效'); } // Deliberately owner-only even for administrators: this endpoint is // used to reconcile a browser's possibly lost purchase response. $order = CloudOrder::where('user_id', $actor['user_id']) ->where('idempotency_key', $key)->first(); if ($order === null) { throw new CloudError('订单请求尚未建立', 404); } return $this->json($response, ['order' => CloudOrderService::display($order)]); } public function invoiceRequest($request, $response, $args) { $actor = $this->actor($request); $key = (string) ($args['key'] ?? ''); if (preg_match('/^[A-Za-z0-9_.-]{16,128}$/D', $key) !== 1) { throw new CloudError('账单请求标识无效'); } $order = CloudOrder::where('user_id', $actor['user_id']) ->where('idempotency_key', $key)->first(); $invoice = $order === null ? null : CloudInvoice::where('order_id', $order->id)->first(); if ($invoice === null || (string) ($invoice->purpose ?: 'renewal') !== 'provision') { throw new CloudError('账单请求尚未建立', 404); } return $this->json($response, ['invoice' => CloudInvoiceService::display($invoice)]); } public function invoices($request, $response) { $actor = $this->actor($request); if ($request->getMethod() === 'POST') { return $this->createProvisionInvoice($request, $response, $actor); } $user = Auth::getUser(); $invoices = CloudInvoice::where('user_id', $actor['user_id']) // The unified page must never hide a newly-created opening bill // behind older invoices whose service due dates are farther in // the future. Keep all actionable bills first, then newest audit // history; pagination can extend the historical tail later. ->orderByRaw("CASE WHEN status IN ('open', 'overdue') THEN 0 ELSE 1 END") ->orderByDesc('created_at')->orderByDesc('id')->limit(200)->get() ->map(fn ($invoice) => CloudInvoiceService::display($invoice))->all(); return $this->json($response, ['invoices' => $invoices, 'payment_methods' => CloudInvoicePaymentService::methods($user), 'balance' => (string) $user->money]); } private function createProvisionInvoice($request, $response, array $actor) { $order = CloudOrderService::purchase(CloudInput::object($request), $actor); $invoice = CloudInvoice::where('order_id', $order->id)->first(); if ($invoice === null) { // An idempotency key from a pre-invoice deployment can still // resolve to its historical order after an upgrade. Do not turn // that expected compatibility case into an opaque HTTP 500. if ((string) $order->status !== 'awaiting_payment') { throw new CloudError('该请求已由旧版开通流程处理,请刷新实例列表或联系管理员核对', 409); } throw new \RuntimeException('开通账单创建失败'); } return $this->json($response, ['invoice' => CloudInvoiceService::display($invoice)], 201); } public function invoice($request, $response, $args) { $actor = $this->actor($request); $invoice = CloudInvoice::where('id', $args['id']) ->where('user_id', $actor['user_id'])->first(); if ($invoice === null) { throw new CloudError('账单不存在', 404); } return $this->json($response, ['invoice' => CloudInvoiceService::display($invoice)]); } public function payInvoice($request, $response, $args) { $actor = $this->actor($request); $invoice = CloudInvoice::where('id', $args['id']) ->where('user_id', $actor['user_id'])->first(); if ($invoice === null) { throw new CloudError('账单不存在', 404); } $body = CloudInput::object($request); CloudInput::only($body, ['idempotency_key']); $paid = CloudInvoiceService::payBalance($invoice, $actor, trim((string) ($body['idempotency_key'] ?? ''))); $user = Auth::getUser()->fresh(); return $this->json($response, ['invoice' => CloudInvoiceService::display($paid), 'balance' => (string) $user->money]); } public function createInvoicePayment($request, $response, $args) { $actor = $this->actor($request); $invoice = CloudInvoice::where('id', $args['id']) ->where('user_id', $actor['user_id'])->first(); if ($invoice === null) { throw new CloudError('账单不存在', 404); } $payment = CloudInvoicePaymentService::create($invoice, Auth::getUser(), CloudInput::object($request), (string) $request->getServerParam('REMOTE_ADDR', ''), (string) $request->getHeaderLine('User-Agent')); return $this->json($response, ['payment' => $payment], 201); } public function job($request, $response, $args) { $actor = $this->actor($request); $query = CloudJob::where('id', $args['id']); if (!$actor['is_admin']) { $query->where('user_id', $actor['user_id']); } $job = $query->first(); if ($job === null) { throw new CloudError('任务不存在', 404); } return $this->json($response, CloudJobService::display($job)); } private function vmData(CloudInstance $instance, array $actor): array { $owner = (int) $instance->user_id === (int) $actor['user_id']; $global = ($actor['is_admin'] ?? false) && ($actor['is_super_admin'] ?? false) && ($actor['can_manage'] ?? false); $spec = json_decode($instance->spec_json, true) ?: []; try { $vm = (new CloudEngineClient())->host((int) $instance->host_id, 'GET', 'vms/' . rawurlencode($instance->uuid), $actor); } catch (CloudError $error) { $vm = ['name' => $instance->name, 'state' => 'unknown', 'detail' => '宿主机暂时无法连接']; } $host = CloudHost::find($instance->host_id); $createdAt = ($spec['record_source'] ?? '') === 'discovered' ? (is_string($vm['created_at'] ?? null) && trim($vm['created_at']) !== '' ? $vm['created_at'] : null) : gmdate('Y-m-d\TH:i:s\Z', (int) $instance->created_at); $period = $instance->current_period_id === null ? null : CloudServicePeriod::where('id', $instance->current_period_id) ->where('instance_id', $instance->id)->first(); $futurePeriods = CloudServicePeriod::where('instance_id', $instance->id) ->where('status', 'scheduled')->count(); $maximumFuturePeriods = max(1, min(120, (int) Config::get('cloud_max_renewal_periods_ahead', 24))); $lifecycleActive = (string) $instance->status === 'active'; $canDelete = $lifecycleActive && ($owner || $global); // Traffic quota enforcement only disconnects guest NICs. It must not // remove power, console or maintenance controls while the paid service // period itself is still active. $canOperate = $canDelete && $instance->serviceAvailable(); return array_merge(CloudInput::safeResult($spec), CloudInput::safeResult($vm), ['id' => (string) $instance->id, 'uuid' => $instance->uuid, 'user_id' => (int) $instance->user_id, 'owner_user_id' => (int) $instance->user_id, 'display_uuid' => $instance->uuid, 'host_id' => (int) $instance->host_id, 'region' => $host?->region ?? '', 'created_at' => $createdAt, 'instance_status' => (string) $instance->status, 'service_status' => (string) $instance->service_status, 'network_status' => (string) $instance->network_status, 'service_expires_at' => $instance->expires_at === null ? null : (int) $instance->expires_at, 'current_period_started_at' => $period === null ? null : (int) $period->starts_at, 'current_period_ends_at' => $period === null ? null : (int) $period->ends_at, 'prepaid_periods' => $futurePeriods, 'traffic_download_bytes' => (int) $instance->traffic_download_bytes, 'traffic_upload_bytes' => (int) $instance->traffic_upload_bytes, 'traffic_used_bytes' => (int) $instance->traffic_download_bytes + (int) $instance->traffic_upload_bytes, 'traffic_quota_bytes' => (int) $instance->traffic_quota_bytes, 'renewal_price' => $instance->renewal_price === null ? null : (string) $instance->renewal_price, 'renewal_days' => (int) $instance->renewal_days, 'renewal_traffic_bytes' => (int) $instance->renewal_traffic_bytes, 'is_owner' => $owner, 'can_operate' => $canOperate, 'can_delete' => $canDelete, 'can_view_credential' => $owner || $global, 'can_renew' => $lifecycleActive && $owner && $instance->expires_at !== null && (int) $instance->renewal_days > 0 && $instance->renewal_price !== null && $futurePeriods < $maximumFuturePeriods, 'has_initial_root_password' => ($owner || $global) && $instance->credential_cipher !== null]); } public function vms($request, $response) { $actor = $this->actor($request); $query = CloudInstance::where('status', '<>', 'deleted'); if (!$actor['is_admin']) { $query->where('user_id', $actor['user_id']); } return $this->json($response, ['vms' => $query->orderByDesc('id')->limit(200)->get()->map( fn ($instance) => $this->vmData($instance, $actor))->all()]); } public function vm($request, $response, $args) { $actor = $this->actor($request); return $this->json($response, $this->vmData(CloudAccess::instance($args['id'], $actor), $actor)); } public function metrics($request, $response, $args) { $actor = $this->actor($request); $instance = CloudAccess::instance($args['id'], $actor); $query = $request->getQueryParams(); $range = $query['range'] ?? '1h'; if (!in_array($range, ['1h', '24h', '7d', '30d'], true)) { throw new CloudError('指标时间范围无效'); } $suffix = '?range=' . rawurlencode($range); return $this->json($response, (new CloudEngineClient())->host((int) $instance->host_id, 'GET', 'vms/' . rawurlencode($instance->uuid) . '/metrics' . $suffix, $actor)); } public function dailyTraffic($request, $response, $args) { $actor = $this->actor($request); $instance = CloudAccess::instance($args['id'], $actor); $rawDays = $request->getQueryParams()['days'] ?? '30'; if (!is_string($rawDays) && !is_int($rawDays)) { throw new CloudError('流量统计天数无效'); } $days = filter_var((string) $rawDays, FILTER_VALIDATE_INT, ['options' => ['min_range' => 1, 'max_range' => 30]]); if ($days === false) { throw new CloudError('流量统计天数必须为 1 至 30'); } return $this->json($response, (new CloudEngineClient())->host((int) $instance->host_id, 'GET', 'vms/' . rawurlencode($instance->uuid) . '/traffic/daily?days=' . (int) $days, $actor)); } public function credential($request, $response, $args) { $instance = CloudAccess::instance($args['id'], $this->actor($request), true); if ($instance->credential_cipher === null) { throw new CloudError('该虚拟机没有面板保存的初始密码', 404); } return $this->json($response, CloudSecrets::decrypt($instance->credential_cipher)); } public function consoleTicket($request, $response, $args) { $actor = $this->actor($request); $instance = CloudAccess::instance($args['id'], $actor, true); $this->requireService($instance, $actor); $actor = CloudAccess::vmActor($instance, $actor); return $this->json($response, (new CloudEngineClient())->host((int) $instance->host_id, 'POST', 'vms/' . rawurlencode($instance->uuid) . '/console-ticket', $actor, [])); } public function actions($request, $response, $args) { $actor = $this->actor($request); $instance = CloudAccess::instance($args['id'], $actor, true); $actor = CloudAccess::vmActor($instance, $actor); $body = CloudInput::object($request); CloudInput::only($body, ['action']); if (!in_array($body['action'] ?? '', ['start', 'shutdown', 'reboot', 'poweroff', 'reset'], true)) { throw new CloudError('操作无效'); } if (in_array($body['action'], ['start', 'reboot', 'reset'], true)) { $this->requireService($instance, $actor); } $job = CloudJobService::enqueue($instance, $actor, 'action', 'POST', '/actions', $body); return $this->json($response, ['job_id' => (string) $job->id, 'status_url' => '/api/v1/jobs/' . $job->id], 202); } public function reinstall($request, $response, $args) { $actor = $this->actor($request); $instance = CloudAccess::instance($args['id'], $actor, true); $this->requireService($instance, $actor); $body = CloudInput::object($request); CloudInput::only($body, ['template_id', 'ssh_key_id', 'root_password', 'confirmation_name']); if (($body['confirmation_name'] ?? '') !== $instance->name) { throw new CloudError('请填写虚拟机名称确认重装'); } $body['template_id'] = CloudInput::template($body['template_id'] ?? null); $key = CloudSSHKeys::owned($body['ssh_key_id'] ?? null, $actor['user_id']); unset($body['ssh_key_id']); $body['ssh_public_key'] = $key?->public_key ?? ''; $body['root_password'] = CloudInput::password($body['root_password'] ?? null); $job = CloudJobService::enqueue($instance, $actor, 'reinstall', 'POST', '/reinstall', $body, ['password' => $body['root_password'], 'login_name' => 'root', 'auth_mode' => $key ? 'password_and_key' : 'password']); return $this->json($response, ['job_id' => (string) $job->id, 'status_url' => '/api/v1/jobs/' . $job->id], 202); } public function rescue($request, $response, $args) { $actor = $this->actor($request); $write = $request->getMethod() !== 'GET'; $instance = CloudAccess::instance($args['id'], $actor, $write); $suffix = '/rescue' . ($args['rescue_action'] ?? ''); if (!$write) { return $this->json($response, (new CloudEngineClient())->host((int) $instance->host_id, 'GET', 'vms/' . rawurlencode($instance->uuid) . $suffix, $actor)); } $this->requireService($instance, $actor); $body = CloudInput::object($request); CloudInput::only($body, ['template_id', 'confirmation_name', 'ack_data_loss']); if (($body['confirmation_name'] ?? '') !== $instance->name) { throw new CloudError('请填写虚拟机名称确认操作'); } if ($suffix === '/rescue/exit') { // The saved original XML may predate a traffic-quota block. Pass // the current billing target so the engine restores every NIC in // the correct link state before it starts the normal system. $body['network_suspended'] = in_array( (string) $instance->network_status, ['blocking', 'blocked_traffic', 'blocked_expired', 'block_failed'], true); } $job = CloudJobService::enqueue($instance, $actor, 'rescue', 'POST', $suffix, $body); return $this->json($response, ['job_id' => (string) $job->id, 'status_url' => '/api/v1/jobs/' . $job->id], 202); } private function requireService(CloudInstance $instance, array $actor): void { $global = ($actor['is_super_admin'] ?? false) && ($actor['can_manage'] ?? false); if (!$global && !$instance->serviceAvailable()) { throw new CloudError('实例服务已到期或正在恢复,请先续费并等待恢复完成', 409); } } public function delete($request, $response, $args) { $actor = $this->actor($request); $instance = CloudAccess::instance($args['id'], $actor, true); $body = CloudInput::object($request); CloudInput::only($body, ['confirmation_name', 'delete_disks']); if (($body['confirmation_name'] ?? '') !== $instance->name) { throw new CloudError('请填写虚拟机名称确认删除'); } $deleteDisks = filter_var($body['delete_disks'] ?? true, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE); if ($deleteDisks === null || ((string) $instance->service_status !== 'exempt' && !$deleteDisks)) { throw new CloudError('销售实例删除必须同步删除面板管理的虚拟磁盘'); } $job = CloudJobService::enqueue($instance, $actor, 'delete', 'DELETE', '?delete_disks=' . ($deleteDisks ? 'true' : 'false'), []); return $this->json($response, ['job_id' => (string) $job->id, 'status_url' => '/api/v1/jobs/' . $job->id], 202); } public function sshKeys($request, $response) { $actor = $this->actor($request); if ($request->getMethod() === 'POST') { $body = CloudInput::object($request); CloudInput::only($body, ['name', 'public_key']); $name = $body['name'] ?? ''; if (!is_string($name) || trim($name) === '' || mb_strlen($name) > 80) { throw new CloudError('公钥名称需为 1 至 80 字符'); } $parsed = CloudSSHKeys::parse($body['public_key'] ?? ''); if (CloudSSHKey::where('user_id', $actor['user_id'])->where('fingerprint', $parsed['fingerprint'])->exists()) { throw new CloudError('该公钥已经添加', 409); } $key = new CloudSSHKey(); $key->user_id = $actor['user_id']; $key->name = trim($name); $key->public_key = $parsed['public_key']; $key->fingerprint = $parsed['fingerprint']; $key->created_at = time(); $key->save(); return $this->json($response, ['id' => (int) $key->id, 'name' => $key->name, 'fingerprint' => $key->fingerprint], 201); } $keys = CloudSSHKey::where('user_id', $actor['user_id'])->orderBy('id')->get()->map(fn ($key) => ['id' => (int) $key->id, 'name' => $key->name, 'fingerprint' => $key->fingerprint, 'created_at' => (int) $key->created_at])->all(); return $this->json($response, ['keys' => $keys]); } public function deleteKey($request, $response, $args) { $key = CloudSSHKeys::owned($args['id'], $this->actor($request)['user_id']); $key->delete(); return $this->json($response, ['deleted' => true]); } public function resources($request, $response) { $actor = $this->actor($request); $query = $request->getQueryParams(); if (isset($query['vm_id'])) { $hostId = (int) CloudAccess::instance($query['vm_id'], $actor)->host_id; } else { $plan = Shop::where('id', $query['plan_id'] ?? 0)->where('status', 1)->first(); $hostId = (int) ($plan?->host_id ?? 0); if (!CloudHost::where('id', $hostId)->where('enabled', 1)->exists()) { throw new CloudError('套餐宿主机不可用', 404); } } $engine = new CloudEngineClient(); $value = $engine->host($hostId, 'GET', 'resources', $actor); $templates = $engine->host($hostId, 'GET', 'vm-templates', $actor); $rescue = $engine->host($hostId, 'GET', 'rescue-templates', $actor); $value['templates'] = $templates['templates'] ?? []; $value['rescue_templates'] = $rescue['templates'] ?? []; $value['host_id'] = $hostId; return $this->json($response, $value); } }