优质邀请

注意: 有关如何配置服务器系统以支持创建此类邀请的信息,请参阅我们的自托管部分。

本教程旨在根据 XEP-0401:Ad-hoc 账号邀请生成,概述如何为最常用的客户端 创建邀请。为了基本理解,必须知道邀请分为 两种类型

  • 用户邀请

    无需额外操作即可将他人添加到联系人中的快速便捷的方法。

  • 账号创建

    允许在您的服务器上注册新账号。

注意: 根据服务器配置,仍然可以使用 用户邀请创建新账号。同样,账号创建 邀请可以设置, 能创建 双向订阅。此外,后者允许您 预设 一个 账号名称。这是使用 用户邀请无法 实现的。

创建邀请后,您应该会收到一个 登陆页面 URL,您需要使用电子邮件、短信或任何其他数字通信方式第三方机制将其转发给其他人。某些应用甚至可能会显示一个二维码,如果对方就在附近,您可以直接向他们展示该二维码。通常,此类 URL 的格式如下:

1https://example.com/invites/0camZqFi19rfSlVD8C4IaUFo

在浏览器中打开后,您应该会看到类似下图所示的内容(设计因服务器而异):

在智能手机上查看的网页,显示您已收到联系邀请,并有一个大按钮,可以将某人添加到您的联系人列表。此外,网页上还显示了一系列可供安装的客户端。
用户邀请登陆页面
在智能手机上查看的网页,显示您已收到创建账号的邀请,并附带了入门操作说明。
账号创建登陆页面

根据服务器配置和客户端功能的不同,有时您可能只需要分享一个 XMPP URI。其格式如下:

1xmpp:inviter@example.com?roster;preauth=0camZqFi19rfSlVD8C4IaUFo;ibr=y

这些 URI 在接收方已安装 兼容的 XMPP 应用 且接收方的第三方应用支持这些时才有效。

提示: 我们在 joinjabber.org 上提供了一项服务,可以将此类 URI 转换为 登陆页面。这是一种更用户友好的分享邀请方式。此外,它还会在必要时推荐兼容的客户端供您安装。
注意: 最好让服务器管理员配置一个合适的登陆页面。我们的自托管部分提供了相关指南。
点击左下角进入 Gajim 的账号,然后导航到右上角的扩展选项,从下拉菜单中选择“执行命令”。
从账号标签页中选择“执行命令”。
可用命令对话框,您可以在其中选择“邀请用户”(用户邀请)或“创建账号”(账号创建)
可用命令列表,显示两种类型的邀请(取决于服务器配置)
显示“用户名”字段和“名册订阅”复选框的表单
填写账号创建表单,参数为选填项。
提交表单后,将弹出一个对话框,显示“邀请登陆页面 URL”、“邀请 URI”和“邀请令牌有效期至”等值。您可以选择这些值并将其提供给您的受邀者。
账号创建的结果显示了一个登陆页面和一个 XMPP URI。
在 Monal 的主窗口中,点击右上角的好友图标。
点按好友图标。
在 Monal 的联系人列表视图中,点击右上角的“添加联系人”图标。
点击“添加联系人”图标。
点击右上角相机图标左侧的分享按钮。屏幕上会显示一个二维码和一个“分享邀请链接”按钮。
点击分享按钮。
在主屏幕上点击右上角的二维码图标。
从主屏幕选择二维码图标。
从下拉菜单中选择最后一项,从上往下数第三个选项,标有“邀请加入服务器”。
从下拉菜单中选择“邀请加入服务器”。
会显示一个二维码,页面底部有一个分享按钮。
分享结果或显示二维码。
点击左上角的账号图标,点击下方设置图标,点击配置屏幕上的“操作”,选择“邀请用户”或“创建账号”。
从 Movim 的配置屏幕中选择邀请类型。
表单显示“用户名”字段和“名册订阅”切换开关。提交按钮位于右下角。
填写创建账号表单。
结果窗口显示“邀请登陆页面 URL”、“邀请 URI”和“邀请令牌有效期至”。
结果窗口显示登陆页面 URL 和 XMPP URI。
从 Profanity 的主窗口发送“/cmd list”。
发送 /cmd list 以获取可用命令的列表。
发送“/cmd exec urn:xmpp:invite#create-account”以接收一个 Ad-hoc 表单,其中字段 1 为“用户名”,字段 2 为“名册订阅”。说明中提到,可发送“/form submit”、“/form cancel”或“/form help”。
发送 /cmd exec urn:xmpp:invite#create-account 即可进入 Ad-hoc 表单。
发送“/form submit”以创建邀请。结果显示“邀请登陆页面 URL”(字段 1)、“邀请 URI”(字段 2)和“邀请令牌有效期至”(字段 3)。
发送 /form submit 即可进入结果屏幕,其中有登陆页面 URL 和 XMPP URI。

截至 2026 年 2 月,已知 不支持 此功能的常用客户端。请注意,这些客户端可能仍然 能够 处理 接收 此类 邀请

  • Dino
  • Kaidan
  • Beagle
  • Siskin
  • Snikket (iOS)