{# yername = me?.basics?.username or 'yourname' #} {# botname = 'kbpbot' #}
mkdir /keybase/private/#{yername},#{botname}/my-site
echo 'Hello, World!' > /keybase/private/#{yername},#{botname}/my-site/index.html
mkdir my-site; cd my-site
echo 'Hello, World!' > index.html
git init . && git add . && git commit -m init
git remote add kbp keybase://private/#{yername},#{botname}/my-site.git
git push kbp master
DNS 配置
要将流量处理委托给 Keybase Pages,你需要配置你的域名指向 Keybase Pages 端点 #{kbpdomain}。这通常通过 CNAME 记录完成。但如果你的 DNS 服务支持 A/AAAA ALIAS 记录,你也可以使用那个。
还需要第二个记录来指定站点的根目录,以便 Keybase Pages 服务器知道从哪里提供静态站点服务。如上所述,支持两种类型的根目录:KBFS 路径和托管在 Keybase 上的 Git 仓库。这是通过在站点所在域名下的 _keybase_pages. 子域名上的单个 TXT 记录完成的。例如,如果你在 https://example.com 上有一个静态站点,你需要在 _keybase_pages.example.com 上有这个 TXT 记录(除了 example.com 上的 CNAME 记录)。TXT 记录的值应为以下格式之一:
- KBFS 路径:
"kbp=<kbfs_path>" - Git 仓库:
"kbp=git@keybase:<private|public|team>/<folder_name>/<repo_name>"
你可以使用以下工具为你的站点生成 DNS 记录:
注意,我们这里使用的是 5 分钟的 TTL。在你确定配置无误后,你可以将其更改为更大的值,例如 3600(1 小时)。
每个域名注册商都有不同的 DNS 配置界面,所以很容易弄错。为了验证 DNS 配置,你可以使用 dig 查询配置的域名。你应该看到类似这样的内容:
注意,这可能不会立即显示,因为新添加的记录通常会有几分钟的 DNS 传播延迟。如果你正在更新现有记录,现有记录的 TTL 是传播延迟的上限。
访问控制
默认情况下,Keybase Pages 启用整个站点的读取和列表功能。如果你更喜欢关闭目录列表,或者想要使用 HTTP 基本认证 进行简单的 ACL 控制,你可以在站点根目录下提供一个可选的 .kbp_config。查看 .kbp_config 文档 获取更多详情。