Struct ApiClient 

pub struct ApiClient { /* private fields */ }

API 客户端

Implementations

impl ApiClient

pub fn new( client_id: Option<String>, authenticated_client: Option<Arc<AuthenticatedClient>>, ) -> Self

创建新的 API 客户端

pub fn set_client_id(&mut self, client_id: String)

设置客户端ID

pub fn set_authenticated_client( &mut self, authenticated_client: Arc<AuthenticatedClient>, )

设置认证客户端

pub fn get_config(&self) -> &ApiConfig

获取当前API配置

pub async fn register_client( &self, request: ClientRegisterRequest, ) -> Result<String>

注册客户端

pub async fn get_announcements( &self, since: Option<&str>, ) -> Result<AnnouncementsResponse>

获取系统公告

pub async fn check_docker_version( &self, current_version: &str, ) -> Result<DockerVersionResponse>

检查Docker服务版本

pub async fn get_docker_version_list(&self) -> Result<DockerVersionListResponse>

获取Docker版本列表

pub async fn download_service_update<P: AsRef<Path>>( &self, save_path: P, ) -> Result<()>

下载Docker服务更新包

pub async fn download_service_update_from_url<P: AsRef<Path>>( &self, url: &str, save_path: P, ) -> Result<()>

从指定URL下载Docker服务更新包

pub async fn download_service_update_from_url_with_auth<P: AsRef<Path>>( &self, url: &str, save_path: P, use_auth: bool, ) -> Result<()>

从指定URL下载Docker服务更新包（支持认证控制）

pub async fn report_service_upgrade_history( &self, request: ServiceUpgradeHistoryRequest, ) -> Result<()>

上报服务升级历史

pub async fn report_client_self_upgrade_history( &self, request: ClientSelfUpgradeHistoryRequest, ) -> Result<()>

上报客户端自升级历史

pub async fn report_telemetry(&self, request: TelemetryRequest) -> Result<()>

上报遥测数据

pub fn get_service_download_url(&self) -> String

👎Deprecated:

不在使用，现在需要区分架构和全量和增量

获取服务下载URL（用于配置显示）

pub async fn calculate_file_hash(file_path: &Path) -> Result<String>

计算文件的SHA256哈希值

pub async fn save_file_hash(file_path: &Path, hash: &str) -> Result<()>

保存文件哈希信息到.hash文件

pub async fn load_file_hash(file_path: &Path) -> Result<Option<String>>

从.hash文件读取哈希信息

pub async fn verify_file_integrity( file_path: &Path, expected_hash: &str, ) -> Result<bool>

验证文件完整性

pub async fn needs_file_download( &self, file_path: &Path, remote_hash: &str, ) -> Result<bool>

检查文件是否需要下载（简化版本）

pub async fn should_download_file( &self, file_path: &Path, remote_hash: &str, ) -> Result<bool>

检查文件是否需要下载（完整版本，包含哈希文件缓存）

pub async fn get_enhanced_service_manifest( &self, ) -> Result<EnhancedServiceManifest>

获取增强的服务清单（支持分架构和增量升级） 优先从 OSS 获取，失败后降级到原 API 地址 支持通过 NUWAX_API_DOCKER_VERSION_URL 环境变量自定义 URL NUWAX_CLI_ENV=test 时使用 beta/latest.json

pub async fn download_service_update_optimized_with_progress<F>( &self, download_path: &Path, version: Option<&str>, download_url: &str, progress_callback: Option<F>, ) -> Result<()>

where F: Fn(DownloadProgress) + Send + Sync + 'static,

下载服务更新包（带哈希验证和优化及进度回调）

pub async fn download_service_update_optimized( &self, download_path: &Path, version: Option<&str>, download_url: &str, ) -> Result<()>

下载服务更新包（带哈希验证和优化）- 保持向后兼容

pub async fn save_hash_file( hash_file_path: &Path, hash: &str, version: Option<&str>, ) -> Result<()>

保存哈希文件

Trait Implementations

impl Clone for ApiClient

fn clone(&self) -> ApiClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ApiClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.