常见问题 / 快速入门
1.1 软件介绍
什么是云枢工具箱
云枢工具箱是一款本地优先的多云资源管理应用,面向需要管理多个云账号、服务器与日常工具的开发者和运维人员。账号、同步资产与操作记录默认保存在当前设备。
可以解决什么问题
将分散的云账号和资产集中查看,减少控制台之间的反复切换;从资源列表衔接 SSH、域名解析、对象存储与面板管理。不同厂商和平台支持的操作有所不同,请以客户端能力标识为准。
从哪里开始
先下载适合当前系统的安装包,再添加一个云账号、选择需要的资源类型进行同步。你也可以先阅读“添加与管理账号”和“资源同步与筛选”。
常见问题 / 快速入门
1.2 安装与首次使用
选择安装包
Windows 选择 x64 安装包;macOS 按设备芯片选择 Intel 或 Apple Silicon。Android 选择 ARM64 APK。当前发布渠道暂不提供 Linux 安装包。
首次使用
从 GitHub Releases 下载客户端并安装。首次启动后,在账号管理中添加云账号,再同步所需资源。安装与更新时请保留现有应用数据,不要将卸载或删除数据目录作为常规更新步骤。
iOS 安装方式
iOS 提供未签名 Xcode 归档,需要在 macOS 上通过 Xcode 自行签名构建。该归档不能直接作为 IPA 安装。
前往下载中心 →
常见问题 / 云账号
2.1 添加与管理账号
添加云账号
在账号管理中选择云厂商,填写该厂商要求的授权信息,并按需配置名称、分组与默认地域。建议按用途区分生产、测试和个人账号。
凭据如何使用
云厂商的授权字段和权限模型不同,请使用厂商控制台创建的合法凭据,并授予所需资源操作的权限。密钥与密码不要粘贴到反馈工单、截图或聊天记录中。
整理与验证
通过分组、启用状态和搜索整理账号;部分厂商支持连通性验证。验证通过不代表已经具备所有资源类型的读取或修改权限。
常见问题 / 云账号
2.2 云厂商与权限范围
支持哪些云厂商
已接入阿里云、腾讯云、火山引擎、天翼云、Oracle Cloud、华为云、百度智能云、京东云、UCloud、青云、金山云、七牛云、AWS、Microsoft Azure、Google Cloud 和 Vultr。
为什么部分操作不可用
厂商 API、账号权限与客户端实现范围不同。部分厂商仅支持资产或存储桶清单同步;应用中标注只读的能力不能执行写入操作。
授权建议
按实际用途分配资源读取和操作权限。调整授权后重新验证或同步;不要为解决单个问题直接扩大到不必要的全局管理员权限。
常见问题 / 云资源
3.1 资源同步与筛选
同步资源
在账号管理中选择账号及需要同步的资源类型,将厂商返回的资源保存到本地。同步结果受默认地域、权限和厂商支持范围影响。
查找资源
在资产管理中使用云厂商、地域、类型、状态及关键字筛选,收藏常用资源便于再次访问。本地列表是同步后的视图,需要查看最新状态时请刷新或重新同步。
资源操作
部分服务器资源支持改名、启动、停止或重启。执行前核对账号、地域和资源名称;具体可用操作以客户端提示为准。
常见问题 / 云资源
3.2 域名解析与对象存储
域名与 DNS
查看域名、WHOIS 和 DNS 记录。在已支持写入的厂商中,可以添加、编辑、启停或删除解析记录。修改前核对记录类型、主机记录和目标值。
对象存储
浏览存储桶与文件;部分厂商支持容量统计、CNAME、CORS 及自定义域名配置。是否提供文件或配置操作取决于对应厂商能力。
变更后如何确认
刷新客户端列表,并在需要时使用厂商控制台确认结果。DNS 生效还受缓存和 TTL 影响,刚修改后的查询结果可能暂未更新。
常见问题 / 日常运维
4.1 SSH 与远程连接
建立连接
从云资源或终端管理入口打开 SSH;支持密码、私钥及私钥口令。先确认服务器地址、端口、用户名及网络连通性。Windows RDP 以系统和客户端支持为准。
文件与命令
SSH 提供远程目录浏览、文件上传下载、编辑、删除和快捷命令。上传或修改前确认远程目录、文件权限及目标环境。
连接失败先查什么
依次检查本机网络、服务器运行状态、安全组与防火墙端口、SSH 服务及认证方式。不要在错误反馈中附上密码、私钥或未脱敏的连接配置。
常见问题 / 日常运维
4.2 面板与 HTTPS 证书
服务器面板
接入宝塔面板或 aaPanel 后查看在线状态、版本及 CPU、内存、磁盘、网络信息。面板不可达时,先核对地址、端口、授权配置与网络访问范围。
HTTPS 证书
从证书管理中申请、导入和管理证书及续期配置。申请前确认域名控制权与所需授权;不要分享证书私钥。
续期与部署
关注证书到期时间、续期结果及目标服务配置。证书申请、续期与服务部署属于不同步骤,需要分别确认结果。
常见问题 / AI 与内置工具
5.2 软件商店与内置应用
启用内置应用
在软件商店中按需启用应用,并配置是否显示在侧边栏。当前官方应用随客户端编译发布,不加载第三方插件代码。
有哪些工具
包括云效流水线、HTTPS 证书、身份验证器、Claude 管理、Codex 管理、内网穿透、备忘录与电脑信息等。微信多开、WSL 管理和指纹浏览器为 Windows 能力。
平台与版本限制
桌面和手机的工具范围不同。找不到某个入口时,先检查平台、客户端版本、软件商店中的启用状态及侧边栏显示配置。
常见问题 / 手机端
6.1 手机端下载与安装
Android
从同一版本的 GitHub Release 获取 Android ARM64 APK。安装前核对下载来源和版本;如果设备不兼容 ARM64,该安装包可能无法使用。
iOS
iOS 发布附件为未签名 Xcode 归档,需要自行签名构建,不能直接作为 IPA 安装。请使用具备 Xcode 的 macOS 环境处理。
在哪里下载
官网顶部“立即下载”可进入下载中心,桌面客户端“手机端下载”入口可前往官方发布页。请从项目官方发布渠道获取安装文件。
前往下载中心 →
常见问题 / 手机端
6.2 手机能力与设备数据
手机端能做什么
手机端覆盖云账号、服务器、域名解析及其他已支持的资源管理场景。具体功能与可写操作受平台、版本及厂商能力影响。
与电脑会自动同步吗
账号凭据、同步资产与操作记录默认保存在当前设备。桌面与手机同版本发布,不代表设备之间自动同步账号和数据。
不同设备如何使用
请在各设备上按客户端支持的方式配置账号与资源。涉及导入、导出或备份时,先确认文件是否含敏感信息并妥善保管。
常见问题 / 数据与安全
7.1 本地数据、备份与隐私
数据保存在哪里
账号凭据、资源和操作记录默认保存在本机。Windows 数据库默认位于 %LOCALAPPDATA%\CloudHubTools\cloudhub_tools.sqlite3;macOS 默认位于用户 Library/Application Support/CloudHubTools/cloudhub_tools.sqlite3。
凭据如何保护
云账号密钥、面板 API Key 和已保存的 SSH 密码使用本机生成的密钥加密保存。账号列表不会明文显示 AccessKey Secret。
如何备份更稳妥
不要只复制单个数据库就假定可以在另一设备恢复:凭据解密还涉及本机密钥。使用当前客户端支持的导入导出能力,核对范围;备份前关闭客户端,并妥善保管包含敏感信息的文件。
常见问题 / 数据与安全
7.2 许可与使用范围
可以免费使用吗
可以从发布页获取客户端。源码采用 PolyForm Noncommercial 1.0.0 许可,使用、修改与分发需遵守许可条款。商业用途请先确认授权。
在哪里查看许可
项目 GitHub 仓库中的 LICENSE 是许可说明来源。涉及商业集成、再分发或定制交付时,请先阅读许可并确认适用范围。
参与贡献
可通过 GitHub Issues 提交可复现的问题或建议,或在仓库中了解贡献方式。不要提交真实凭据、未脱敏数据库或第三方敏感内容。
常见问题 / 故障排查
8.1 资源为空或同步失败
资源列表为空
先检查当前筛选条件、账号启用状态、地域和同步类型,再确认厂商控制台中确实存在相应资源。清除筛选后重试。
同步失败
检查网络与代理、凭据有效性及厂商授权范围。若仅某一资源类型失败,优先确认对应 API 权限及客户端支持情况。
不要用删数据代替排查
先记录客户端版本、厂商、资源类型和脱敏后的错误信息。不要直接删除数据库或重置整个数据目录,以免丢失账号与本地记录。
常见问题 / 故障排查
8.2 日志、更新与问题反馈
查看日志
客户端保留本地操作日志和云 API 请求日志,可用于回溯相关账号与资源操作。分享前移除凭据、账号标识、地址及其他敏感信息。
更新客户端
从官方 Releases 选择与设备架构匹配的版本。更新前保留现有数据与必要备份,更新后确认版本号和常用功能。
如何提交问题
在 GitHub Issues 提供系统与芯片架构、客户端版本、复现步骤、预期结果及实际结果,并附脱敏截图或错误信息。无法稳定复现时,说明发生频率与已尝试的排查步骤。