2024-11-05 13:36:43 +00:00
|
|
|
|
# 设置
|
|
|
|
|
|
|
|
|
|
|
|
GoToSocial 提供了一个设置界面,你可以在这里更新你的贴文和账户设置,添加头像和横幅背景图,为你的账户撰写简介等。
|
|
|
|
|
|
|
|
|
|
|
|
你可以通过访问自己 GoToSocial 实例的 `https://my-instance.example.com/settings` 来访问设置。设置面板同样使用 OAuth 机制进行身份验证。
|
|
|
|
|
|
|
|
|
|
|
|
在提供实例 URL 后,你会看到提示,要求你使用电子邮件地址和密码登录。
|
|
|
|
|
|
|
|
|
|
|
|
## 账户
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
在账户部分,你可以更改昵称、头像和横幅背景图。你还可以选择启用手动批准关注请求,并选择提供公开的贴文 RSS 源。
|
|
|
|
|
|
|
|
|
|
|
|
### 设置头像/横幅背景图
|
|
|
|
|
|
|
|
|
|
|
|
要设置头像或横幅背景图,请在相应部分点击 `浏览` 按钮,并使用文件浏览器选择图像。
|
|
|
|
|
|
|
|
|
|
|
|
当前支持的图像格式有 `gif`、`png`、`webp` 和 `jpeg`/`jpg`。
|
|
|
|
|
|
|
|
|
|
|
|
页面底部会显示图像在你的账户中的预览。如果你对选择满意,点击页面底部的 `保存账户信息` 按钮。
|
|
|
|
|
|
|
|
|
|
|
|
如果你转到自己的账户页并刷新页面,页面将会显示新的头像/横幅背景图。这个更新可能需要一些时间才能传播到其他外站实例。
|
|
|
|
|
|
|
|
|
|
|
|
### 选择主题
|
|
|
|
|
|
|
|
|
|
|
|
GoToSocial 提供主题供你选择,以更改账户的外观和氛围。
|
|
|
|
|
|
|
|
|
|
|
|
要选择主题,只需在账户设置页面中选择,然后点击页面底部的 `保存账户信息`。用浏览器查看账户页(可能需要刷新页面),你会看到新主题已被应用,访问你账户的其他人也会看到。
|
|
|
|
|
|
|
|
|
|
|
|
!!! tip "添加更多主题"
|
|
|
|
|
|
实例管理员可以通过将 CSS 文件放入 `web/assets/themes` 文件夹中来添加更多主题。有关详细信息,请参阅管理员文档中的[主题](../admin/themes.md)部分。
|
|
|
|
|
|
|
2025-05-03 09:28:16 +00:00
|
|
|
|
### 选择布局
|
|
|
|
|
|
|
|
|
|
|
|
使用 GoToSocial,你可以为你的账户页的网页视图选择两种不同的布局。
|
|
|
|
|
|
|
|
|
|
|
|
这个设置不会影响 API 的行为,也不会影响客户端应用的外观或工作方式,它纯粹是网页视图的一个外观上的改变。
|
|
|
|
|
|
|
|
|
|
|
|
这两种布局都只会显示顶层贴文(或顶层贴文中的媒体),不显示回复或转发,并且会遵守[在你的账户页上显示的贴文的可见性级别](#visibility-level-of-posts-to-show-on-your-profile)设置。
|
|
|
|
|
|
|
|
|
|
|
|
#### 微博
|
|
|
|
|
|
|
|
|
|
|
|
GtS 经典的微博客布局。你的账户页被分成两列,显示你的简介和最近/置顶的贴文。
|
|
|
|
|
|
|
|
|
|
|
|
如果你主要发布文字,或者文字与媒体的混合内容,这是一个不错的选择。
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
#### 画廊
|
|
|
|
|
|
|
|
|
|
|
|
类似 Instagram 的布局。贴文不会在你的账户页上直接显示,反之,你最近/置顶的媒体会以画廊网格视图的形式显示。贴文(及其回复)仍然可以通过链接访问。
|
|
|
|
|
|
|
|
|
|
|
|
如果你主要发布媒体,这是一个不错的选择。
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
2024-11-05 13:36:43 +00:00
|
|
|
|
### 基本信息
|
|
|
|
|
|
|
|
|
|
|
|
#### 昵称
|
|
|
|
|
|
|
|
|
|
|
|
昵称是与你的用户名一起显示在账户上的简短标识。
|
|
|
|
|
|
|
|
|
|
|
|
尽管创建后无法更改用户名,但昵称可以更改。
|
|
|
|
|
|
|
|
|
|
|
|
昵称可以包含空格、大写字母、表情符号等。
|
|
|
|
|
|
|
|
|
|
|
|
这是放网名或全名的好地方。例如,如果你的用户名是 `@miranda`,昵称可以是 `Miranda Priestly`。
|
|
|
|
|
|
|
|
|
|
|
|
#### 简介
|
|
|
|
|
|
|
|
|
|
|
|
你的简介是介绍你的账户和自己的较长文本。适合用于:
|
|
|
|
|
|
|
|
|
|
|
|
- 提示你贴文的内容。
|
|
|
|
|
|
- 提及大致年龄/位置。
|
|
|
|
|
|
- 链接到你的其他账户或账户。
|
|
|
|
|
|
- 说明与他人互动时的边界和偏好。
|
|
|
|
|
|
- 链接你经常使用的标签。
|
|
|
|
|
|
|
|
|
|
|
|
简介支持 `纯文本` 或 `markdown` 格式。默认贴文格式设置如[贴文设置](#贴文设置)中所述。
|
|
|
|
|
|
|
|
|
|
|
|
#### 资料字段
|
|
|
|
|
|
|
|
|
|
|
|
资料字段是一系列名称/值对,将显示在账户上,并传播到其他外站实例。
|
|
|
|
|
|
|
|
|
|
|
|
此处适合放置的信息包括:
|
|
|
|
|
|
|
|
|
|
|
|
- 你的网站链接
|
|
|
|
|
|
- 众筹/捐助页面的链接
|
|
|
|
|
|
- 你的年龄
|
|
|
|
|
|
- 人称代词
|
|
|
|
|
|
|
|
|
|
|
|
一些示例:
|
|
|
|
|
|
|
|
|
|
|
|
- 别名:汉德尔·沃尔特
|
|
|
|
|
|
- 我的网站:https://example.org
|
|
|
|
|
|
- 年龄:99
|
|
|
|
|
|
- 代词:she/her/她
|
|
|
|
|
|
- 我的其他账户:@someone@somewhere.com
|
|
|
|
|
|
|
|
|
|
|
|
### 可见性和隐私
|
|
|
|
|
|
|
|
|
|
|
|
#### 个人资料上显示的贴文可见性级别
|
|
|
|
|
|
|
|
|
|
|
|
使用此下拉菜单,你可以选择在你的网页版账户页、贴文以及 RSS 源(如果你已启用 RSS)上显示的贴文可见性级别。
|
|
|
|
|
|
|
|
|
|
|
|
**默认情况下,GoToSocial 仅在网页版账户页上显示公开可见的贴文,而不显示不列出的贴文。** 你可以调整此设置,以显示不列出的贴文,这类似于其他 ActivityPub 软件如 Mastodon 的默认设置。
|
|
|
|
|
|
|
|
|
|
|
|
你还可以选择在 GoToSocial 的网页视图上完全不显示任何贴文。这样,你可以安心发表贴文,而无需担心有人通过网页浏览你的个人资料并查看你的贴文。
|
|
|
|
|
|
|
|
|
|
|
|
此设置仅适用于你自己的贴文的可见性。其他用户的“不列出”贴文永远不会显示。
|
|
|
|
|
|
|
|
|
|
|
|
此设置不会影响你的贴文在 ActivityPub 协议和客户端中的可见性,因此即便你选择不在网页版账户页显示任何贴文,只要他人是你的粉丝、你的贴文被转发到他们的时间线,或使用链接搜索你的某个贴文,他们仍然可以看到的贴文。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! warning "警告"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
请注意,此设置的更改也会应用于之前的贴文。
|
|
|
|
|
|
|
|
|
|
|
|
也就是说,如果你之前发布了一条“不列出”可见性的贴文,而当时你的网页版账户页被设置为仅显示公开贴文,此时如果你更改此设置为一并显示公开和不列出,那你之前发布的“不列出”贴文将会与公开贴文一起显示在你的网页版账户页上。
|
|
|
|
|
|
|
|
|
|
|
|
同样地,如果你选择不显示任何贴文,那么所有贴文将从你的网页版账户页中隐藏,无论它们是在何时创建,也无论当时此选项被设置为什么。这种情况将持续直到你再次更改此设置。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! tip "提示"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
结合(域名)屏蔽,如果有人通过公开贴文骚扰你,这是一种很好的“紧急”设置。虽然它不会阻止在 ActivityPub 客户端中可以看到你的贴文的人,但至少会防止他们无需身份验证就通过浏览器点击查看你的贴文,并通过 URL 轻松与他人分享。
|
|
|
|
|
|
|
|
|
|
|
|
#### 手动批准关注请求(即锁定帐户)
|
|
|
|
|
|
|
|
|
|
|
|
此复选框允许你决定是否希望手动审核账户的关注请求。
|
|
|
|
|
|
|
|
|
|
|
|
当此选项**未勾选**时,新关注请求会被自动批准,无需你的干预。对于更面向公众的账户或不怎么发布敏感信息的情况而言,这很有用。
|
|
|
|
|
|
|
|
|
|
|
|
当其**已勾选**时,你必须手动批准新关注请求,并可以拒绝你不想被关注的账号的关注请求。这对仅向粉丝发布私人内容的私人账户很有用。
|
|
|
|
|
|
|
|
|
|
|
|
在联邦宇宙中,一般将此选项称为“锁定”账户。
|
|
|
|
|
|
|
|
|
|
|
|
勾选或取消勾选复选框后,务必点击底部的 `保存账户信息` 按钮以保存新设置。
|
|
|
|
|
|
|
|
|
|
|
|
#### 将账户标记为可被搜索引擎和目录发现
|
|
|
|
|
|
|
|
|
|
|
|
此设置用于更新账户上的“可发现”标记。
|
|
|
|
|
|
|
|
|
|
|
|
选中账户的可发现性框可执行以下操作:
|
|
|
|
|
|
|
|
|
|
|
|
- 更新账户的 robots 元信息标记,允许其被搜索引擎索引并出现在搜索引擎结果中。
|
|
|
|
|
|
- 向外站指示账户可包含在公共目录和索引中。
|
|
|
|
|
|
|
|
|
|
|
|
将可发现性标记打开可能需要一周或更长时间才会生效,账户不会立即出现在搜索引擎结果中。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! tip "提示"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
为了避免暴露给爬虫,新帐户的可发现性默认为 false。但对于希望被抓取的面向公众的帐户,将其设置为 true 是有用的。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! info "附注"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
可发现性设置是关于**账户的可发现性**,而不是贴文的可被搜索性。这与 Mastodon 实例或其他使用全文搜索的实例的贴文索引无关!
|
|
|
|
|
|
|
|
|
|
|
|
#### 启用公开贴文的 RSS 源
|
|
|
|
|
|
|
|
|
|
|
|
用户的 RSS 源默认情况下是禁用的,但可以通过此复选框选择。有关更多信息,请参阅 [RSS](./rss.md)。
|
|
|
|
|
|
|
|
|
|
|
|
此源仅包括设置为“公开”的贴文(参见 [隐私设置](./posts.md#隐私设置))。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! warning "警告"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
公开您的 RSS 源允许*任何人*匿名订阅您公开贴文的更新,绕过关注和关注请求。
|
|
|
|
|
|
|
|
|
|
|
|
#### 隐藏你关注/被关注的人
|
|
|
|
|
|
|
|
|
|
|
|
默认情况下,GoToSocial 会在你的公开网络资料上显示你的关注/粉丝数量,并允许其他人查看你关注的和关注你的人。这对于账户发现可能很有用。然而,出于隐私和安全原因,你可能希望隐藏这些信息,并隐藏其他账户的关注/粉丝清单。你可以通过勾选此框来做到这一点。
|
|
|
|
|
|
|
|
|
|
|
|
勾选此框后,你的关注/粉丝数量将从你的公开网络资料中隐藏,其他人将无法浏览你的关注/粉丝清单。
|
|
|
|
|
|
|
|
|
|
|
|
### 进阶
|
|
|
|
|
|
|
|
|
|
|
|
#### 自定义 CSS
|
|
|
|
|
|
|
|
|
|
|
|
如果实例管理员允许,自定义 CSS 可以让你进一步自定义账户在浏览器中的外观。
|
|
|
|
|
|
|
|
|
|
|
|
如果此设置未被实例管理员启用,文本输入框将为只读状态,自定义 CSS 将不会应用。
|
|
|
|
|
|
|
|
|
|
|
|
请参阅 [自定义 CSS](./custom_css.md) 页面,了解有关为账户编写自定义 CSS 的一些提示。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! tip "提示"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
你在此框中添加的任何自定义 CSS 都将在*选择主题之后*应用,因此你可以选择一个喜欢的预设主题,然后进行自己的调整!
|
|
|
|
|
|
|
|
|
|
|
|
## 贴文
|
|
|
|
|
|
|
|
|
|
|
|
### 贴文设置
|
|
|
|
|
|
|
|
|
|
|
|
默认贴文语言设置允许你向其他用户声明你的贴文通常使用哪种语言。这对说其它语言(例如韩语)并希望过滤掉其他语言的贴文的用户很有帮助。
|
|
|
|
|
|
|
|
|
|
|
|
默认贴文可见性设置允许你设置新贴文的默认可见性。当你通常发布公开或只对粉丝可见的贴文,但不想每次发贴时都设置隐私时会很有用。请记住,这只是默认设置:无论你在此处设置什么,仍然可以根据需要单独设置新贴文的隐私。有关贴文隐私设置的更多信息,请参阅[贴文页面](./posts.md)。
|
|
|
|
|
|
|
|
|
|
|
|
默认贴文格式设置允许你选择在解析贴文时使用哪个文本解释器。
|
|
|
|
|
|
|
|
|
|
|
|
plain(默认)设置提供标准贴文格式,类似于许多其他联邦宇宙服务端使用的格式。这非常适合一般目的的发布:你可以写简短的推特风格的贴文,或多段文章,插入链接,并使用用户名提及其他账户。
|
|
|
|
|
|
|
|
|
|
|
|
markdown 设置表示你的贴文应被按 Markdown 格式解析,这是一种标记语言,提供更多选项来自定义贴文的布局和外观。有关 plain 和 markdown 贴文格式之间差异的更多信息,请参阅 [贴文页面](posts.md)。
|
|
|
|
|
|
|
|
|
|
|
|
更新贴文设置后,请记得点击该部分底部的 `保存设置` 按钮以保存更改。
|
|
|
|
|
|
|
|
|
|
|
|
### 默认互动规则
|
|
|
|
|
|
|
|
|
|
|
|
通过此部分,你可以为新贴文设置每个可见级别的默认互动规则。这允许你精确控制他人如何与你的贴文互动。
|
|
|
|
|
|
|
|
|
|
|
|
这使你能够做以下事情:
|
|
|
|
|
|
|
|
|
|
|
|
- 创建只有你自己可以互动的贴文。
|
|
|
|
|
|
- 创建仅粉丝/你关注的人可以互动的贴文。
|
|
|
|
|
|
- 创建任何人都可以点赞或转发,但只有特定人可以回复的贴文。
|
|
|
|
|
|
- 等等。
|
|
|
|
|
|
|
|
|
|
|
|
例如,下图显示了一个公开可见性贴文的默认互动规则,允许任何人点赞或转发,但仅允许粉丝和你关注的人回复。
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
请记住,互动规则不具备前向可追溯性。应用默认互动规则之后创建的贴文将默认使用新设置的规则,但在此之前创建的任何贴文将使用创建时的默认规则。
|
|
|
|
|
|
|
|
|
|
|
|
无论在贴文上设置了什么规则,首先被考虑的仍是可见性设置和账户屏蔽情况。例如,如果你将某种类型的互动范围设置为“任何人”,这仍然会排除你屏蔽的账户,或你实例屏蔽的域名域下的账户。“任何人”在这种情况下基本上意味着“任何通常能看到贴文的人”。
|
|
|
|
|
|
|
|
|
|
|
|
最后,请注意,无论为贴文设置了什么规则,贴文中提到的任何账户将**始终**能够回复该贴文。
|
|
|
|
|
|
|
|
|
|
|
|
更新互动规则设置后,请记得点击该部分底部的 `保存规则` 按钮以保存更改。
|
|
|
|
|
|
|
|
|
|
|
|
如果你想将所有规则重置为初始默认值,可以点击 `重置为默认值` 按钮。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! danger "危险"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
虽然 GoToSocial 尊重互动规则,但不能保证其他服务端软件也会这样做,即使你的实例禁止某些互动,其他服务器上的账户可能仍会向其粉丝发送(被禁止的)贴文回复和转发。
|
|
|
|
|
|
|
|
|
|
|
|
随着更多 ActivityPub 服务端推出互动规则支持,这个问题有望减少,但在此期间,GoToSocial 只能在“尽力而为”范围内进行尝试,以根据你设定的规则限制与贴文的互动。
|
|
|
|
|
|
|
2025-05-03 09:28:16 +00:00
|
|
|
|
## 账户
|
|
|
|
|
|
|
|
|
|
|
|
在账户部分,你可以设置你的电子邮箱和密码,以及为你的账户设置双因素验证。
|
2024-11-05 13:36:43 +00:00
|
|
|
|
|
|
|
|
|
|
### 更改电子邮箱
|
|
|
|
|
|
|
|
|
|
|
|
你可以使用面板的更改电子邮箱部分更改账户的电子邮箱地址。出于安全原因,你必须提供当前密码以验证更改。
|
|
|
|
|
|
|
|
|
|
|
|
输入新电子邮箱地址,并点击“更改电子邮箱地址”后,必须打开新电子邮件地址的收件箱,并通过提供的链接确认地址。完成后,你的电子邮箱地址更改将被确认。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! info "附注"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
如果你的实例使用 OIDC 作为授权/身份提供商,你可以通过设置面板更改电子邮箱地址,但只会影响 GoToSocial 用于联系你的电子邮箱地址,而不会更改用于登录账户的电子邮箱地址。要更改此项,应联系你的 OIDC 提供商。
|
|
|
|
|
|
|
|
|
|
|
|
### 更改密码
|
|
|
|
|
|
|
|
|
|
|
|
你可以使用面板的更改密码部分为账户设置新密码。出于安全原因,你必须提供当前密码以验证更改。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! info "附注"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
如果你的实例使用 OIDC 作为授权/身份提供商,你将无法通过 GoToSocial 设置面板更改密码,此时应联系你的 OIDC 提供商。
|
|
|
|
|
|
|
|
|
|
|
|
有关 GoToSocial 如何管理密码的更多信息,请参阅[密码管理文档](./password_management.md)。
|
|
|
|
|
|
|
2025-05-03 09:28:16 +00:00
|
|
|
|
### 双因素身份验证
|
|
|
|
|
|
|
|
|
|
|
|
你可以使用面板的这一部分为你的账户启用双因素身份验证。
|
|
|
|
|
|
|
|
|
|
|
|
启用双因素身份验证后,除密码外,你还必须在登录时提供一个来自你配置的验证器应用(Google 验证器、LastPass 验证器等)的代码。
|
|
|
|
|
|
|
|
|
|
|
|
要启用双因素身份验证,请在移动设备上安装一个验证器应用,然后用它扫描二维码。你也可以手动复制双因素验证密钥并将其粘贴到验证器中。完成后,输入验证器中的代码,验证验证器和服务器是否正确同步。
|
|
|
|
|
|
|
|
|
|
|
|
成功后,你将看到一个包含八个双因素验证备份/恢复代码的列表。将这些代码保存在安全的地方(如密码管理器)。如果你失去了对身份验证程序的访问权限,例如丢失了设备,那么可以在登录时使用这些代码之一来代替 2FA 代码。这些代码使用后将无法再次使用。如果你用完了全部八个恢复代码,你应该禁用并重新启用 2FA,以生成新的密码。
|
|
|
|
|
|
|
|
|
|
|
|
要禁用双因素验证,请在表单中输入当前密码,然后点击 "禁用 2FA "按钮。
|
|
|
|
|
|
|
|
|
|
|
|
!!! tip "提示"
|
|
|
|
|
|
建议使用双因素身份验证,因为它可以增加坏人通过猜测密码登录账户的难度,因为他们还需要访问你的身份验证设备。有关不同类型 2FA 的更多信息,请参阅 [互联网常见双因素验证类型指南](https://www.eff.org/deeplinks/2017/09/guide-common-types-two-factor-authentication-web)。
|
|
|
|
|
|
|
|
|
|
|
|
!!! info "注意"
|
|
|
|
|
|
如果你的实例使用 OIDC 作为授权/身份提供商,则无法在设置面板中启用 2FA,此时应联系 OIDC 提供商管理双因素身份验证。
|
|
|
|
|
|
|
2024-11-05 13:36:43 +00:00
|
|
|
|
## 迁移
|
|
|
|
|
|
|
|
|
|
|
|
在迁移部分,你可以管理与与账户别名、迁移到其他账户或从其他账户迁移相关的设置。
|
|
|
|
|
|
|
|
|
|
|
|
有关移动账户的更多信息,请参阅[迁移文档](./migration.md)。
|
|
|
|
|
|
|
|
|
|
|
|
## 导出和导入
|
|
|
|
|
|
|
|
|
|
|
|
在导出和导入部分,你可以从 GoToSocial 账户导出数据或将数据导入账户。
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
### 导出
|
|
|
|
|
|
|
|
|
|
|
|
要导出你的关注、粉丝、账户列表、账户屏蔽列表或账户静音列表,你可以使用此页面上的按钮。
|
|
|
|
|
|
|
|
|
|
|
|
所有导出都将以 Mastodon 导出格式兼容的 CSV 格式提供,因此如果有需要,可以将其导入 Mastodon 或另一个 GoToSocial 实例。
|
|
|
|
|
|
|
|
|
|
|
|
### 导入
|
|
|
|
|
|
|
|
|
|
|
|
你可以使用导入部分,将其他账户的数据导入到 GoToSocial 账户中,使用从其他账户导出的 CSV 文件。
|
|
|
|
|
|
|
|
|
|
|
|
这在你已将账户[迁移](./migration.md)到 GoToSocial 账户,并希望保留在以前的账户上的关注列表和屏蔽列表时很有用。
|
|
|
|
|
|
|
|
|
|
|
|
要将数据导入账户,首先点击“浏览”并选择从 Mastodon 或其他兼容实例导出的与 Mastodon 导出格式兼容的 CSV 文件。
|
|
|
|
|
|
|
|
|
|
|
|
然后,使用下拉菜单选择通过 CSV 文件上传的数据类型。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! warning "警告"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
在选择“类型”时要小心,否则可能会意外封禁你计划关注的一堆账户,反之亦然!
|
|
|
|
|
|
|
|
|
|
|
|
然后,选择是要**合并**新数据到 GoToSocial 账户中该类型的现有数据,还是要用 CSV 文件中包含的数据**覆盖**现有数据。
|
|
|
|
|
|
|
|
|
|
|
|
如果选择**合并**,则 CSV 文件中包含的任何数据都将添加到现有数据中,而不会删除任何现有数据。
|
|
|
|
|
|
|
|
|
|
|
|
例如,如果你的 GoToSocial 账户关注 `account1` 和 `account2`,并且正在上传一个包含 `account3` 和 `account4` 的关注 CSV 文件,并使用模式 **合并**,那么在导入结束时,你将关注 `account1`、`account2`、`account3` 和 `account4`。
|
|
|
|
|
|
|
|
|
|
|
|
如果选择**覆盖**,则 CSV 文件中包含的任何数据将*替换*现有数据,删除 CSV 文件中未包含的条目。
|
|
|
|
|
|
|
|
|
|
|
|
例如,如果你的 GoToSocial 账户关注 `account1` 和 `account2`,并上传一个包含 `account3` 和 `account4` 的关注 CSV 文件,并使用模式 **覆盖**,那么导入结束时,你将关注 `account3` 和 `account4`。你对 `account1` 和 `account2` 的关注将被移除。
|
|
|
|
|
|
|
|
|
|
|
|
合并和覆盖操作都是幂等的,这通常意味着现有数据和 CSV 文件中的重复条目不会产生问题,如果需要重试导入,可以多次导入相同的数据。
|
|
|
|
|
|
|
2025-02-09 18:13:08 +08:00
|
|
|
|
!!! info "附注"
|
2024-11-05 13:36:43 +00:00
|
|
|
|
由于各种原因,通过导入不可能一定会重新创建上传的 CSV 文件中的每个条目。例如,假设你试图导入包含 `example_account` 的关注 CSV,但 `example_account` 的实例已下线,或者它们的实例封禁了你的实例,或你的实例封禁了它们的实例等。在这种情况下,将无法创建对 `example_account` 的关注。
|
2025-03-10 09:24:37 +00:00
|
|
|
|
|
|
|
|
|
|
!!! warning "警告"
|
|
|
|
|
|
CSV 格式的隐藏列表数据不包含失效日期,因此临时隐藏在导出(和导入)时会被视为永久隐藏。
|
|
|
|
|
|
|
|
|
|
|
|
## 访问令牌
|
|
|
|
|
|
|
|
|
|
|
|
在访问令牌部分,你可以查看和撤销被你授权访问你的账户和/或代表你执行操作的应用所拥有的 [OAuth 访问令牌](https://www.oauth.com/oauth2-servers/access-tokens/)。
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
如果你曾多次使用同一应用登录,或者在多个设备或浏览器中登录,你可能会看到多个具有相同应用名称的令牌。这是正常现象!例如,假设你使用 Pinafore 分别在手机和笔记本电脑浏览器上登录,你可能会看到两个由 Pinafore 所拥有的不同令牌。
|
|
|
|
|
|
|
|
|
|
|
|
你可以点击某个令牌下方的“使令牌失效”按钮来使该令牌失效。这会将该令牌从数据库中移除。使用该令牌访问你账户的应用随后将不再被授权访问相关信息,因此你需要重新注销和/或重新使用该应用进行登录。
|
|
|
|
|
|
|
|
|
|
|
|
退出某个应用并不一定会将令牌从 GoToSocial 数据库中移除,所以之前很久使用过的应用可能遗留有旧令牌。因此,建议经常检查和撤销那些从未使用过或长时间未使用的令牌;这是一个良好的安全惯例——只保留你需要的令牌,而且点击那个大红按钮也很有趣。
|
|
|
|
|
|
|
|
|
|
|
|
!!! danger "风险提示"
|
|
|
|
|
|
|
|
|
|
|
|
如果你发现了任何来自于你不认识或不记得曾授权过的应用的令牌,请撤销它们,并考虑尽快更改您的密码。
|
|
|
|
|
|
|
|
|
|
|
|
!!! note "附注"
|
|
|
|
|
|
|
|
|
|
|
|
令牌的“最后使用”时间是近似值,可能存在正负一小时的误差。
|
2025-05-03 09:28:16 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 应用
|
|
|
|
|
|
|
|
|
|
|
|
在“应用”部分,您可以新建托管的 OAuth 客户端应用,并搜索你已创建的应用。
|
|
|
|
|
|
|
|
|
|
|
|
### 什么是 OAuth 客户端应用?
|
|
|
|
|
|
|
|
|
|
|
|
GoToSocial OAuth 客户端应用等同于 [Auth0 身份组文档](https://auth0.com/intro-to-iam/what-is-oauth-2#oauth20-roles) 中描述的 OAuth 2.0 客户端。
|
|
|
|
|
|
|
|
|
|
|
|
创建一个应用后,你可以作为你账户的“资源所有者”,通过访问令牌授予该应用访问你账户的权限。应用可以使用此令牌,以“你的身份”或“代表你”与 GoToSocial 客户端 API 进行交互。
|
|
|
|
|
|
|
|
|
|
|
|
例如,当使用 Tusky 登录你的 GoToSocial 账户时,Tusky 首先在你的实例作为一个 OAuth 客户端应用注册,然后请求实例将你重定向到一个页面。在该页面,你可以使用你的 GoToSocial 邮箱地址和密码登录,以授权 Tusky 获取访问令牌。随后,Tusky 存储并在所有后续请求中使用该访问令牌,来执行你指示的操作:发布贴文、读取时间线等。
|
|
|
|
|
|
|
|
|
|
|
|
OAuth 客户端应用的优势在于它们从不存储(甚至看不到)你的密码:它们仅使用访问令牌以你的身份执行操作。该令牌可以被撤销,这样应用就无法再访问你的账户,而你无需更改密码(请参阅 [访问令牌](#访问令牌))。
|
|
|
|
|
|
|
|
|
|
|
|
!!! note "托管应用程序 vs 非托管应用程序"
|
|
|
|
|
|
*托管* 应用程序是你通过设置面板自行创建的应用程序,你有权为其请求令牌和删除它。这与像 Tusky 这样的应用程序有所不同,后者不被视为 *托管* 应用程序,因为它们不是由用户在设置面板中创建的。
|
|
|
|
|
|
|
|
|
|
|
|
### 什么是重定向 URI?
|
|
|
|
|
|
|
|
|
|
|
|
重定向 URI 提供了一种安全措施,可防止应用程序在授权后重定向到恶意地址。OAuth 2.0 文档对此有最好的解释,请参阅:
|
|
|
|
|
|
|
|
|
|
|
|
- [重定向 URI](https://www.oauth.com/oauth2-servers/redirect-uris/)
|
|
|
|
|
|
- [重定向 URL 注册](https://www.oauth.com/oauth2-servers/redirect-uris/redirect-uri-registration/)
|
|
|
|
|
|
|
|
|
|
|
|
任何需要你为之创建 OAuth 应用的服务通常会告知你,在创建应用时需要输入哪些重定向 URI。
|
|
|
|
|
|
|
|
|
|
|
|
### 什么是范围?
|
|
|
|
|
|
|
|
|
|
|
|
范围是一个以空格分隔的标识符列表,可以在创建应用(或为其获取令牌)时指定,以防止应用或其访问令牌访问超出其工作所需的数据。
|
|
|
|
|
|
|
|
|
|
|
|
例如,如果你创建一个仅具有 `read` 范围的应用,那么该应用拥有的任何令牌将仅对你的账户具有 `read` 访问权限:它们将无法以你的身份执行发布、删除或其他 *写入* 类型的操作。
|
|
|
|
|
|
|
|
|
|
|
|
GoToSocial 提供了一系列与 Mastodon API 非常相似的范围。您可以在这里查看范围列表(及其作用):https://docs.gotosocial.org/zh-cn/latest/api/swagger/。
|
|
|
|
|
|
|
|
|
|
|
|
与 Mastodon 类似,GoToSocial 允许你在创建应用 *以及* 随后请求令牌时指定范围。因此,你可以创建一个具有 `read write` 范围的应用,但请求一个仅具有 `read` 范围的令牌,或者请求一个更小的范围,如 `read:accounts`。请求令牌时指定的任何范围都必须被应用所被允许的范围所覆盖。例如,如果您的应用只有 `read` 范围,您就不能请求具有 `write` 范围的令牌。
|
|
|
|
|
|
|
|
|
|
|
|
有关范围的更多一般信息,请参阅 OAuth 2.0 文档:
|
|
|
|
|
|
|
|
|
|
|
|
- [范围](https://www.oauth.com/oauth2-servers/scope/)
|
|
|
|
|
|
- [定义范围](https://www.oauth.com/oauth2-servers/scope/defining-scopes/)
|
|
|
|
|
|
|
|
|
|
|
|
### 搜索应用程序
|
|
|
|
|
|
|
|
|
|
|
|
使用此部分,你可以查看通过设置面板创建的应用程序的概览,并单击某个应用程序以进入该应用程序的详情视图。
|
|
|
|
|
|
|
|
|
|
|
|
### 新建应用程序
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
要创建一个新的托管 OAuth 应用,你必须至少提供应用的名称。如果需要,也可以提供网站地址。
|
|
|
|
|
|
|
|
|
|
|
|
如果你不提供任何范围,则应用将默认具有 `read` 范围。
|
|
|
|
|
|
|
|
|
|
|
|
如果你不指定任何重定向 URI,则应用将默认使用非常规重定向 URI `urn:ietf:wg:oauth:2.0:oob`。
|
|
|
|
|
|
|
|
|
|
|
|
如果你希望使用设置面板轻松地为你的应用获取访问令牌,那么你必须在重定向 URI 列表中包含给定的设置面板回调 URL。其格式为 `https://[your_instance_host]/settings/user/applications/callback`。
|
|
|
|
|
|
|
|
|
|
|
|
### 应用程序详情
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
在应用的详情页面上,你可以查看应用的客户端 ID 和客户端密钥,你可以在像 `curl` 这样的命令行工具中使用它们来手动获取该应用的授权码和访问令牌。
|
|
|
|
|
|
|
|
|
|
|
|
如果你在重定向 URI 列表中包含了设置面板回调 URL,你也可以使用此页面为你的账户请求访问令牌。这将把你重定向到你实例的登录页面,你必须在该页面提供你的凭据以授权你的应用。然后你将再次被重定向到设置面板回调 URL,在那里你可以接收你的访问令牌。
|
|
|
|
|
|
|
|
|
|
|
|
你也可以使用此页面删除你的应用。当托管应用被删除时,所有通过该应用创建的令牌也将被删除,因此请确保仅在你的应用未使用时才执行此操作。
|