8.0 KiB
常见问题解答
Q: 在 Docker 中运行时，服务器日志在哪里？
A: 日志在容器内的 /var/log/tinode.log。使用以下命令附加到运行中的容器：
docker exec -it name-of-the-running-container /bin/bash
然后，例如用 tail -50 /var/log/tinode.log 查看日志。
如果容器已停止，可以从容器复制日志（保存到 ./tinode.log）：
docker cp name-of-the-container:/var/log/tinode.log ./tinode.log
或者，可以通过将主机目录映射到容器内的 /var/log/，让 Docker 容器将日志保存到主机目录。在 docker run 命令中添加 -v /where/to/save/logs:/var/log。
Q: 启用推送通知有哪些选项？
A: 可以使用 Tinode Push Gateway (TNPG) 或 Google FCM：
- Tinode Push Gateway 使用 Tinode 服务器代您发送推送。需要最少的设置：您的服务器向 TNPG 发送请求，TNPG 转发给 Google FCM 或 Apple APNS。
- Google FCM 不依赖 Tinode 基础设施推送，但需要您构建和发布自己的移动应用（iOS 和 Android）。
Q: 如何使用 Tinode Push Gateway 设置推送通知？
A: 启用 TNPG 推送通知需要两步：
- 在 console.tinode.co 注册并获取 TNPG 令牌。
- 使用令牌配置服务器。 详见此处。
Q: 如何使用 Google FCM 设置推送通知？
A: 此选项需要您构建和发布自己的移动应用。如果您不想这样做，请使用上面的 TNPG 选项。
启用 FCM 推送通知需要以下步骤：
- 启用服务器端推送发送。
- 启用客户端推送接收。
服务器和 TinodeWeb
- 如尚未创建，请在 https://firebase.google.com/ 创建项目。
- 按照 https://cloud.google.com/iam/docs/creating-managing-service-account-keys 的说明下载凭据文件。
- 更新服务器配置
tinode.conf，在"push"->"name": "fcm"部分。执行以下任一操作：
- 将下载的凭据文件路径填入
"credentials_file"。 - 或将文件内容复制到
"credentials"。
删除另一个条目。例如，如果更新了"credentials_file"，则删除"credentials"，反之亦然。
- 更新 TinodeWeb 配置
firebase-init.js：更新apiKey、messagingSenderId、projectId、appId、messagingVapidKey。详见 https://github.com/tinode/webapp/#push_notifications
iOS 和 Android
- 如果使用 Android 客户端，按照 https://developers.google.com/android/guides/google-services-plugin 的说明将
google-services.json添加到 Tindroid 并重新编译客户端。您也可以选择提交到 Google Play Store。 详见 https://github.com/tinode/tindroid/#push_notifications - 如果使用 iOS 客户端，按照 https://firebase.google.com/docs/cloud-messaging/ios/client 的说明将
GoogleService-Info.plist添加到 Tinodios 并重新编译客户端。您也可以选择提交到 Apple AppStore。 详见 https://github.com/tinode/ios/#push_notifications
Q: 如何添加新用户？
A: 创建账户有三种方式：
- 用户可以使用应用程序（Web、Android、iOS）创建新账户。
- 可以使用 tn-cli 创建新账户（
acc命令或useradd宏）。该过程可脚本化。 - 如果用户已存在于外部数据库，可以在首次登录时使用 rest authenticator 自动创建 Tinode 账户。
Q: 如何让我的安装私有化？
A: 如果想限制只有您批准的人才能注册，最简单的方法是将 Tinode 注册限制到您控制的邮件域名：注册自定义域名，在域名注册商处设置 catch-all 邮件转发服务（通常免费）。然后在 Tinode 配置中使用您的域名（"acc_validation" -> "email" -> "domains"，例如 "domains": ["my-domain.com"]）。您会在 catch-all 邮箱收到注册邮件，然后可以手动转发验证码给您的用户。或者，如果用户很多，可以使用 rest authenticator。
Q: 如何创建 root 用户？
A: 从 Tinode 0.18 版本开始，可以通过运行以下命令授予用户 root 权限：
./tinode-db -auth=ROOT -uid=usrAbcDef123 -scheme=basic
从 0.21 版本开始，可以使用更简单的命令：
./tinode-db -make_root=usrAbcDef123
其中 usrAbcDef123 是要更新的用户 ID。
在 0.17 及更早版本中，只能通过执行数据库查询授予用户 root 权限。
首先创建或选择要提升为 root 的用户，然后执行查询：
- RethinkDB:
r.db('tinode').table('auth').get('basic:login-of-the-user-to-make-root').update({authLvl: 30})
- MySQL, PostgreSQL:
USE 'tinode';
UPDATE auth SET authlvl=30 WHERE uname='basic:login-of-the-user-to-make-root';
- MongoDB:
db.getCollection('auth').updateOne({_id: 'basic:login-of-the-user-to-make-root'}, {$set: {authlvl: 30}})
测试数据库有一个预设的 xena 用户具有 root 权限。
Q: 当网络连接数达到每节点约 1000 时，各种问题开始出现。这是 bug 吗？
A: 这很可能不是 bug。为确保服务器良好性能，Linux 在内核级别限制每个进程的打开文件描述符（活动网络连接、打开文件）总数。默认限制通常是 1024。文件描述符数量还有其他可能的限制。您遇到的问题很可能是因为超过了某个 Linux 限制。请寻求系统管理员的帮助。
Q: 群组话题和频道有什么区别？
A: 频道是群组话题的特例。普通群组话题允许有限数量的订阅者（默认 128）。每个订阅者可以单独管理：邀请、移除、封禁、提升为管理员或所有者，其他访问权限也可以单独调整。启用频道功能的群组话题额外允许无限数量的 读者。读者对话题有只读访问权限，不能单独管理，不能被邀请或移除，不能发布消息。读者加入或退出话题时不生成在线状态通知，也不接收普通群组成员的在线状态通知。读者接收的频道消息的 From 字段为 null，即他们不知道谁发布了频道中的任何特定消息。读者不能删除频道消息。
Q: 格式化 gRPC {pub content} 的正确方式是什么？
A: gRPC 将 {pub} 消息的 content 字段作为字节数组发送，而客户端应用期望它是有效的 JSON。因此，在传递给 gRPC 之前，必须将字段格式化为有效的 JSON。例如，要发送纯文本 Hello world 消息，必须发送带引号的字符串 "Hello world"。大多数情况下，传递给 gRPC 调用的字符串看起来像 "\"Hello world\"" 或 '"Hello world"'。
Q: 如何修复 PostgreSQL 初始化因 'missing database' 错误而失败的问题？
A: PostgreSQL 有一个（不当）特性：数据库连接必须始终选择一个数据库。如果连接尝试使用不存在的数据库（即使是为了创建它），连接会失败。当 Tinode 首次启动时，它尝试创建数据库，通常是 tinode（见 tinode.conf，"store_config": {"adapters": {"postgres": {"DBName": "tinode"}}}。数据库 tinode 显然不存在，所以 Tinode 连接回退到 'default' 数据库，该数据库与连接的 PostgreSQL 用户同名。默认配置指定用户为 postgres（"User": "postgres"），数据库 postgres 总是存在，所以连接成功，一切正常。但如果您将用户更改为 postgres 以外的任何值，比如 tinodeadmin，麻烦就开始了：名为 tinodeadmin 的数据库不存在，连接失败。如果要将用户名更改为 postgres 以外的任何值，必须创建数据库 tinode（或您为 Tinode 数据库命名的任何名称）或创建一个与您的用户 tinodeadmin 同名的空数据库。例如：
$ psql
postgres=# create database tinode;
exit