Permafrost
Permafrost 是专为 Frost 打造的托管存储。连接只需要一个访问密钥,没有存储桶、区域或端点需要设置。
和其他存储一样,你的备份在上传之前就已经在你的电脑上加密了。Permafrost 读不到它们。
在 getfro.st/perma/portal 管理你的 Permafrost 账户。在快照浏览器中,先按 [h],再按 [p] 即可打开。此快捷键仅适用于默认的 Permafrost 服务。
#获取密钥
- 运行
frost init,选择 Permafrost。 - 选择 I don't have a key yet(我还没有密钥)。Frost 会在浏览器中打开 getfro.st/perma。如果浏览器没有打开,请自己访问这个地址。
- 在那里获取密钥并复制。
- 把它粘贴到设置程序中。
如果你已经有密钥,选择 I have a key(我有密钥)并粘贴进去。
#获取新密钥
如果你弄丢了密钥,请访问 getfro.st/perma/recover,输入你获取密钥时用的邮箱地址。你会收到一封邮件,里面的链接可以领取新密钥。新密钥会替换旧密钥,旧密钥在所有电脑上都会失效。
在每台使用 Permafrost 的电脑上换成新密钥:
frost config set storage.permafrost.token <new key>
在 Permafrost 不接受上传期间,frost config set 无法完成它的存储检查。这时请改用 frost config edit,把密钥填到 [storage.permafrost] 下的 token 里。
#存储用量
frost status 会显示你用了多少 Permafrost 存储空间。当 Permafrost 有事要告诉你时,比如存储快满了,frost status 和 frost backup 会以警告的形式显示出来。参见检查备份。
#Permafrost 拒绝请求时
Permafrost 的错误信息会说明原因。需要访问备份的命令会带着这条信息停止。
| 你看到的 | 含义 |
|---|---|
| the Permafrost access key was rejected | 密钥不对、已被更新的密钥替换,或者账户已关闭。错误信息会说明是哪一种。请使用你最新的密钥,或者获取一个新密钥 |
| uploads are paused | Permafrost 暂时不接受新的备份,恢复照常可用。错误信息会说明原因、持续到什么时候以及该怎么做 |
| your Permafrost storage is full | 这次上传放不下。错误信息会说明你存了多少以及该怎么做 |
在设置程序中,前两条会显示为 "Permafrost didn't accept that access key" 和 "Permafrost won't store backups with that access key",后面跟着同样的原因。
#兼容的服务器
除了默认服务器,Frost 还可以使用任何支持 Permafrost API 的服务器。这适合已经在运行这类服务器的人。如果要备份到你自己的电脑上,自托管存储只需要 SSH。
兼容的服务器必须遵守 API 的对象和错误规则,包括拒绝空的上传。服务器繁忙时,Frost 会自动重试。
第一次设置之前,请在 Frost 的配置文件夹中创建 config.toml,填入下面的设置。文件夹位置见文件与文件夹。请把地址换成自己服务器的地址:
[storage]
backend = "permafrost"
[storage.permafrost]
url = "https://<your-server>"
然后运行 frost init,选择 Permafrost,粘贴访问密钥,选择要备份的文件夹并保存。如果服务器为空,设置程序会创建仓库。
如果 Frost 已经设置好了,请用 frost config edit 在现有文件中同时修改后端和服务器地址。如果新服务器为空,请接受警告,输入 yes 保存,然后再次运行 frost init。frost config set 会拒绝空的目标位置,所以不能用它来准备新服务器。
地址必须使用 https://,只有运行在你自己电脑上的服务器例外,比如 http://localhost:8080。把这项设置留空,就会使用默认的 Permafrost 服务器 https://permafrost.wihiaawb.com。