mirror of
https://github.com/superseriousbusiness/gotosocial.git
synced 2024-12-18 16:31:06 +00:00
38a08cd25a
* [docs] add zh docs * [docs] add lang dropdown * [docs] update mkdocs zh config * [docs] migrate assets * [docs] update overrides dir in mkdocs zh config * [docs] exclude locales director in main mkdocs config * [docs] rename assets to public to avoid conflicting with template * [docs] extra_css change followup * [docs] add theme.palette.toggle.icon back into mkdocs zh config * [docs] fix zh readme reference + migrate language-specific repo markdown to docs * [docs] translate remaining repo docs + update reference * [docs] update zh index.md reference * [docs/zh] wording alignment
170 lines
8.4 KiB
Markdown
170 lines
8.4 KiB
Markdown
# 管理设置面板
|
||
|
||
GoToSocial 管理设置面板使用 [管理 API](https://docs.gotosocial.org/zh-cn/latest/api/swagger/#operations-tag-admin) 来管理你的实例。它与 [用户设置面板](../user_guide/settings.md) 结合使用,并采用与普通客户端相同的 OAuth 机制(范围:admin)。
|
||
|
||
## 设置管理员账户权限和登录
|
||
|
||
要使用管理设置面板,你的账户必须被提升为管理员:
|
||
|
||
```bash
|
||
./gotosocial --config-path ./config.yaml admin account promote --username 你的用户名
|
||
```
|
||
|
||
为了使提权生效,可能需要在运行命令后重启你的实例。
|
||
|
||
之后,你可以访问 `https://[your-instance-name.org]/settings`,在登录字段中输入你的域名,然后像使用其他客户端一样登录。现在,你应该可以看到管理设置。
|
||
|
||
## 管理
|
||
|
||
实例管理设置。
|
||
|
||
### 举报
|
||
|
||
![一个展示未解决举报的举报列表。](../public/admin-settings-reports.png)
|
||
|
||
举报部分显示来自本站用户或外站(匿名显示,仅显示实例名称,不显示具体用户名)的举报列表。
|
||
|
||
点击举报可以查看其是否已解决(若有理由则显示),更多信息,以及由举报用户选定的被举报贴文列表。你也可以在此视图中将举报标记为已解决,并填写评论。如果该用户来自你的实例,你在此处输入的任何评论都会对创建举报的用户可见。
|
||
|
||
![待处理的举报的详细视图,显示被举报的贴文和举报理由。](../public/admin-settings-report-detail.png)
|
||
|
||
点击被举报账户的用户名会在“账户”视图中打开该账户,从而允许你对其执行管理操作。
|
||
|
||
### 账户
|
||
|
||
你可以使用此部分搜索账户并对其执行管理操作。
|
||
|
||
### 联合
|
||
|
||
![已封禁实例列表,有一个字段用于过滤/添加新的屏蔽。下面是批量导入/导出界面的链接](../public/admin-settings-federation.png)
|
||
|
||
在联合部分,你可以创建、删除和审核明确的域名屏蔽和域名允许。
|
||
|
||
关于联合设置的更多详细信息,特别是域名允许和域名屏蔽如何结合使用,请参阅 [联合模式部分](./federation_modes.md) 和 [域名屏蔽部分](./domain_blocks.md)。
|
||
|
||
#### 域名屏蔽
|
||
|
||
你可以在搜索字段中输入一个要封禁的域名,这将过滤列表以显示你是否已有该域名的屏蔽条目。
|
||
|
||
点击“封禁”会显示一个表单,允许你添加公开和/或私人评论,并提交以添加屏蔽。添加封禁后,该实例上的所有已知账户将被封禁,并阻止与该被屏蔽实例上的任何用户的新互动。
|
||
|
||
#### 域名允许
|
||
|
||
域名允许部分的工作方式与域名屏蔽部分类似,只是用于明确的域名允许而不是域名屏蔽。
|
||
|
||
#### 批量导入/导出
|
||
|
||
通过联合部分底部的链接(或访问 `/settings/admin/federation/import-export`),你可以批量导入/导出屏蔽列表和允许列表。
|
||
|
||
![导入中包含的域列表,提供选择某些或全部域的方法,更改其域,以及更新子域使用方法。](../public/admin-settings-federation-import-export.png)
|
||
|
||
通过输入字段或文件导入列表后,你可以在导入子集之前查看列表中的条目。你还会在使用子域的条目中收到警告,此处还提供一种轻松将其更改为主域的方法。
|
||
|
||
## 管理
|
||
|
||
实例管理设置。
|
||
|
||
### 操作
|
||
|
||
运行一次性管理操作。
|
||
|
||
#### 电子邮件
|
||
|
||
你可以使用此部分向指定的电子邮件地址发送测试邮件,并附加可选的测试信息。
|
||
|
||
#### 媒体
|
||
|
||
你可以使用此部分运行清理外站媒体缓存的操作,可以指定天数。超过指定天数的媒体将从存储中删除(s3 或本地)。以这种方式删除的媒体将未来需要时重新尝试获取。此操作在功能上与自动运行的媒体清理相同。
|
||
|
||
#### 密钥
|
||
|
||
你可以使用此部分使来自特定外站实例的公钥过期/失效。下次你的实例收到使用过期密钥的签名请求时,它将尝试重新获取和存储公钥。
|
||
|
||
### 自定义表情
|
||
|
||
包含在外站贴文中的自定义表情将自动获取,但要在你的帖子中使用它们,必须在你的实例上启用。
|
||
|
||
#### 本站
|
||
|
||
![本站自定义表情部分,显示按类别排序的自定义表情概览。有很多加菲猫表情。](../public/admin-settings-emoji-local.png)
|
||
|
||
此部分显示你的实例上启用的所有自定义表情的概览,按类别排序。点击某个表情可显示其详细信息,并提供更改类别或图像的选项,或完全删除它。这里无法更新短代码,你需要自己上传带有新短代码的表情(可以选择删除旧的表情)。
|
||
|
||
在概览下方,你可以在预览表情在贴文中的效果后上传自己的自定义表情。支持 PNG 和(动画)GIF 格式。
|
||
|
||
#### 外站
|
||
|
||
![外站自定义表情部分,显示从输入的贴文中解析的 3 个表情的列表: blobcat、blobfoxbox 和 blobhajmlem。可以选择它们,微调短代码,并在提交复制或删除操作前为其分配类别](../public/admin-settings-emoji-remote.png)
|
||
|
||
通过“外站”部分,你可以查找任何外站贴文的链接(前提是该实例未被封禁)。如果使用了任何自定义表情,它们将被列出,这样就提供了一种轻松复制到本站表情的方法(供你自己在贴文中使用),或者也可以禁止它们(从贴文中隐藏)。
|
||
|
||
**注意:**由于 testrig 服务器未进行联合,此功能在开发过程中无法使用(500:内部服务器错误)。
|
||
|
||
### 实例设置
|
||
|
||
![GoToSocial 管理面板的截图,显示了更改实例设置的字段](../public/admin-settings-instance.png)
|
||
|
||
在这里,你可以为你的实例设置各种元数据,如显示名称/标题、缩略图、(简短)描述和联系信息。
|
||
|
||
#### 实例外观
|
||
|
||
这些设置主要影响你的实例在网络和他人眼中的显示方式。
|
||
|
||
你的 **实例标题** 将显示在你实例每个网页的顶部,并在 OpenGraph 元标签中出现,所以选择一个能代表你实例氛围的名称。
|
||
|
||
**实例头像** 类似于你实例的吉祥物。它将出现在每个网页顶上的实例标题旁边,并作为浏览器标签、OpenGraph 链接等的预览图像。
|
||
|
||
如果你设置了实例头像,我们强烈建议同时设置 **头像描述**。这将为你设置为头像的图片提供替代文字,帮助屏幕阅读器用户理解图片中描绘的内容。替代文本应保持简短明了。
|
||
|
||
#### 实例描述
|
||
|
||
你可以使用这些字段设置实例的简短和完整描述,并为当前和潜在用户提供实例使用条款。
|
||
|
||
**简短描述** 将显示在实例主页的顶部附近,以及响应 `/api/v1/instance` 查询时显示。
|
||
|
||
可以提供一些精辟的内容,以便访问你的实例的访客对你的实例有一个第一印象。例如:
|
||
|
||
> 这是一个 ACG 爱好者的实例!
|
||
>
|
||
> 不管磕什么都可以来注册。
|
||
|
||
或者:
|
||
|
||
> 这是一个单用户实例,只属于我!
|
||
>
|
||
> 这是我的主页:@your_username
|
||
|
||
**完整描述** 将显示在你的实例的 /about 页面上,并在响应 `/api/v1/instance` 查询时显示。
|
||
|
||
你可以用它来提供如下信息:
|
||
|
||
- 你的实例的历史、理念、态度和氛围
|
||
- 你实例上的居民倾向于发布的内容类型
|
||
- 如何在你的实例上获得账户(如果可能的话)
|
||
- 一个拥有账户的用户列表,希望更容易被找到
|
||
|
||
**使用条款** 框也会出现在你的实例的 /about 页面上,并在响应 `/api/v1/instance` 查询时显示。
|
||
|
||
用它来填写如下内容:
|
||
|
||
- 法律术语(版权、GDPR 或相关链接)
|
||
- 联合政策
|
||
- 数据政策
|
||
- 账户删除/封禁政策
|
||
|
||
以上所有字段都接受 **markdown** 输入,因此你可以编写合适的列表、代码块、水平线、引用块或任何你喜欢的内容。
|
||
|
||
你也可以使用标准 `@user[@domain]` 格式提及账户。
|
||
|
||
查看 [markdown 速查表](https://markdownguide.offshoot.io/cheat-sheet/) 以了解可以做些什么。
|
||
|
||
### 实例联系信息
|
||
|
||
在此部分中,你可以向访问你实例的用户提供一种方便的方法,以联系你的实例管理员。
|
||
|
||
设置好的联系人账户和/或电子邮件地址的链接将出现在实例的每个网页底部、/about 页面的“联系”部分,以及响应 `/api/v1/instance` 查询时显示。
|
||
|
||
选择的 **联系人用户** 必须是实例上的活跃(未封禁)的管理员和/或站务。
|
||
|
||
如果你是在单用户实例上并将管理员权限授予你的主账户,你只需在此处填写自己的用户名即可;无需为此专门创建管理账户。
|