常见问题 - 3D场景发布平台

Mars3D 10/15/2024

以下描述中的目录均是在部署机器的\mars3d-studio\下的相对路径。

# 前端Html访问问题

# 问题：离线部署版本，为什么还访问了线上studio.mars3d.cn的资源路径

回答：可以通过vscode工具打开/html/目录，批量替换https://studio.mars3d.cn为您私有部署的服务正式访问IP地址,比如http://192.168.0.196:2022,主要涉及/html/map-project/studio/resource.json和/html/map-project/studio/studio-plotlist.json文件

# 问题：访问后端服务地址有误

回答：修改/html/config/url.js，按注释说明按需调整。

# 后端配置相关问题

# 问题：复用mysql版本为`8.x`时，启动时候报错 `this is incompatible with sql mode=only full group by`

回答：需要检查my.ini配置[mysqld]节点下的sql_mode，添加或调整以下配置

sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION

# 问题：如何修改数据库及redis连接配置

回答：调整安装部署包中的配置文件api/config/application-prod.yml对应的spring.datasource.dynamic.datasource或spring.redis对应节点

# 问题：如何调整file-storage存储支持`兼容S3协议`的存储平台，如阿里OSS,七牛云等

回答：调整安装部署包中的配置文件api/config/application-prod.yml对应的file-storage对应节点，更多请详见文档 X Spring File Storage (opens new window)

# 上传文件相关

# 问题：提交文件或保存后，F12的network提示 `413 Request Entity Too Large`错误

回答：编辑工具修改服务器相关文件大小限制参数(勿用记事本)

修改开\deps\nginx\conf\host\m80.conf文件中client_max_body_size 200M;
修改\api\config\application.yml文件中max-file-size: 200MB max-request-size: 200MB

# 授权操作流程

# 问题：如何需提供程序生成的`clientCode`机器码并进行授权。

回答：在启动的Java后端控制台有打印，或者前端登录下面下侧的？按钮

（1）在线机器授权提供机器码给我们后，如果是互联网在线机器不用进行任何操作，我们授权后自动生效。

（2）离线机器授权

修改\api\config\application.yml文件中offline: false为offline: true
提供机器码给我们后，我们会发您License.txt授权文件，将文件拷贝到部署机器，并放到\api\config\目录里

Linux系统下部署

Mars3D开发教程

Choose mode