diff options
Diffstat (limited to 'docs/locales/zh/configuration/tls.md')
-rw-r--r-- | docs/locales/zh/configuration/tls.md | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/docs/locales/zh/configuration/tls.md b/docs/locales/zh/configuration/tls.md new file mode 100644 index 000000000..5d92c9c5d --- /dev/null +++ b/docs/locales/zh/configuration/tls.md @@ -0,0 +1,64 @@ +# TLS + +你可以通过以下两种方式配置 TLS 支持: +* 内置支持 Lets Encrypt / ACME 兼容供应商 +* 从磁盘加载 TLS 文件 + +不能同时启用这两种方法。 + +注意,当使用从磁盘加载的 TLS 文件时,你需要在文件更改时重新启动实例。文件不会自动重新加载。 + +## 设置 + +```yaml +############################## +##### LETSENCRYPT 配置 ##### +############################## + +# 与自动获取和使用 LetsEncrypt HTTPS 证书相关的配置。 + +# 布尔值。是否为服务器启用 letsencrypt。 +# 如果为 false,这里的其余设置将被忽略。 +# 如果你的 GoToSocial 服务部署在 nginx 或 traefik 这样的反向代理后,请保持关闭状态。 +# 如果没有,请开启以便可以使用 https。 +# 选项:[true, false] +# 默认值:false +letsencrypt-enabled: false + +# 整数。监听 letsencrypt 证书挑战的端口。 +# 如果启用了 letsencrypt,则该端口必须可达,否则你将无法获取证书。 +# 如果没有启用 letsencrypt,则该端口将不会使用。 +# 这 *不能* 与上面指定的 webserver/API 端口相同。 +# 例子:[80, 8000, 1312] +# 默认值:80 +letsencrypt-port: 80 + +# 字符串。存储 LetsEncrypt 证书的目录。 +# 最好将其设置为存储目录中的子路径,以便于备份, +# 但如果其他服务也需要访问这些证书,你可能希望将它们移到别的地方。 +# 无论如何,请确保 GoToSocial 有权限写入/读取此目录。 +# 例子:["/home/gotosocial/storage/certs", "/acmecerts"] +# 默认值:"/gotosocial/storage/certs" +letsencrypt-cert-dir: "/gotosocial/storage/certs" + +# 字符串。注册 LetsEncrypt 证书时使用的电子邮件地址。 +# 此电子邮件地址很可能是实例管理员的地址。 +# LetsEncrypt 将发送关于证书到期等的通知到此地址。 +# 例子:["admin@example.org"] +# 默认值:"" +letsencrypt-email-address: "" + +############################## +##### 手动 TLS 配置 ##### +############################## + +# 字符串。磁盘上 PEM 编码文件的路径,包含证书链和公钥。 +# 例子:["/gotosocial/storage/certs/chain.pem"] +# 默认值:"" +tls-certificate-chain: "" + +# 字符串。磁盘上 PEM 编码文件的路径,包含与 tls-certificate-chain 相关的私钥。 +# 例子:["/gotosocial/storage/certs/private.pem"] +# 默认值:"" +tls-certificate-key: "" +``` |