[{"id":"bcb0874d-299b-448e-9552-9e9b25ef80dd","tags":[{"product":null,"links":null,"id":"ba7e818e-4f6b-4211-b1ac-58e3bafcf439","name":"\u66F4\u65B0","color":"orange","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"8ce3627e-9e58-471b-9133-4f135d191e7b","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"ae60ae59-34f5-4f32-a8eb-243ed1457543","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"3d4848c3-910f-4ffa-9153-60bb507334a9","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"133f4ca6-d951-4d65-a618-3dc6301266f7","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"de62ec1c-813e-40b1-8160-a4cd109afe64","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"2426c71d-8332-4cbd-a436-1ec4f8666464","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"2ce7b6b0-78aa-4e4b-bf8a-e4ba2f988298","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"4706db46-0811-4652-8f59-1e0a1da84758","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"8f1271bb-2cd9-4f39-9897-c15b239ee7ab","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"677e13a7-6f3e-449f-986c-2c3a26f8d54f","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"5e40f6dc-caec-49d7-a1d0-be65f06815ba","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"2457f0e0-9e71-4860-a87d-065e0fb84f84","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"d5c67fd0-1145-482c-9113-97b492c44c18","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"a609a8fa-ab91-4c1d-a1c3-d209d0463303","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"b4a9eb15-94e5-48df-b218-a24138f0cf9c","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]}]
        
(Showing Draft Content)

节点部署相关常见问题排查

功能概述

本页列举了在节点部署时常见的问题以及解决方法,供您参考。如果这些内容无法解决您遇到的问题,请联系技术支持寻求进一步帮助。

常见问题

无法安装服务器

默认情况下,当您尝试安装 Server 时,它会立即弹出如下错误提示。

image2021-12-30_13-57-31.png

原因是未启用多服务器模式。

请按照远程部署Server 启用多服务器模式并远程安装服务器。

从节点安装后无法启动,没有logs文件夹

请检查是否安装了 ASP.NET Core Runtime 6.0

日志中发现连接被拒绝,部分功能无法正常工作

请检查防火墙是否打开或Wyn 架构及端口说明中列出的端口是否打开。

请检查Wyn.conf中的相关配置是否正确。

Redis无法连接

在多服务器模式下,由于Redis无法连接,Server可能无法启动。

您可以在 C:\Program Files\Wyn\logs\server\logxxx.txt (Windows 系统)或 /opt/Wyn/logs/server/logxxx.txt 中(Linux 系统)看到错误消息。

image2021-12-24_14-29-22.png

原因是Redis绑定IP是localhost或者127.0.0.1。

您可以按照以下步骤来解决它。

  1. 在 Redis.conf 中注释绑定或修改绑定到特定 IP 而不是 localhost 或 12.7.0.0.1。

  2. 重启Redis。

    type=info

    提示

    在Linux中,Redis配置位于/etc/redis。

    在Windows中,Redis配置位于Redis安装目录中。

Redis配置密码时无法成功连接Redis

对于 Redis 版本 < 6.0,请在连接字符串中添加名为“ Password ”的属性。该属性的值是密码。

Server=localhost:6379,Password=xxxx,Expire=0,Db=0,ThrowOnFailure=true,Timeout=3000

否则,请在连接字符串中添加名为“ Username ”的属性。该属性的值是用冒号分隔的用户名和密码。

Server=localhost:6379,Username=${username}:${password},Expire=0,Db=0,ThrowOnFailure=true,Timeout=3000

7.0 之后,除了Server、UserName、Password和Db之外,我们将不支持 NewLife 中的其他配置,但支持 StackExchange Redis 连接字符串中的所有部分。

这确保了从 6.1 升级的客户无需更改 Redis 配置字符串,多集群环境仍然可以工作。

type=warning

强烈建议用户使用新的 Gces.Redis 风格的连接字符串,并丢弃原来 NewLife 风格中的旧连接字符串。

同时,GcRedis 包也有自己的“ PoolSize ”的配置,用于配置 GcRedis 池。

配置连接串

默认

说明

abortConnect={bool}

true (false on Azure)

如果为 true,在没有可用服务器时不会创建连接。

allowAdmin={bool}

false

指定是否允许执行 Redis 的管理员命令。

如果设置为 true,客户端可以执行所有 Redis 命令,包括危险的命令。

channelPrefix={string}

null

所有发布/订阅操作的可选通道前缀。

checkCertificateRevocation={bool}

true

布尔值,指定在身份验证过程中是否检查证书注销列表。

connectRetry={int}

3

初始期间重复连接尝试的次数。

connectTimeout={int}

5000

连接操作超时(毫秒)。

configCheckSeconds={int}

60

检查配置的时间(秒)。

defaultDatabase={int}

null

默认数据库索引。

keepAlive={int}

-1

发送消息以保持套接字处于活动状态的时间(秒)(默认为 60 秒)。

name={string}

null

redis 内连接的标识。

user={string}

null

Redis 服务器的用户(与 Redis 6 及更高版本上的 ACL 一起使用)。

password={string}

null

Redis 用户的密码。

resolveDns={bool}

false

用于指定是否在连接 Redis 服务器时解析 DNS 主机名。

设置为 true,Gces.Redis 会在连接 Redis 服务器时自动解析 DNS 主机名,以获取 Redis 服务器的 IP 地址。

设置为 false,则 Gces.Redis 会直接使用 DNS 主机名来连接 Redis 服务器。

通常情况下,可以将 resolveDns 设置为 true,让 Gces.Redis 自动解析 DNS 主机名,以便灵活地处理 Redis 服务器 IP 地址变化的情况。

但是,在某些情况下,可能需要将 resolveDns 设置为 false,例如:

如果你已经知道 Redis 服务器的 IP 地址,并希望直接使用 IP 地址来连接 Redis 服务器。

如果你的 DNS 服务器不可靠或出现故障,可能会导致 DNS 解析失败,此时可以将 resolveDns 设置为 false,避免 DNS 解析失败而无法连接 Redis 服务器。

serviceName={string}

null

用于指定 Redis 哨兵服务器的服务名称。

当使用哨兵模式连接 Redis 服务器时,需要指定 Redis 哨兵服务器的服务名称,以便 Gces.Redis 可以正确地连接到 Sentinel 服务器,并获取 Redis 服务器的主从节点信息。

如果使用哨兵模式的集群,请确保serviceName 的值必须与哨兵服务器中的服务名称一致,否则连接将会失败。

ssl={bool}

false

指定使用 SSL 加密。

sslHost={string}

null

在服务器认证中强制执行特定的 SSL 主机身份。

sslProtocols={enum}

null

使用加密连接时支持的 Ssl/Tls 版本。使用“|” 提供多个值。

syncTimeout={int}

5000

允许同步操作的时间(毫秒)。

asyncTimeout={int}

SyncTimeout

允许异步操作的时间(毫秒)。

tiebreaker={string}

__Booksleeve_TieBreak

是 Redis 哨兵模式下的一个配置项,用于指定在主从切换的情况下,如何选择新的主服务器。

当 Redis 主服务器发生故障时,Redis 哨兵会自动将从服务器提升为新的主服务器,但是如果有多个从服务器同时请求成为主服务器,那么 Redis 哨兵需要选择一个从服务器作为新的主服务器,这时就需要使用 tiebreaker 配置项来指定选择规则。

如果使用redis哨兵集群,强烈推荐设置一个可靠的实例作为tiebreaker的值。

PoolSize

null || number (4<PoolSize<200)

是否使用Redis连接池并设置连接池大小。

请使用以下示例设置用户名和密码。

Server=localhost:6379,Username=${username},Password=${password},Expire=0,Db=0,ThrowOnFailure=true,Timeout=3000

Redis 集群连接字符串示例:

server=${redis0}:${port0},${redis1}:${port1};Username=${username},Password=${password} // NewLife style
${redis0}:${port0},${redis1}:${port1},user=${username},password=${password} // Gces.Redis style