跳到主要内容

上传应用空间

如果您需要将应用空间上传到CSGHub，您需要先注册一个账户，登录后可创建应用空间并上传数据文件。CSGHub平台上的应用空间基于Git存储库，可为您提供版本控制、分支管理和发现共享功能。您可以向应用空间中上传任何想要的数据文件。

本页介绍通过 Web 端和 Git 上传文件的操作。

💡 应该选择哪种方式？​

  • Web 端上传：最简单快捷，适合上传少量的小文件（单文件上限以当前上传页和部署配置为准）。
  • Git 上传：适合需要归档版本控制、管理整个应用空间所需的大量源文件和配置文件（大文件需配置 Git LFS，实际限制由站点与存储配置决定）。

使用Git上传应用空间​

前置准备工作​

  1. 安装 Git 和 Git LFS，并执行 git lfs install。
  2. 配置本地 Git 提交者信息：
git config --global user.name "您的用户名"
git config --global user.email "您的邮箱"
  1. 登录目标实例，在“账号设置 → Access Token”获取凭据。HTTPS 操作提示输入密码时使用该 Token；组织仓库还需要相应写入权限。

上传步骤​

从当前仓库页面复制 HTTPS 克隆地址。下面的命名空间和仓库名为示例；自部署域名以实际实例为准。

git lfs install
git clone https://your-csghub.example.com/spaces/your-namespace/example-space.git
cd example-space

将需要上传的文件放入本地仓库目录；确认没有包含 Token、密码或不需要上传的文件后提交：

git add .
git commit -m "Upload repository files"
git push

回到目标仓库的“文件”页核对文件和提交记录。

【特别说明】​

大文件应使用 Git LFS。在 git add 前检查仓库的 .gitattributes，确认所需文件已被追踪；需要新增追踪规则时执行：

git lfs track "path/to/large-file"
git add .gitattributes

上传大小和超时限制由站点、代理和存储配置决定。保留文件大小及错误信息，按本页支持的传输方式处理；不要把站点限制理解为 Git LFS 协议的统一上限。

使用Web端管理与上传文件​

在仓库“文件”页点击“添加文件”，可以选择“新建目录”、“创建新文件”或“上传文件”。

注意：单文件上限以当前上传页面为准。对于较大文件，请使用本页已说明支持的传输方式。

添加文件

新建目录​

点击“新建目录”，输入目录名称并提交，即可在当前仓库路径下创建子目录。

新建目录

创建新文件​

点击“创建新文件”，填写文件名称及内容，点击“创建文件”保存并提交。

创建文件

上传文件​

点击“上传文件”，选择需要上传的本地文件并提交。完成后在文件列表中确认目标文件已出现。

上传文件

查看应用空间的历史记录​

每次进行add-commit-push循环时，应用空间都会跟踪您对文件所做的每项更改。您可以浏览应用空间文件和提交，并查看每次提交引入的差异（也称为diff）。要查看历史记录，您可以点击“提交历史”。 提交历史

也可以单击单个提交来查看该提交引入了哪些更改： 引入更改

上传文件修改的是 Space 仓库内容，运行时数据的保存与删除规则见 空间设置。