Arkvory

Web 控制台 ​

Web 控制台是 Arkvory 的浏览器界面。它是服务器的一部分，因此无需单独安装。在服务器地址后加上 /console/ 即可打开，例如在服务器本机上是 http://127.0.0.1:8080/console/，设置好 HTTPS 之后是 https://arkvory.example/console/。

控制台使用与命令行客户端和 SDK 相同的 HTTP API。服务器会检查每一个请求。按钮被隐藏，只表示您的账户或密钥无权使用该操作。

布局 ​

侧边栏把各个栏目分组。在窄屏幕上，侧边栏会变成 菜单 按钮。

分组栏目
库制品、包、文件历史、制品详情
传输上传、下载
资源用户与访问、仓库、服务访问、更新、备份、入门、API 与 CLI

顶部栏显示栏目标题、上传文件 按钮、反馈 按钮，以及外观和语言控件。

每个栏目都有自己的地址，例如 #/catalog、#/packages 或 #/backups。打开的制品的地址是 #/artifact/<repository>/<id>。您可以收藏这些地址，也可以发给其他人。地址中从不包含密码、密钥或搜索文本。如果在登录之前打开链接，控制台会在您登录之后打开它。

有些栏目只对部分用户显示：

栏目谁能看到
用户与访问管理员
仓库所有已登录的用户
服务访问恢复密钥，以及获得委派权限的运维密钥
更新管理员
备份管理员和恢复密钥

登录 ​

仓库连接 卡片位于页面顶部。

  1. 输入您的 用户名 和 密码。
  2. 选择 登录。会话持续 12 小时。
  3. 控制台会选择您有权读取的第一个 仓库。若要在其他仓库中工作，请输入其名称，或从列表中选取。

若要用密钥代替密码连接，请打开 使用服务密钥或自动化密钥连接，粘贴密钥并选择 连接。密钥只保留在此浏览器标签页的内存中，控制台绝不会保存它。

注册 仅在管理员允许自助注册时显示。断开连接 会结束连接。

使用密码登录后，可以使用 修改我的密码 和 个人访问令牌。个人访问令牌是用于您自己的工具的密钥。参见账户与访问。

第一个所有者 ​

全新安装没有任何账户。在 Windows 上，安装程序会创建所有者。在其他安装中，请在控制台中创建所有者：

  1. 打开 入门 并展开 创建第一个所有者。
  2. 粘贴安装目录中 config/bootstrap-token.txt 里的恢复密钥。
  3. 输入名称和至少 12 个字符的密码，然后选择 创建所有者。
  4. 用新的名称和密码登录。

该表单仅在尚无任何账户时有效。所有者是管理员，并通过 arkvory-owners 组获得对 releases 仓库的写入权限。

库 ​

制品 ​

制品 列出仓库中已发布的文件。可以按名称或元数据值搜索。使用 按标签筛选 只显示某一个标签，使用 精确元数据 按确切的键和值筛选。每一行显示名称、大小、发布时间、阶段和标签。选择 下载 下载文件，或选择 打开 查看其详细信息。加载更多 显示下一页。

包 ​

包 列出已注册的 UPack 版本。按 UPack 组 和 包名称 筛选，设置 排序依据 和 分组依据，然后选择 应用。阶段列显示每个版本晋级到了哪些阶段。参见包。

文件历史 ​

一个文件路径（例如 builds/game/1.4/GameSetup.exe）可以多次指向新的内容。每次变更都是一个新版本。在 文件历史 中输入路径并选择 加载历史记录，即可看到每个版本及其作者和时间。可以打开任意版本来下载它的原始内容。恢复旧版本会创建一个新版本，不会删除任何内容。参见文件与路径。

制品详情 ​

制品详情 显示单个制品的信息：

  • 概要：大小、上传时间 和 SHA-256，并带有 复制 按钮。
  • 属性：标签、集合 和 构建元数据。选择 保存更改 保存它们。文件本身不会改变。
  • 操作：下载；下载链接 会创建一个无需密钥、一小时内有效的链接；注册 UPack 会为 UPack 归档建立索引。
  • 文件链接：分配文件 会把此制品设为某个文件路径的当前内容。
  • 晋级：添加阶段 会给制品标记一个阶段，例如 qa 或 release。晋级 会把它发布到另一个仓库。参见晋级。
  • 清单与附加文件：添加附件 会把清单、SBOM、签名、报告或其他文件关联到此构建。附件历史记录 显示之前的几组附件。
  • 删除制品：检查依赖项 显示仍在使用该制品的内容。若要删除，请粘贴制品 ID 并选择 删除此制品。删除需要带有 artifact.delete 操作的服务密钥；密码登录、个人令牌和恢复密钥都不能删除。

传输 ​

上传 ​

在 上传 中选择文件，然后选择 上传 / 续传。控制台先计算文件的 SHA-256，然后按分片发送。暂停 会停止传输，并保留已上传的分片。

若要稍后继续，请记住上传 ID。打开 继续上传，选择同一个文件并输入 上传 ID。上传期间离开页面之前，浏览器会发出警告。参见传输。

下载 ​

下载 是您从控制台下载的文件队列。控制台在保存最终文件之前，会检查每个文件的 SHA-256。

  • 队列设置 用于设置 并行下载数（1 到 8）、启动间隔，ms 和 队列等待上限，秒。
  • 全部暂停、继续队列、取消等待中的下载、全部取消 和 移除已完成 用于控制整个队列。
  • 页面重新加载后，请重新登录并选择 恢复队列。然后逐个继续每个文件，并选择保存位置。

大文件下载需要在安全地址（HTTPS 或本机）上使用 Chrome 或 Edge。临时数据保存在浏览器的私有存储中。

资源 ​

用户与访问 ​

管理员在这里管理人员。账户 列出账户，组与权限 列出组。可使用 创建用户、重置密码、创建组 和 管理组成员。在 管理仓库访问权限 中，按名称为组授予对某个仓库的 读取 或 读写 访问权限。仓库没有单独的创建步骤：只要有授权或服务策略提到某个仓库名称，它就存在了。

仓库 ​

仓库 显示您能看到的仓库，以及 您的权限。每张卡片上有 打开文件、存储与清理（配额、自动清理和物理清理；需要带有 storage.read 或 storage.manage 操作的服务密钥），管理员还能看到 管理访问权限。镜像仓库会显示 镜像 徽标。参见仓库和存储。

服务访问 ​

在这里为工具和 CI 系统创建账户。要看到此栏目，请使用恢复密钥或运维密钥连接。选择 创建服务账户，然后设置 仓库权限。读取预设 和 发布预设 会填入常用的权限组合。

若要签发密钥，请打开 服务密钥 并选择 签发密钥。机密只显示一次。复制它，勾选 我已保存机密，然后选择 激活密钥。未激活的密钥会在 15 分钟后过期。使用 轮换 替换密钥，使用 撤销 停用密钥。委派管理 允许所有者向运维人员授予有限的管理权限。

更新 ​

更新 显示 已安装版本 和 最新稳定版。选择 立即检查 或 安装更新。在 自动更新 中，打开 自动安装兼容的稳定版，并选择 维护时段（UTC）。参见更新。

备份 ​

备份 显示备份是否正常、最新的备份、下次运行时间、备份代理和备份存储。选择 立即备份 启动备份。恢复点 列出恢复点；可以逐字节验证某个恢复点，也可以固定它。计划与保留 设置每日时间、时区和保留多少个恢复点。恢复是在服务器上执行的命令。参见备份。

入门与 API 参考 ​

入门 显示新服务器的第一步操作。API 与 CLI 列出示例命令。加载允许的 API 操作 显示您当前的账户或密钥可以调用的 API 操作。

反馈 ​

登录后，反馈 会通过中心（hub）向 ProAnimaStudio 发送消息。可以添加最多 6 张图片和一个用于回复的电子邮件地址。管理员可以附上服务器日志。选择 显示附带的内容 可以确切看到发送了哪些内容。

外观与语言 ​

外观 有三个选项：跟随系统、浅色 和 深色。语言 以各自的名称列出控制台的所有语言：English、Русский、Español、Français、Deutsch、Português、中文、日本語、한국어、हिन्दी 和 العربية。页面会立即切换，无需重新加载，也不会丢失您已输入的内容；阿拉伯语从右向左显示。首次访问时，控制台会遵循浏览器的首选语言，若无匹配则回退到英语。API 与 CLI 中的 文档 会用控制台当前的语言打开本文档。浏览器只保存主题和语言，不保存任何关于您的账户或仓库的信息。

Arkvory · ProAnimaStudio