Mars3D Studio 教程

外观

Windows系统下部署

1795字约6分钟

2024-10-15

部署准备工作

1.依赖环境

准备好服务器，可以复用已有中间件基础软件，没有也没关系，下面流程有安装步骤说明。

环境要求
操作系统Windows 10及以上x64位操作系统
运行环境jdk 17+
数据库mysql 5.7+ 或 PostgreSQL 16+
缓存redis 5+
web服务nginx 1.24+
地理信息服务geoserver 2.26+

2.下载部署文件

请单击 http://studio.mars3d.cn/offline.html 进行下载部署文件, 并拷贝文件到目标电脑的D:\目录中(我们已 D 盘为例，其他盘时下面教程中路径自行修改)；

压缩包文件名内部目录名内容
mars3d-studio-日期.zipmars3d-studio后端服务，启停脚本，数据库脚本文件
html-日期.ziphtmlWeb 前端网页包
deps-window.zipdeps基础环境软件参考配置，包括 nginx、mysql、jdk、redis 等

安装步骤说明

1.解压“mars3d-studio-日期.zip”

将mars3d-studio-日期.zip放在D:/下，右击压缩包解压至当前文件夹，解压后目录为D:/mars3d-studio/

image

2.解压“html-日期.zip” 和 “deps-window.zip”

将html-日期.zip和deps-window.zip放在D:/mars3d-studio/目录下，解压至当前文件夹，解压后目录为D:/mars3d-studio/html/和D:/mars3d-studio/deps/

image

如果您选用pgsql数据库，请参考使用pgsql部署额外操作后再继续后续流程

3.核对目录结构

调整后的目录结构为：

  • mars3d-studio
    • api# 后端服务文件
      • config
        • application.yml# 平台配置文件
        • application-prod.yml# 数据库等配置
        • logback.xml# 日志配置
      • lib
        • studio-biz-gap-2.0.jar
      • studio-admin.jar
    • bin
      • start.bat# 启动服务
      • stop.bat# 停止服务
      • env.bat# 设置环境变量
      • install.bat# 安装服务
      • uninstall.bat# 卸载服务
      • studio-api# api服务
        • …
      • studio-geoserver# geoserver服务
        • …
      • studio-web# web服务
        • …
    • data
      • init_data.sql# 数据库初始化脚本
      • studio-data# 数据上传目录
        • …
      • mars3d-data# 系统内置资源
        • …
    • html# 对应html-日期.zip，Web前端网页包
      • index.html
      • favicon.ico
    • deps# 对应deps-window.zip
      • nginx
        • …
      • jdk
        • …
      • mysql
        • …
      • redis
        • …
      • geoserver
        • …
    • logs# 相关日志
      • …

4.安装 MySQL 数据库

将D:/mars3d-studio/data/init_data.sql文件覆盖至D:/mars3d-studio/deps/mysql/init_data.sql

image

若在完全无网络环境下，需先点击安装 vcredist_x64.exe 应用程序

image

双击mysql_install.bat，未出现错误提示，等待安装完成即可！（如有权限问题，请右键使用管理员权限运行）

image

如果本地已有 Mysql 可以复用，使用D:/mars3d-studio/data/init_data.sql脚本创建好数据库即可。

5.安装 Redis 服务

双击D:/mars3d-studio/deps/redis/redis_install.bat, 等待安装完成即可！（如有权限问题，请右键使用管理员权限运行）

image

6.修改 Java 后端配置

记事本或编辑工具打开D:/mars3d-studio/api/config/application-prod.yml文件，根据实际部署目录或复用本地基础软件时按需修改配置。

application-prod.yml
#仅节选了关键配置
spring:
  datasource:
    dynamic:
      datasource:
        master:
          url: jdbc:mysql://127.0.0.1:3306/mars3d-studio-pro?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false&autoReconnect=true&allowPublicKeyRetrieval=true
          username: root
          password: F1-603
  redis:
    host: 127.0.0.1
    port: 6379
    database: 0
    password: 123456
app:
  demoEnabled: false
  uploadDir: D:/mars3d-studio/data/studio-data # 上传目录，根据实际情况进行调整 D:/mars3d-studio/data/studio-data
    # 集成geoserver
  geoserver:
    enable: true
    url: http://localhost:8080/geoserver
    username: admin
    password: geoserver

其中关键配置信息：

  • app.uploadDir 【重要】上传临时目录，需要核对实际安装路径修改
  • spring.datasource.dynamic.datasource MySQL 数据库链接
  • spring.redis Redis 链接
  • spring.file-storage 文件上传配置（支持本地/minio 等）

7.修改系统名称等信息

记事本或编辑工具打开D:/mars3d-studio/api/config/application.yml文件，根据实际需要修改信息。

application.yml
app:
  name: Mars3D Studio三维场景发布平台 #系统名称
  author: 合肥火星科技有限公司 #登录页面下侧版权信息
  website: http://www.marsgis.cn #登录页面下侧版权单击跳转链接
  devEnabled: true  #是否开启展示服务信息、下载配置等(针对技术人员使用的，是否二次开发)
  dataOpen: true  #默认是否公开
  approvalEnabled: true #是否启用审批

8.修改 Nginx 服务配置

代码编辑工具(请勿用记事本)打开D:\mars3d-studio\bin\studio-web\conf\host\m80.conf文件， 其中关键配置如下：

conf\host\m80.conf
 # 前端页面
 location / {
    root   D:/mars3d-studio/html; #【关键】根据实际安装路径进行调整
    index  index.html index.htm;
    try_files $uri $uri/ /index.html;
 }

 # 后端api
 location ^~/api/ {
    proxy_pass http://localhost:2800;
    proxy_http_version 1.1;
    proxy_set_header Host $http_host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 }

 # 后端geoserver
 location ^~/geoserver/ {
    proxy_pass http://localhost:8080;
    proxy_http_version 1.1;
    proxy_set_header Host $http_host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 }

9.一键安装服务

首先，双击D:/mars3d-studio/bin/env.bat, 等待设置完成再进行下一步！（如有权限问题，请右键使用管理员权限运行）

image

然后，双击D:/mars3d-studio/bin/install.bat, 等待安装完成即可！（如有权限问题，请右键使用管理员权限运行）

image

启动平台

1.启动服务

双击D:/mars3d-studio/bin/start.bat（如有权限问题，请右键使用管理员权限运行）, 等待几秒即可；

image

2.内置用户说明

登录名登录密码用途
root65883001超级管理员，进行系统管理操作
data65883001数据采集演示用户，默认演示数据是该用户录入的
guestguest内置游客用户，勿动勿删

3.访问系统

启动服务后，默认自动打开浏览器访问http://127.0.0.1，默认页面是公开资源的访问页面，目前系统已录入了一些演示数据。 image

单击【开始创作】进入后台登录页面，输入超级管理员 账号: root,密码：65883001进行登录（建议首次进入后修改密码，数据录入等操作建议用data帐号） image

平台授权

首次启动时免费试用一个月，会提示License试用验证通过；如需延长试用，或购买了授权，可以参考授权教程进行处理

停止平台

停止服务

双击D:/mars3d-studio/bin/stop.bat停止服务

更新平台

首先停止服务，停止后下载最新的离线包，没有特殊说明时，可以只用覆盖下面 2 个目录

  1. 更新后端服务目录：/mars3d-studio/api/

    将“mars3d-studio-日期.zip” 解压后，/api/目录中删除config子目录后，将api目录拷贝覆盖到/mars3d-studio/api/目录中；

  2. 更新前端页面目录：/mars3d-sudio/html/

    将“html-日期.zip”压缩包全部解压覆盖到/mars3d-sudio/html/目录。

更新完成后启动服务。

卸载平台

首先停止服务，再按下面步骤执行即可：

  1. 卸载MySQL数据库：双击D:/mars3d-studio/deps/mysql/mysql_unins.bat等待执行完成
  2. 卸载Redis：双击D:/mars3d-studio/deps/redis/redis_unins.bat等待执行完成
  3. 卸载服务：双击D:/mars3d-studio/bin/uninstall.bat等待执行完成
  4. 删除D:/mars3d-studio/目录

部署中常见问题

查看部署中常见问题

如有无法处理问题 或 需要购买Studio授权，可以微信扫一扫下面二维码进行沟通