常见问题

登录报错 NOAUTH Authentication required

安装成功，登录时报错如下：

出现这个问题的原因是 Redis 服务器设置了密码认证，软件在连接 Redis 服务器时由于没有设置正确的认证密码导致报错。

IMPORTANT

请修改 config.yml 设置正确的 Redis 密码。

怎么配置 Nginx 代理

配置 nginx 代理需要开启 websocket 支持，配置示例如下：

location / {
    proxy_pass http://192.13.0.7:8000/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; # 客户端 ip
    proxy_set_header Host $host; # $host 为服务器域名
    client_max_body_size 100m; # 允许最大文件上传大小
}

请求内容大小超出限制

上传文件时，如果请求内容过大，会遇到如下报错：

服务器端默认限制了最大上传内容为 50M，可以通过修改配置文件 config.yml 中的 web.clientMaxBodySize 设置为更大值。

修改配置文件要重启服务才能生效。

IMPORTANT

如果 clientMaxBodySize 已经大于实际上传的文件大小，但仍收到“请求内容大小超出限制”这样的报错，则需要确认用户是否设置是代理（如 Nginx），因为代理本身也会限制上传内容的大小，Nginx 默认限制的是 1M，此时需要修改 Nginx 代理的配置。

保存文件太大，请检查文件内容

组态图保存时，如果图纸内容过大会收到以下报错：

常规图纸一般不会超过 2M，如果特殊情况确实无法将图纸大小控制在 2M 以内，可以通过修改 custom/topv/libs/topv_config.js 文件，通过设置 topvConfig.editor.config.jsonTooLargeThreshold 全局变量来修改默认的图纸大小限制:

window.topvConfig = {
  editor: {
    config: {
	  jsonTooLargeThreshold: 5 // 自定义 json 文件限制（M）,如果不设置默认是 2M
    }
  }
}