Files
C-SSH/SELF_HOSTING.md

35 lines
2.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 自建 Creation Cloud 接入与版本分发
[返回首页](README.md) · [English](SELF_HOSTING_EN.md)
## 它负责什么
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。