Question 1

为什么在Mastodon中禁用注册时，自定义注册消息不显示？

Accepted Answer

早期版本的Mastodon中存在一个bug，导致注册关闭时自定义注册消息不显示。该问题已由PR #39232修复。请将您的实例更新至最新版本：运行git pull并重启服务，或通过管理面板升级。更新后，当注册功能关闭时，在“关于”页面上将正确显示在管理 > 服务器设置 > 注册中设置的自定义消息。

Question 2

如何修复在运行 `tootctl media remove` 后 Mastodon 远程头像不再显示的问题？

Accepted Answer

这种情况发生在使用本地文件系统存储时：`RedownloadAvatarWorker` 下载远程头像，但目标缓存目录已不存在；该 worker 在写入之前不会创建该目录。直接使用 Paperclip 赋值则没有问题，因为它会自动创建目录。

作为一种临时解决方案，可以运行一个 Rails runner，根据 `avatar_remote_url` 重新赋值缺失的头像：

```bash
sudo -u mastodon RAILS_ENV=production bin/rails runner '
Account.where.not(domain: nil).where.not(avatar_remote_url: [nil, ""]).find_each do |account|
  next if account.avatar.exists?

tempfile = URI.open(account.avatar_remote_url, open_timeout: 5, read_timeout: 10)
  account.avatar = tempfile
  account.save!
rescue => e
  Rails.logger.warn("Avatar redownload failed for account ##{account.id}: #{e}")
end
'
```

在该 worker 被修复之前，可以使用 cron 定期调度此任务。永久的代码修复方案是让 `RedownloadAvatarWorker`（可能还有 `RedownloadHeaderWorker`）在保存下载的文件之前，先对目标目录调用 `FileUtils.mkdir_p`。该问题报告于使用本地存储的 Mastodon 4.4.16。

Question 3

如何修复在 Mastodon 中输入第一个选项时第二个投票选项消失的问题？

Accepted Answer

这是 Mastodon `4.6.0-alpha.8` 中的一个回归问题，由提交 `076c8ec` 引入。请更新到包含拉取请求 #39163 的构建版本，该拉取请求修复了投票创建问题。作为临时解决方案，请使用 `git revert 076c8ec` 回退有问题的提交，重新构建/重新部署 Mastodon，并重启 Web 服务。

Question 4

如何修复自定义 emoji 在 Mastodon 自动补全中缺失，但在 emoji 选择器中可见的问题？

Accepted Answer

这是 Mastodon 4.6.0-alpha.8 中的一个自动补全搜索 bug。请应用 issue #39125 中引用的修复，然后重新构建并重新部署 Mastodon；否则，请升级到包含该修复的版本。一位报告者确认，该补丁恢复了自定义 emoji 建议，例如 `:pikachuSurpreso:` 和 `:nkoHammer:`。

在 #39008 之后，部分标准 Unicode emoji 存在差异属于预期情况，因为自动补全和选择器暂时使用了不同的 shortcode 来源。例如，搜索 `:bust` 而不是 `:user` 即可找到 👤 和 👥。一致的选择器搜索计划在未来版本中实现。在此之前，对于自动补全中缺失的 emoji，请使用 emoji 选择器。

Question 5

如何使用 OAuth 在 Mastodon 客户端中实现基于 Web 的账户注册？

Accepted Answer

在安全 Web 视图中使用 OAuth 授权端点，并添加 prompt=create。不要收集密码并调用 POST /api/v1/accounts，而是打开：

https://server.example.com/oauth/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&scope=read+write+follow&prompt=create

使用操作系统提供的安全浏览器会话，例如 iOS 上的 ASWebAuthenticationSession 或 Android Custom Tabs。用户创建账户后，Mastodon 会返回授权流程，并携带授权 code 重定向到你的 OAuth 回调。像往常一样用 POST /oauth/token 交换它。

这将密码、passkey、密码管理器和年龄验证处理保留在服务器的 Web UI 中。需要服务器支持 prompt=create；旧服务器必须继续使用现有的 registration API。

Mastodon

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐