C-SSH/SELF_HOSTING.md

自建 Creation Cloud 接入与版本分发

返回首页 · English

它负责什么

Creation Cloud 提供账号、设备、模型目录、手动加密同步、公告、版本和下载等控制面能力。SSH、终端、文件及 Agent 数据流不经过 Cloud。客户端默认官方云，也能连接自己部署的同一套服务；本地功能不强制登录。

本仓库的 creation-cloud/ 是筛选后的服务端生产源码镜像。数据库、SMTP、HTTPS、管理员及运行秘密由部署者自己配置和维护；它不是包含官方生产配置或秘密的一键安装包。

客户端连接

1. 准备可用的 Creation Cloud 服务和受信任 HTTPS 证书，将 CLOUD_PUBLIC_BASE_URL 配置为自己的公开根地址，例如 https://cloud.example.com。
2. 在 C-SSH 的“设置 → 云服务”选择“自建云”，填写同一个 HTTPS 根地址。
3. 测试连接，确认保存并切换，再登录该云的账号。地址不能含用户名、密码、路径、查询参数或片段；客户端不会跳过证书验证。
4. 官方云和不同自建云分别保留各自的账号/同步状态。切换不搬走本地主机、凭据或聊天；待恢复同步须先按界面处理。
5. 云同步仍需用户主动预览、选择和确认。数据保护密码与登录密码不同，AI 对话和长期记忆不参与同步。

管理员分发版本

0.9.3 本次必须手动下载安装，旧版无法自动更新。 不要为旧签名客户端强行开启这次升级。

后续具备相应升级条件时，管理员可从官方发布处下载原文件，保持字节和签名不变，在自建云后台上传资产并配置版本策略。客户端的更新检查和下载来自当前选择的云，不会另用官方云检查。

• Windows 包需要原始 updater signature。官方公开清单 GET /api/v1/downloads/releases 提供 file_name、sha256 和 updater_signature；将对应非空签名原样保存为 UTF-8 .sig，与包一起上传。不要用自建私钥替换官方签名。
• Android 上传原始 APK并保留它的安装签名；签名断代时仍须遵循官方手动安装及数据保护说明。
• 当前 Mac 使用手动 DMG 下载，没有自动安装更新合同；iOS本次不分发。
• 管理员应检查版本、平台、架构、SHA256、来源和实际下载。已发布文件及其摘要、签名不应被同名替换。

自建管理员负责证书、备份、邮件、服务可用性和权限。端到端同步的解密仍由客户端的数据保护机制控制，不能用“服务端已升级”代替用户实际完成解密或迁移。

0.9.3官方渠道仅公告手动下载，不投放升级提醒或强制更新；自建服务的版本和公告仍由其运营者维护。

当前Cloud自动更新资产合同只包含Windows x64与Android；Windows ARM64、Mac和Linux本次使用手动下载链接，不把ARM64映射成x64。